EssentialsX : Guía completa de instalación y configuración
Aprende a instalar y configurar EssentialsX en tu servidor Minecraft. Guía completa: comandos, economía, kits, permisos y configuración avanzada.
Introducción
EssentialsX es el plugin más popular y completo para servidores de Minecraft. Fork moderno del legendario Essentials, ofrece más de 130 comandos y características esenciales para cualquier administrador de servidor.
¿Por qué elegir EssentialsX?
- +130 comandos — Teleportación, economía, kits, warps, homes...
- Gratis y de código abierto — Mantenido activamente por la comunidad
- Modular — Instala solo lo que necesitas
- Compatible — Funciona con Spigot, Paper, Purpur (1.8 a 1.21+)
- Personalizable — Configuración detallada de cada funcionalidad
- Traducido — Soporte multilingüe incluyendo el español
Instalación
Requisitos previos
| Elemento | Versión Mínima |
|---|---|
| Minecraft | 1.8.8+ (recomendado 1.20+) |
| Servidor | Spigot, Paper, Purpur |
| Java | 17+ (para MC 1.20+) |
| Vault | Recomendado para la economía |
Paso 1: Descarga
Descarga EssentialsX solo desde fuentes oficiales:
- Sitio oficial : essentialsx.net
- Modrinth : modrinth.com/plugin/essentialsx
- Hangar : hangar.papermc.io/EssentialsX/Essentials
⚠️ Atención : ¡Nunca descargues desde sitios no oficiales. Riesgo de malware!
Paso 2: Instalación
1. Detén tu servidor
2. Coloca EssentialsX-X.X.X.jar en la carpeta /plugins/
3. (Opcional) Agrega los módulos deseados
4. Inicia el servidor
5. EssentialsX genera automáticamente sus archivos de configuración
Paso 3: Verificación
/plugins
EssentialsX debe aparecer en verde. También puedes probar:
/essentials
Módulos EssentialsX
EssentialsX es modular. Instala solo lo que necesitas:
Módulos Disponibles
| Módulo | Descripción | ¿Indispensable? |
|---|---|---|
| EssentialsX | Plugin principal (comandos básicos) | ✅ Sí |
| EssentialsX Chat | Formato del chat, prefijos, colores | ✅ Recomendado |
| EssentialsX Spawn | Gestión del spawn, respawn, spawn de novatos | ✅ Recomendado |
| EssentialsX AntiBuild | Restricciones de construcción por permiso | Opcional |
| EssentialsX Discord | Vinculación Discord ↔ Minecraft | Opcional |
| EssentialsX GeoIP | Localización geográfica de los jugadores | Opcional |
| EssentialsX Protect | Protección básica del mundo | Opcional |
| EssentialsX XMPP | Soporte Jabber/XMPP | Raro |
Instalación Recomendad (Servidor Supervivencia)
plugins/
├── EssentialsX-2.XX.X.jar # Principal
├── EssentialsXChat-2.XX.X.jar # Chat
├── EssentialsXSpawn-2.XX.X.jar # Spawn
└── Vault-X.X.X.jar # Economía (dependencia)
Dependencias Opcionales
| Plugin | Utilidad con EssentialsX |
|---|---|
| Vault | Conexión con la economía y los permisos |
| LuckPerms | Gestión avanzada de permisos |
| PlaceholderAPI | Variables en el chat y los mensajes |
Configuración Básica
Después del primer inicio, EssentialsX genera sus archivos en /plugins/Essentials/.
Estructura de los Archivos
plugins/Essentials/
├── config.yml # Configuración principal
├── messages.properties # Mensajes personalizables
├── items.json # Alias de los items
├── kits.yml # Configuración de los kits
├── spawn.yml # Coordenadas del spawn
├── warps/ # Archivos de los warps
└── userdata/ # Datos de los jugadores
Configuración Esencial (config.yml)
Abre config.yml y modifica estos parámetros clave:
Idioma del Plugin
# Cambia el idioma (es para español)
locale: es
Nombre y Apodo
# Permitir apodos coloreados
change-displayname: true
Formato del nombre (con apodo)
nickname-prefix: '~'
Longitud máxima del apodo
max-nick-length: 15
Permitir colores en los apodos
nick-color: true
Mensajes de Conexión/Desconexión
# Desactivar los mensajes por defecto (si usas otro plugin)
custom-join-message: "none"
custom-quit-message: "none"
O personalizar
custom-join-message: "&8[&a+&8] &7{DISPLAYNAME}"
custom-quit-message: "&8[&c-&8] &7{DISPLAYNAME}"
Teleportación
# Tiempo antes de la teleportación (en segundos)
teleport-delay: 3
Cancelar si el jugador se mueve
teleport-cancel-on-move: true
Cooldown entre teleportaciones
teleport-cooldown: 30
Teleportación gratuita para el OP
teleport-cost: 0
Comandos Esenciales
Comandos Jugadores
| Comando | Descripción | Permiso |
|---|---|---|
/spawn |
Regresar al spawn | essentials.spawn |
/home |
Ir a su casa | essentials.home |
/sethome [nombre] |
Definir una casa | essentials.sethome |
/delhome [nombre] |
Eliminar una casa | essentials.delhome |
/tpa <jugador> |
Solicitar una teleportación | essentials.tpa |
/tpaccept |
Aceptar una solicitud | essentials.tpaccept |
/tpdeny |
Rechazar una solicitud | essentials.tpdeny |
/back |
Regresar a su posición anterior | essentials.back |
/warp <nombre> |
Ir a un warp | essentials.warp |
/warps |
Lista de warps | essentials.warp.list |
/bal |
Ver su saldo | essentials.balance |
/pay <jugador> <cantidad> |
Enviar dinero | essentials.pay |
/kit <nombre> |
Recibir un kit | essentials.kit |
/kits |
Lista de kits | essentials.kit.list |
/msg <jugador> <mensaje> |
Mensaje privado | essentials.msg |
/r <mensaje> |
Responder al último MP | essentials.msg |
/afk |
Poner AFK | essentials.afk |
/nick <nombre> |
Cambiar su apodo | essentials.nick |
/seen <jugador> |
Última conexión de un jugador | essentials.seen |
/mail send <jugador> <msg> |
Enviar un correo | essentials.mail.send |
/mail read |
Leer sus correos | essentials.mail |
/helpop <mensaje> |
Solicitar ayuda al staff | essentials.helpop |
Comandos Moderación
| Comando | Descripción | Permiso |
|---|---|---|
/tp <jugador> |
Teletransportarse a un jugador | essentials.tp |
/tphere <jugador> |
Teletransportar a un jugador hacia uno mismo | essentials.tphere |
/tppos <x> <y> <z> |
Teleportación a las coordenadas | essentials.tppos |
/tpall |
Teletransportar a todos hacia uno mismo | essentials.tpall |
/kick <jugador> [razón] |
Expulsar a un jugador | essentials.kick |
/ban <jugador> [razón] |
Banear a un jugador | essentials.ban |
/tempban <jugador> <duración> |
Banear temporalmente | essentials.tempban |
/unban <jugador> |
Desbanear a un jugador | essentials.unban |
/mute <jugador> [duración] |
Silenciar | essentials.mute |
/unmute <jugador> |
Dejar hablar | essentials.unmute |
/jail <jugador> <cárcel> |
Encerrar | essentials.jail |
/unjail <jugador> |
Liberar | essentials.unjail |
/vanish |
Volverse invisible | essentials.vanish |
/invsee <jugador> |
Ver el inventario | essentials.invsee |
/socialspy |
Espiar los MP | essentials.socialspy |
/broadcast <mensaje> |
Mensaje global | essentials.broadcast |
Comandos Administración
| Comando | Descripción | Permiso |
|---|---|---|
/setspawn |
Definir el spawn | essentials.setspawn |
/setwarp <nombre> |
Crear un warp | essentials.setwarp |
/delwarp <nombre> |
Eliminar un warp | essentials.delwarp |
/createkit <nombre> <tiempo> |
Crear un kit desde el inventario | essentials.createkit |
/eco give <jugador> <cantidad> |
Dar dinero | essentials.eco.give |
/eco take <jugador> <cantidad> |
Retirar dinero | essentials.eco.take |
/eco set <jugador> <cantidad> |
Definir el saldo | essentials.eco.set |
/god [jugador] |
Modo invencible | essentials.god |
/fly [jugador] |
Modo vuelo | essentials.fly |
/speed <1-10> |
Velocidad de movimiento | essentials.speed |
/heal [jugador] |
Curar | essentials.heal |
/feed [jugador] |
Alimentar | essentials.feed |
/gamemode <modo> |
Cambiar el modo de juego | essentials.gamemode |
/time <día/noche> |
Cambiar la hora | essentials.time |
/weather <sol/lluvia> |
Cambiar el clima | essentials.weather |
/essentials reload |
Recargar la configuración | essentials.reload |
Sistema de Economía
EssentialsX incluye un sistema de economía completo.
Configuración de la Economía
En config.yml:
# Símbolo de la moneda
currency-symbol: '€'
Nombre de la moneda (singular/plural)
currency-singular: 'euro'
currency-plural: 'euros'
Dinero inicial
starting-balance: 1000
Saldo máximo (0 = ilimitado)
max-money: 10000000000000
Saldo mínimo (puede ser negativo para permitir deudas)
min-money: -10000
Formato de visualización
economy-log-enabled: false
Comandos Economía
# Jugadores
/bal # Ver su saldo
/baltop # Clasificación de los más ricos
/pay <jugador> <cantidad> # Enviar dinero
Administración
/eco give <jugador> 1000 # Dar 1000€
/eco take <jugador> 500 # Retirar 500€
/eco set <jugador> 5000 # Definir el saldo a 5000€
/eco reset <jugador> # Restablecer al saldo inicial
Integración con Vault
Para conectar la economía a otros plugins (tiendas, trabajos...):
- Instala Vault : Descargar Vault
- Colócalo en
/plugins/ - Reinicia el servidor
- La economía de EssentialsX se detecta automáticamente
Kits y Warps
Crear un Kit
Método 1: A través del juego (Recomendado)
# Coloca los items deseados en tu inventario
# Luego crea el kit con el tiempo en segundos
/createkit starter 86400
Método 2: Archivo kits.yml
kits:
starter:
delay: 86400 # 24 horas en segundos
items:
- stone_sword 1
- leather_helmet 1
- leather_chestplate 1
- leather_leggings 1
- leather_boots 1
- cooked_beef 16
- torch 32
vip:
delay: 43200 # 12 horas
items:
- diamond_sword 1 sharpness:2
- diamond_pickaxe 1 efficiency:3
- golden_apple 5
- ender_pearl 8
weekly:
delay: 604800 # 7 días
items:
- diamond 16
- emerald 32
- netherite_ingot 2
Encantamientos en los Kits
Formato: item cantidad encantamiento:nivel
items:
- diamond_sword 1 sharpness:5 unbreaking:3 fire_aspect:2
- diamond_pickaxe 1 efficiency:5 fortune:3 unbreaking:3
- elytra 1 unbreaking:3 mending:1
Permisos de los Kits
# Permiso para usar el kit "starter"
essentials.kit.starter
Permiso para usar todos los kits
essentials.kit.*
Crear Warps
# Colocarse en el lugar deseado
/setwarp shop # Crea el warp "shop"
/setwarp arena # Crea el warp "arena"
/setwarp spawn # Crea el warp "spawn"
Eliminar un warp
/delwarp shop
Listar los warps
/warps
Permisos de los Warps
# Acceso a un warp específico
essentials.warps.shop
Acceso a todos los warps
essentials.warps.*
Homes y Teleportación
Configuración de los Homes
En config.yml:
# Número de homes por defecto
default-home-limit: 1
Homes por grupo (con LuckPerms)
Definir a través de los permisos: essentials.sethome.multiple.<número>
Permisos Multi-Homes
| Permiso | Efecto |
|---|---|
essentials.sethome.multiple.2 |
2 homes |
essentials.sethome.multiple.5 |
5 homes |
essentials.sethome.multiple.unlimited |
Homes ilimitados |
Ejemplo con LuckPerms
# Jugadores normales: 2 homes
/lp group default permission set essentials.sethome.multiple.2
VIP: 5 homes
/lp group vip permission set essentials.sethome.multiple.5
Staff: ilimitado
/lp group staff permission set essentials.sethome.multiple.unlimited
Configuración Teleportación
# Tiempo antes de la teleportación (en segundos)
teleport-delay: 3
Desactivar el tiempo de espera para ciertos grupos a través de permiso
essentials.teleport.timer.bypass
Cooldown entre los /tpa
teleport-cooldown: 60
Duración de validez de una solicitud TPA
tpa-accept-cancellation: 120
Teleportación hacia jugadores AFK
teleport-to-afk: true
Permisos
Estructura de los Permisos EssentialsX
essentials.<comando> # Permiso básico
essentials.<comando>.others # Usar en otros jugadores
essentials.<comando>.<argumento> # Argumentos específicos
Permisos Recomendados por Grupo
Grupo: default (Jugadores)
permissions:
- essentials.spawn
- essentials.home
- essentials.sethome
- essentials.delhome
- essentials.tpa
- essentials.tpaccept
- essentials.tpdeny
- essentials.back
- essentials.back.ondeath
- essentials.warp
- essentials.warp.list
- essentials.balance
- essentials.balance.others
- essentials.pay
- essentials.kit
- essentials.kit.starter
- essentials.msg
- essentials.mail
- essentials.mail.send
- essentials.afk
- essentials.seen
- essentials.list
- essentials.motd
- essentials.rules
- essentials.helpop
- essentials.sethome.multiple.2
Grupo: VIP
permissions:
- essentials.nick
- essentials.nick.color
- essentials.back.ondeath
- essentials.kit.vip
- essentials.sethome.multiple.5
- essentials.tpa.cooldown.bypass
- essentials.teleport.timer.bypass
Grupo: Moderador
permissions:
- essentials.tp
- essentials.tphere
- essentials.tppos
- essentials.kick
- essentials.kick.notify
- essentials.mute
- essentials.mute.notify
- essentials.tempban
- essentials.tempban.notify
- essentials.jail
- essentials.vanish
- essentials.vanish.see
- essentials.invsee
- essentials.socialspy
- essentials.helpop.receive
- essentials.fly
- essentials.god
Grupo: Admin
permissions:
- essentials.*
# O selectivamente:
- essentials.ban
- essentials.unban
- essentials.setspawn
- essentials.setwarp
- essentials.delwarp
- essentials.createkit
- essentials.eco
- essentials.eco.give
- essentials.eco.take
- essentials.eco.set
- essentials.gamemode
- essentials.time
- essentials.weather
- essentials.broadcast
- essentials.essentials
Configuración con LuckPerms (Ejemplo Completo)
# Crear los grupos
/lp creategroup vip
/lp creategroup mod
/lp creategroup admin
Jerarquía
/lp group vip parent add default
/lp group mod parent add vip
/lp group admin parent add mod
Permisos Jugador
/lp group default permission set essentials.spawn
/lp group default permission set essentials.home
/lp group default permission set essentials.sethome
/lp group default permission set essentials.tpa
/lp group default permission set essentials.warp
/lp group default permission set essentials.balance
/lp group default permission set essentials.kit.starter
Permisos VIP
/lp group vip permission set essentials.fly
/lp group vip permission set essentials.nick
/lp group vip permission set essentials.kit.vip
Permisos Mod
/lp group mod permission set essentials.kick
/lp group mod permission set essentials.mute
/lp group mod permission set essentials.vanish
/lp group mod permission set essentials.tp
Permisos Admin
/lp group admin permission set essentials.*
Configuración Avanzada
EssentialsX Chat
Instala EssentialsXChat para personalizar el chat.
Configuración en config.yml:
# Activar el formato del chat
chat:
# Formato global del chat
format: '{DISPLAYNAME}&7: &f{MESSAGE}'
Formato por grupo (requiere Vault + LuckPerms)
group-formats:
default: '&7[Jugador] {DISPLAYNAME}&7: &f{MESSAGE}'
vip: '&6[VIP] {DISPLAYNAME}&7: &f{MESSAGE}'
mod: '&9[Mod] {DISPLAYNAME}&7: &f{MESSAGE}'
admin: '&c[Admin] {DISPLAYNAME}&7: &f{MESSAGE}'
Variables de Chat Disponibles
| Variable | Descripción |
|---|---|
{DISPLAYNAME} |
Nombre o apodo del jugador |
{USERNAME} |
Nombre real |
{MESSAGE} |
Mensaje enviado |
{GROUP} |
Grupo del jugador |
{PREFIX} |
Prefijo LuckPerms |
{SUFFIX} |
Sufijo LuckPerms |
{WORLD} |
Mundo actual |
{WORLDNAME} |
Nombre del mundo |
EssentialsX Spawn
Configuración del spawn en config.yml:
# Teletransportar al spawn al conectarse
spawn-on-join: true
Solo para nuevos jugadores
spawn-on-join: newbies
Spawn por grupo
spawn-on-join-groups:
- default
Respawn en el spawn (en lugar de la cama)
respawn-at-spawn: true
Spawn por mundo
respawn-at-spawn-by-world: false
Configuración en spawn.yml:
spawns:
default:
world: world
x: 0.5
y: 100.0
z: 0.5
yaw: 0.0
pitch: 0.0
Mensajes Personalizados (MOTD, Reglas)
Mensaje del Día (MOTD)
Crea/modifica motd.txt:
&6╔════════════════════════════════════╗
&6║ &e¡Bienvenido a &bMiServidor&e! &6║
&6║ &6║
&6║ &7• Sitio: &fwww.miservidor.fr &6║
&6║ &7• Discord: &fdiscord.gg/miservidor &6║
&6║ &7• Tienda: &f/shop &6║
&6║ &6║
&6║ &a¡Buena aventura! &6║
&6╚════════════════════════════════════╝
Reglas
Crea/modifica rules.txt:
&6&l▬▬▬ REGLAS DEL SERVIDOR ▬▬▬
&e1. &fRespetar a todos los jugadores
&e2. &fNo hacer trampa o hackear
&e3. &fNo hacer grief o robar
&e4. &fNo hacer publicidad o spam
&e5. &fUsar el sentido común
&7Incumplir estas reglas = Baneo permanente
Códigos de Color
| Código | Color | Código | Color |
|---|---|---|---|
&0 |
Negro | &8 |
Gris oscuro |
&1 |
Azul oscuro | &9 |
Azul |
&2 |
Verde oscuro | &a |
Verde claro |
&3 |
Cian oscuro | &b |
Cian |
&4 |
Rojo oscuro | &c |
Rojo |
&5 |
Púrpura | &d |
Rosa |
&6 |
Oro | &e |
Amarillo |
&7 |
Gris | &f |
Blanco |
| Código | Formato |
|---|---|
&l |
Negrita |
&o |
Itálica |
&n |
Subrayado |
&m |
~~Tachado~~ |
&r |
Restablecer |
Solución de Problemas
Problemas Frecuentes
"Comando desconocido" después de la instalación
Causas posibles:
- El plugin no se ha cargado correctamente
- Conflicto con otro plugin
Soluciones:
# Verificar que el plugin esté cargado
/plugins
Si está en rojo, verificar los logs
/logs/latest.log
Reiniciar correctamente
/stop
La economía no funciona con otros plugins
Solución:
- Instala Vault
- Verifica que Vault detecte EssentialsX:
/vault-info economy
Los permisos no funcionan
Verificaciones:
# Probar un permiso
/essentials:perm <jugador> essentials.fly
Con LuckPerms, verificar
/lp user <jugador> permission check essentials.fly
Los homes/warps no se guardan
Causas:
- Problema de permisos de archivos
- Apagado abrupto del servidor
Soluciones:
# Guardar manualmente
/essentials save
Verificar los permisos de la carpeta
chmod -R 755 plugins/Essentials/
Mensajes de error en la consola
Error: "Datos del jugador no encontrados"
- Normal para nuevos jugadores
- Los datos se crean en la primera conexión
Error: "No se pudo cargar la configuración"
- Error de sintaxis YAML
- Usa un validador YAML en línea
- Verifica los espacios (¡sin tabulaciones!)
Comandos de Diagnóstico
# Versión de EssentialsX
/essentials version
Recargar la configuración
/essentials reload
Depurar a un jugador
/essentials debug
Información economía
/essentials eco
Restablecimiento Completo
Si todo está roto:
1. Detén el servidor
2. Haz una copia de seguridad de la carpeta plugins/Essentials/
3. Elimina plugins/Essentials/
4. Reinicia el servidor (regenera las configuraciones por defecto)
5. Reconfigura progresivamente
Comandos Rápidos - Ayuda-Memoria
Configuración Inicial
# 1. Definir el spawn
/setspawn
2. Crear los warps importantes
/setwarp shop
/setwarp arena
/setwarp mine
3. Crear el kit de inicio
(con items en el inventario)
/createkit starter 86400
4. Probar
/kit starter
/warp shop
/spawn
Gestión Rápida de Jugadores
# Teleportación
/tp <jugador> # Ir hacia
/tphere <jugador> # Traer hacia uno mismo
Moderación
/kick <jugador> razón
/tempban <jugador> 1h razón
/mute <jugador> 10m
Economía
/eco give <jugador> 1000
Recursos Útiles
- Documentación oficial : essentialsx.net/wiki
- GitHub : github.com/EssentialsX/Essentials
- Soporte Discord : discord.gg/essentialsx
- SpigotMC : spigotmc.org/resources/essentialsx
Conclusión
EssentialsX es la base de todo buen servidor de Minecraft. Con esta guía, tienes todas las claves para:
- Instalar y configurar el plugin correctamente
- Gestionar la economía, los kits y los warps
- Configurar los permisos por grupo
- Personalizar el chat y los mensajes
- Resolver problemas comunes
Próximos pasos recomendados:
- Instalar LuckPerms para permisos avanzados
- Configurar EssentialsX Chat para un chat profesional
- Crear kits adaptados a tu estilo de juego
- Personalizar los mensajes (MOTD, reglas)