Volver al blog
Rangées de clés anciennes sur fond jaune, symbole des rangs et permissions gérés avec LuckPerms
Publicado el 19/10/2026

Tutorial de LuckPerms: configura rangos y permisos paso a paso

LuckPerms es el plugin de permisos de referencia en servidores de Minecraft con Spigot, Paper o Purpur, pero sus comandos suelen desconcertar al principio. Este tutorial te lleva desde la instalación hasta una jerarquía completa de Jugador, VIP, Moderador y Admin, con plantillas para copiar y pegar, el editor web y soluciones a los fallos más habituales.

Qué hace LuckPerms y qué no

LuckPerms decide quién puede hacer qué. Cada comando o función de un plugin está protegido por un permiso, una cadena como essentials.fly. Un permiso puede valer true (concedido), false (denegado de forma explícita) o no estar definido, lo que casi siempre equivale a una denegación.

Con cuatro conceptos lo entiendes todo:

  • Grupo: un conjunto de permisos que asignas a jugadores. Un rango es un grupo.
  • Herencia (parent): un grupo puede heredar de otro. Si «admin» hereda de «moderador», obtiene todos sus permisos.
  • Peso (weight): un número que ordena los grupos. Cuanto más alto, más prioridad.
  • Contexto: una condición, por ejemplo world=world_nether para un permiso que solo vale en el Nether.

El punto clave que muchas guías omiten: LuckPerms guarda los prefijos, pero no los muestra. Para ver «[Admin]» delante de un nombre en el chat necesitas también Vault y un plugin de formato de chat, como EssentialsX Chat. Lo vemos más abajo.

Instalar LuckPerms en Spigot, Paper o Purpur

En octubre de 2026, la versión actual es la 5.5.87 (serie 5.5), compatible con Minecraft desde 1.8.9 hasta 26.3 según los metadatos oficiales del proyecto.

  1. Descarga la versión Bukkit en la página de descargas oficial de LuckPerms. Es la que funciona en Spigot, Paper y Purpur.
  2. Arranca el servidor una vez para que exista la carpeta plugins y sube ahí el archivo .jar con el gestor de archivos de tu panel.
  3. Haz un reinicio completo (stop y volver a arrancar). Evita /reload, que a menudo deja los plugins en un estado inestable.

Por defecto, LuckPerms guarda sus datos en una base H2 (el archivo luckperms-h2-v2.mv.db, no lo borres). Si prefieres archivos legibles, cambia storage-method a yaml en plugins/LuckPerms/config.yml antes de crear tus rangos. Para una red de varios servidores, usa MySQL.

Paso 1: darte acceso completo

Justo después de instalarlo, nadie puede usar los comandos de LuckPerms, ni siquiera tú. Abre la consola del servidor (allí se escribe sin barra):

lp user TuNombre permission set luckperms.* true

El comodín * concede todos los permisos que empiezan por luckperms.. Después puedes seguir dentro del juego con /lp.

Paso 2: planificar la jerarquía de rangos

Antes de escribir un solo comando, define tu estructura. Esta es la que vamos a construir:

RangoGrupoPesoHereda dePrefijo
Jugadordefault0ninguno&7[Jugador]
VIPvip10default&6[VIP]
Moderadormoderador50vip&9[Mod]
Adminadmin100moderador&c[Admin]

El grupo default ya existe y todos los jugadores están en él automáticamente. La documentación oficial desaconseja sustituirlo por otro grupo; si no te gusta el nombre, cambia solo su nombre visible con /lp group default setdisplayname Jugador.

Paso 3: crear los grupos y la herencia

El comando creategroup acepta el peso como segundo argumento opcional:

/lp creategroup vip 10
/lp creategroup moderador 50
/lp creategroup admin 100

/lp group vip parent add default
/lp group moderador parent add vip
/lp group admin parent add moderador

La herencia es recursiva: el admin recibe los permisos del moderador, y por tanto los del VIP y del jugador. Nunca tendrás que repetir un permiso en varios grupos. En un grupo ya creado, el peso se ajusta con /lp group vip setweight 10.

Paso 4: plantillas de rangos listas para usar

Estas plantillas usan los permisos de EssentialsX, el plugin de utilidades más extendido. Adáptalas a tus propios plugins: su documentación siempre indica los permisos disponibles.

Jugador (grupo default)

/lp group default permission set essentials.spawn true
/lp group default permission set essentials.home true
/lp group default permission set essentials.sethome true
/lp group default permission set essentials.tpa true
/lp group default permission set essentials.tpaccept true
/lp group default permission set essentials.tpdeny true
/lp group default permission set essentials.msg true
/lp group default permission set essentials.balance true
/lp group default permission set essentials.pay true

VIP

El VIP obtiene ventajas de comodidad, nada que desequilibre la partida:

/lp group vip permission set essentials.hat true
/lp group vip permission set essentials.workbench true
/lp group vip permission set essentials.back true
/lp group vip permission set essentials.nick true
/lp group vip permission set essentials.sethome.multiple true
/lp group vip permission set essentials.sethome.multiple.vip true

Las dos últimas líneas permiten tener varias casas. El número exacto se define en la sección sethome-multiple del config.yml de EssentialsX (5 para «vip» en la configuración por defecto). Hacen falta los dos permisos.

Moderador

/lp group moderador permission set essentials.kick true
/lp group moderador permission set essentials.mute true
/lp group moderador permission set essentials.tempban true
/lp group moderador permission set essentials.tp true
/lp group moderador permission set essentials.invsee true
/lp group moderador permission set essentials.vanish true
/lp group moderador permission set essentials.socialspy true

El moderador puede banear de forma temporal, pero no permanente: una protección sencilla contra errores y abusos.

Admin

/lp group admin permission set essentials.* true
/lp group admin permission set minecraft.command.* true
/lp group admin permission set luckperms.* true

Reserva luckperms.* a personas de total confianza: con él, cualquiera puede darse cualquier permiso. Y nunca asignes el permiso global * a un rango de moderación.

Bloquear un permiso heredado

El valor false quita un permiso que un grupo hereda. Ejemplo: los VIP pueden volar en todas partes salvo en el Nether, gracias a un contexto:

/lp group vip permission set essentials.fly true
/lp group vip permission set essentials.fly false world=world_nether

Paso 5: prefijos y visualización en el chat

Añade un prefijo a cada grupo. La prioridad (el primer número) decide qué prefijo gana cuando un jugador hereda varios: se usa el más alto. Lo más claro es darle el mismo valor que el peso.

/lp group default meta setprefix 0 "&7[Jugador] "
/lp group vip meta setprefix 10 "&6[VIP] "
/lp group moderador meta setprefix 50 "&9[Mod] "
/lp group admin meta setprefix 100 "&c[Admin] "

Las comillas conservan el espacio final. setprefix sustituye el prefijo existente en el mismo contexto, mientras que addprefix añade otro más.

Para que los prefijos se vean de verdad, instala Vault y un plugin de chat compatible con Vault: EssentialsX Chat si ya usas EssentialsX, o VaultChatFormatter si quieres algo mínimo. Para la lista de jugadores (Tab) y los nombres sobre la cabeza necesitas un plugin específico como TAB.

Paso 6: asignar rangos a los jugadores

# Añadir un rango (se conservan los demás)
/lp user Steve parent add vip

# Sustituir todos los rangos por uno solo
/lp user Steve parent set moderador

# VIP durante 30 días, se retira solo después
/lp user Alex parent addtemp vip 30d

# Quitar un rango
/lp user Steve parent remove vip

Las duraciones se combinan: 1mo3d12h significa un mes, tres días y doce horas. Para comprobarlo, /lp user Steve info muestra los grupos, el grupo principal y el prefijo que reciben realmente los demás plugins.

Paso 7: un track para ascender a tu equipo

Un track es una escalera ordenada de grupos. Así no tienes que quitar y añadir grupos a mano en cada ascenso:

/lp createtrack equipo
/lp track equipo append moderador
/lp track equipo append admin

/lp user Steve promote equipo
/lp user Steve demote equipo

Si Steve todavía no está en ningún grupo del track, promote lo coloca en el primero (moderador). El siguiente ascenso lo convierte en admin y le quita el grupo moderador automáticamente.

El atajo: el editor web /lp editor

Si los comandos te resultan pesados, el editor web lo hace todo desde el navegador, con autocompletado de permisos:

  1. Escribe /lp editor (o /lp editor groups solo para los grupos, /lp group vip editor para un único grupo).
  2. Haz clic en el enlace que recibes en el chat o en la consola.
  3. Añade permisos en el campo «Add Permission»; puedes pegar varios a la vez. Haz clic en un valor para cambiarlo, o en «Add Contexts» para limitarlo a un mundo.
  4. Guarda con «Save» o Ctrl+S. El editor genera un comando /lp applyedits <código>: ejecútalo en el servidor para aplicar los cambios.

En el editor también puedes gestionar los rangos como nodos: group.vip para un grupo padre, weight.10 para el peso, prefix.10.&6[VIP] para un prefijo, displayname.Jugador para un nombre visible. Nunca compartas públicamente el enlace de una sesión: da acceso a tus datos de permisos.

Solución de problemas frecuentes

«No encuentro el permiso correcto»

Usa el modo verbose, el método más fiable. Lanza /lp verbose record Steve, pide a Steve que ejecute el comando problemático y luego escribe /lp verbose upload: obtendrás la lista exacta de permisos comprobados y su resultado.

El prefijo no aparece en el chat

Revisa primero /lp user Steve info. Si el prefijo aparece ahí, LuckPerms funciona y el problema está en la visualización: falta Vault, o el plugin de chat falta o está mal configurado. El comando /vault-info debe indicar que los datos de chat vienen de LuckPerms.

Un jugador tiene un permiso que no debería

Casi siempre es un operador (/op): los OP reciben automáticamente todos los permisos que un plugin reserva por defecto a los operadores. Quítaselo con /deop y gestiona todo con LuckPerms. Si no, localiza el origen con /lp user Steve permission check essentials.fly.

Mis cambios no se aplican

Si algo se modificó fuera del servidor (archivos YAML editados a mano, base de datos compartida), recarga los datos con /lp sync.

Pruébalo todo en un servidor gratuito

LuckPerms apenas consume recursos. Puedes montar y probar toda tu estructura de rangos en un servidor de Minecraft gratuito de MineServerGratis con Paper, Spigot o Purpur antes de abrirlo a tu comunidad.

Preguntas frecuentes

¿LuckPerms es gratuito?

Sí, LuckPerms es gratuito y de código abierto en todas las plataformas compatibles.

¿Necesito Vault para usar LuckPerms?

Para los permisos en sí, no. Sí en cuanto otro plugin (chat, economía, lista Tab) tenga que leer grupos o prefijos a través de Vault.

¿Cómo cambio el nombre del grupo default?

No se renombra: dale un nombre visible con /lp group default setdisplayname Jugador, o haz que herede de un grupo «miembro» con /lp group default parent add miembro.

¿Qué diferencia hay entre parent add y parent set?

parent add añade un grupo y conserva los demás; parent set quita todos los grupos existentes y deja solo el nuevo.

¿Puedo dar un rango durante un tiempo limitado?

Sí, con /lp user Nombre parent addtemp vip 30d. El rango desaparece solo al vencer.