Volver al blog

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.

EssentialsX : Guía completa de instalación y configuración

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:

⚠️ 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...):

  1. Instala Vault : Descargar Vault
  2. Colócalo en /plugins/
  3. Reinicia el servidor
  4. 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:

  1. El plugin no se ha cargado correctamente
  2. 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:

  1. Instala Vault
  2. 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


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:

  1. Instalar LuckPerms para permisos avanzados
  2. Configurar EssentialsX Chat para un chat profesional
  3. Crear kits adaptados a tu estilo de juego
  4. Personalizar los mensajes (MOTD, reglas)