Guía de LuckPerms: grupos, rangos y comandos

Instala LuckPerms y date acceso

1. Descarga la versión correcta desde luckperms.net: Bukkit para Paper y Spigot, o la versión de Fabric, NeoForge o Velocity para esas plataformas. Necesita Java 11 o superior, algo que tiene cualquier servidor actual.
2. Coloca el jar en plugins (o en mods en Fabric y NeoForge), elimina cualquier otro plugin de permisos y reinicia el servidor por completo.
3. Date acceso desde la consola. Al principio nadie puede usar los comandos de LuckPerms, ni siquiera tú:

lp user YourName permission set luckperms.* true

A partir de ahí puedes usar /lp dentro del juego. En el primer arranque LuckPerms descarga algunas librerías, así que el servidor necesita acceso a internet.

Grupos, herencia, peso y tracks

• Los nodos de permiso son las claves, como essentials.home o minecraft.command.gamemode. Cada uno puede ser true, false o no estar definido.
• Los grupos contienen permisos. Todos los jugadores están en default; el resto los añades tú.
• Herencia: un grupo puede tener grupos padre y recibe todo lo que estos tienen. Si admin hereda de mod, y mod hereda de default, los administradores tienen los tres.
• El peso decide qué grupo gana cuando dos no coinciden: gana el número más alto. Usar saltos de 100 deja espacio para los grupos que añadas más adelante.
• Los tracks son escaleras de ascenso, como default → helper → mod → admin, que se usan con promote y demote. Por sí solos no cambian la herencia.
• Los contextos limitan un permiso a un servidor o mundo, por ejemplo con world=survival al final de un comando.

Una configuración lista de jugador, moderador y administrador

Crea los grupos, encadénalos y da a cada uno los permisos que necesita. Los nombres de nodos de abajo son de comandos de EssentialsX; sustitúyelos por los nodos de los plugins que uses.

lp creategroup mod
lp creategroup admin
lp group mod parent add default
lp group admin parent add mod
lp group mod setweight 100
lp group admin setweight 200

lp group default permission set essentials.home true
lp group default permission set essentials.sethome true
lp group default permission set essentials.spawn true
lp group default permission set essentials.tpa true
lp group default permission set essentials.tpaccept true
lp group default permission set essentials.msg true

lp group mod permission set essentials.kick true
lp group mod permission set essentials.mute true
lp group mod permission set essentials.tempban true

lp group admin permission set essentials.* true
lp group admin permission set luckperms.* true

lp user Steve parent add mod

Después, un track para los ascensos:

lp createtrack staff
lp track staff append default
lp track staff append mod
lp track staff append admin

lp user Steve promote staff sube a Steve un escalón. La lista completa de comandos y nodos de EssentialsX está en la guía de EssentialsX.

Prefijos y rangos en el chat

Define un prefijo para un grupo:

lp group admin meta setprefix "&c[Admin] "

LuckPerms guarda el prefijo, pero es un plugin de chat el que tiene que mostrarlo. Instala Vault y un plugin de chat que lea de él, como EssentialsX Chat. Si un jugador tiene varios grupos, se usa el prefijo con mayor prioridad; defínela con meta setprefix 100 "...".

El editor web de LuckPerms

Para cambios grandes, el editor es más cómodo que los comandos. Ejecuta /lp editor, abre el enlace que aparece y edita grupos, usuarios y tracks en tu navegador. Al guardar, el editor muestra un comando: ejecútalo en el juego o en la consola y los cambios se aplican. Nada cambia en el servidor hasta que ejecutes ese comando.

Comandos de LuckPerms que usarás

¿No sabes qué nodo necesita un comando? Ejecuta /lp verbose record, usa el comando como el jugador y luego /lp verbose upload: el informe muestra todos los permisos que se comprobaron.

LuckPerms en un servidor o una red de HytHost

• Instálalo subiendo el jar a plugins desde el gestor de archivos o por SFTP y reinicia desde el panel. Ejecuta el primer comando lp user ... luckperms.* en la pestaña Console.
• Un solo servidor: el almacenamiento H2 por defecto es suficiente.
• Una red: instala LuckPerms en el proxy y en cada backend, y apunta todos a la misma base de datos MySQL con storage-method: mysql en config.yml. Todos los planes de Minecraft de HytHost incluyen bases de datos MySQL; la configuración del propio proxy se explica en cómo configurar un proxy Velocity.