Cómo configurar LuckPerms: permisos, grupos y herencias

Qué resuelve LuckPerms

Controla quién puede hacer qué en tu servidor. Sin LuckPerms, todos los jugadores tienen los mismos permisos. Con él, puedes crear rangos (default, vip, mod, admin) y asignar comandos específicos a cada uno.

Requisitos

• Paper o Spigot 1.18+
• Java 17+
• SQLite (incluido) o MySQL/PostgreSQL para producción

Instalación

1. Descarga LuckPerms desde
2. Copia el .jar en plugins/
3. Reinicia el servidor
4. Abre la consola y ejecuta /lp editor — se abre una URL en tu navegador

Primeros pasos en el editor web

El editor es la forma más fácil de gestionar LuckPerms. Desde él puedes:

• Crear grupos con el botón "Create Group"
• Asignar permisos arrastrando o escribiendo
• Ver la jerarquía de grupos visualmente
• Exportar la configuración como JSON o YAML

Crear tu primera jerarquía

Un servidor típico necesita 3-4 grupos. Ejecuta estos comandos desde la consola:

# Crear grupos
/lp group default create
/lp group vip create
/lp group mod create
/lp group admin create

# Establecer herencias (vip hereda de default, etc.)
/lp group vip parent set default
/lp group mod parent set vip
/lp group admin parent set mod

Ahora "admin" tiene todos los permisos de mod, vip y default. Si asignas un permiso a "default", todos lo heredan.

Asignar permisos reales

Ejemplo de permisos para cada rango:

# Default — comandos básicos
/lp group default permission set essentials.tpa true
/lp group default permission set essentials.sethome true
/lp group default permission set essentials.home true
/lp group default permission set essentials.warp true

# VIP — extras de conveniencia
/lp group vip permission set essentials.fly true
/lp group vip permission set essentials.flyspeed true
/lp group vip permission set essentials.kit true

# Mod — moderación
/lp group mod permission set essentials.ban true
/lp group mod permission set essentials.kick true
/lp group mod permission set essentials.mute true
/lp group mod permission set worldedit.selectionwand true

# Admin — todo
/lp group admin permission set * true

Asignar un jugador a un grupo

# Desde consola
/lp user Steve parent set vip

# Desde chat (si tienes permiso)
/lp user <jugador> parent set <grupo>

Backend de almacenamiento

Por defecto, LuckPerms usa SQLite (un archivo en la carpeta del plugin). Para servidores con muchos usuarios o multi-servidor:

• SQLite — bien para 1-50 jugadores, sin configuración
• MySQL — recomendado para 50+ jugadores. Configura en plugins/LuckPerms/config.yml
• PostgreSQL — alternativa a MySQL, mismo rendimiento

Errores comunes

Backup antes de cambios

Antes de modificar permisos en producción:

cp -r plugins/LuckPerms/plugins/LuckPerms.bak

O usa /lp export luckperms-backup.json para exportar todo el estado actual.

Siguiente paso

Una vez que LuckPerms funciona, necesitas conectarlo con un plugin de economy como Vault para que los permisos controlen también el acceso a comandos de dinero.