LuckPerms es el plugin de permisos estándar para servidores con la API de Bukkit/Spigot/Paper. Sustituye los simples comandos op por un sistema de rangos: creas rangos (VIP, MOD, ADMIN), se los asignas a los jugadores y defines qué puede hacer cada grupo.
LuckPerms funciona con motores de plugins: Paper, Spigot, CraftBukkit, Purpur, Folia, Leaves, Pufferfish. No funciona en Vanilla, Forge ni Fabric; consulta Motor y versión del servidor.
#Instalación
- Descarga la última versión de
LuckPerms.jardesde la web del proyecto (luckperms.net). - Detén el servidor (Detener).
- En la pestaña Archivos, entra en la carpeta
pluginsy sube el archivo (Subir). - Inicia el servidor: al arrancar, el plugin generará la carpeta con su configuración.
#Primeros comandos
En la pestaña Consola o en el juego (con permisos de administrador):
lp creategroup vip
lp creategroup mod
lp creategroup admin
lp user Steve parent add vip
lp user Anna parent set mod
lp user Tom parent add admincreategroup- crea un rango,parent add/parent set- añade o asigna el rango principal a un jugador,lp user Steve info- muestra los rangos asignados.
#Asignar permisos
Un permiso es, por ejemplo, essentials.fly (el comando /fly de EssentialsX) o minecraft.command.give. Introduce en el juego:
lp group vip permission set essentials.fly true
lp group admin permission set * true
lp group mod meta set prefix "[MOD] "permission set- activa o desactiva un permiso para el grupo,meta set prefix- prefijo de color delante del nick del jugador.
Construye una jerarquía: default → vip → mod → admin. El rango superior hereda todo lo de los inferiores, así que en ADMIN no tienes que repetir los permisos de VIP.
#Permisos que conviene configurar al principio
| Grupo | Qué configurar |
|---|---|
default (cada jugador) |
protección frente a la expulsión, límite de /msg, online oculto |
vip |
nick en color, essentials.fly (opcional), prioridad de entrada |
mod |
kick, ban, temp-ban, repair, enderchest |
admin |
* (todo), minecraft.command.* |
admin con * incluye también los comandos que destruyen el mundo (setblock, fill). Si no quieres que un moderador tenga fill, desactívalo explícitamente en el grupo mod: lp group mod permission set minecraft.command.fill false.
#Archivos y copia de seguridad
Los datos de LuckPerms están en plugins/LuckPerms/ (data/, yml/). La copia de seguridad del servidor los incluye automáticamente: los rangos no desaparecerán al restablecer los archivos.
#Problemas más habituales
#El comando no funciona, aunque he asignado el rango
El jugador tiene una sesión caducada: los comandos de permisos se cargan al entrar. Pídele que salga y vuelva a entrar al servidor, o reinicia.
#lp no hace nada en el juego
No tienes permisos para ejecutar los comandos del plugin. Primero asígnate un rango desde la consola (lp user TwojNick parent set admin) y luego gestiona desde el juego.
#Los rangos han desaparecido tras reinstalar
La reinstalación borra la carpeta plugins. Restaura una copia de seguridad o sube por SFTP el archivo plugins/LuckPerms/data/*.yml de tu copia.
#Siguientes pasos
- Instalar plugins
- Whitelist, OP y baneos - lo que sigue funcionando en Minecraft sin plugins
- EssentialsX - los comandos cuyos permisos gestionas aquí