LuckPerms es el plugin de permisos con el que decides, en un servidor Paper o Spigot, quién puede usar cada comando. Sin un plugin de permisos solo hay dos niveles: el operador, que lo puede todo, y los jugadores normales, que no pueden casi nada. LuckPerms añade grupos entre ambos: invitados, constructores, moderación. Cada grupo tiene nodos de permisos, y los jugadores heredan los nodos de sus grupos.

Esta guía te lleva desde la instalación hasta tu primer grupo de moderación. Los comandos proceden de la documentación oficial de LuckPerms, y las capturas de pantalla, de un servidor de pruebas con Paper 1.21.4 y LuckPerms 5.5.71.

Instalación desde el panel

En el panel del servidor encontrarás LuckPerms en Plugins → Browser. La búsqueda obtiene los datos de Modrinth, y el loader y la versión del servidor se comprueban con los metadatos del plugin antes de que el archivo llegue a la carpeta plugins/. Si quieres el paquete completo, el asistente de protección del mundo de la página de plugins instala LuckPerms junto con WorldGuard y WorldEdit en un solo paso. Tras el reinicio, al entrar al servidor el plugin muestra su versión y su autor.

Chat después de entrar: LuckPerms 5.5.71 está cargado, con el sitio web y el autor (Enlarge image)

Este mensaje aparece cuando escribes /luckperms o, en forma abreviada, /lp sin argumentos. Es la forma más rápida de comprobar si el plugin funciona de verdad.

Cómo se estructuran los permisos en LuckPerms

Un nodo de permiso es una cadena de texto como essentials.home o worldedit.region.set. Cada plugin incluye sus propios nodos y los documenta. Un nodo puede estar en true o en false. El asterisco worldedit.* abarca todos los nodos de un plugin: es práctico para la moderación, pero peligroso para los jugadores normales.

LuckPerms tiene tres niveles:

  • Los grupos agrupan nodos. Todos los jugadores reciben automáticamente el grupo default.
  • Los jugadores heredan de sus grupos y además pueden tener nodos propios.
  • Los contextos limitan los nodos, por ejemplo, a un mundo o a un modo de juego.

Mantén una estructura sencilla. Para la mayoría de los servidores bastan de dos a cuatro grupos.

Crear el primer grupo

Los siguientes comandos se ejecutan en la consola del servidor o como operador dentro del juego:

/lp creategroup mod
/lp group mod permission set worldedit.* true
/lp group mod permission set essentials.kick true
/lp user NombreDelJugador parent add mod

La primera línea crea el grupo. Las dos líneas con permission set le dan acceso completo a WorldEdit y al comando de expulsión de EssentialsX. La última línea añade a un jugador al grupo. Puedes comprobar el resultado con /lp user Spielername permission check essentials.kick.

Con el grupo default conviene hacer lo contrario: quitar los comandos que los jugadores no necesitan. Sin el permiso bukkit.command.plugins, Paper deja de mostrar el comando /plugins, y el jugador solo ve un mensaje de error sobre un comando desconocido.

Sin el permiso bukkit.command.plugins, el servidor indica que el comando es desconocido (Enlarge image)
/lp group default permission set bukkit.command.plugins false

No es una medida de seguridad en sentido estricto, pero mantiene la lista de plugins lejos de los invitados curiosos.

El editor web

Para cambios más grandes, la consola resulta engorrosa. /lp editor genera un enlace al editor web en luckperms.net. Allí verás todos los grupos y jugadores en una tabla, podrás asignar nodos con el ratón y, al terminar, enviar la sesión de vuelta al servidor con un clic. El enlace es válido durante pocos minutos y solo se puede usar con el código generado. Las sesiones contienen nombres de jugadores y UUID, así que no compartas el enlace.

Errores habituales

  • Un permiso no surte efecto. El jugador sigue siendo operador. Los operadores se saltan LuckPerms. Quítale el op y trabaja solo con grupos.
  • Nodo mal escrito. LuckPerms acepta cualquier texto, incluidas las erratas. Comprueba el nodo en la documentación del plugin correspondiente.
  • Asteriscos en default. Un nodo * en el grupo predeterminado le da todo a cualquier invitado. Usa asteriscos solo en grupos de moderación.
  • Los cambios desaparecen tras reiniciar. De forma predeterminada, LuckPerms guarda los datos en un archivo H2 dentro de la carpeta del plugin. Si no se puede escribir en la carpeta durante el reinicio, los cambios se pierden. Echa un vistazo a la consola durante el arranque para ver el error.

Ubicación de los datos y copia de seguridad

Todos los datos se encuentran en plugins/LuckPerms/. La copia de seguridad del panel también incluye esta carpeta. Para redes con varios servidores, LuckPerms ofrece una base de datos MySQL compartida; para un único servidor, H2 sigue siendo la opción más sencilla.

Guías relacionadas

Cómo instalar y actualizar plugins en general se explica en Instalar y gestionar plugins. La protección del mundo mediante regiones se explica en WorldGuard: proteger regiones, y las herramientas de construcción, en WorldEdit: construir y deshacer cambios.

Fuentes

LuckPerms: ver ejemplo

Grabaciones propias realizadas en un entorno de demostración. La versión y la configuración mostradas pueden diferir de las de tu servidor.

LuckPerms: Sin el permiso, el comando probado para listar plugins no está disponible.
Sin el permiso, el comando probado para listar plugins no está disponible.

LuckPerms 5.5.71 · 2026-09-12

LuckPerms: Tras cambiar los permisos, el mismo comando muestra la lista de plugins.
Tras cambiar los permisos, el mismo comando muestra la lista de plugins.

LuckPerms 5.5.71 · 2026-09-12