🔐 LuckPerms — Guía Completa

📅 2 de Marzo, 2026 • ⏱️ 15 min lectura • 🏷️ Permissions, LuckPerms, Admin

LuckPerms es el sistema de permisos más potente y flexible para servidores de Minecraft. Reemplaza a PermissionsEx, GroupManager y bPermissions. Esta guía cubre desde la instalación hasta conceptos avanzados como herencia de grupos, prefijos con Chat Formatting y contextos.

📥 Instalación

Descarga LuckPerms desde luckperms.net/download — selecciona Bukkit para servidores Paper/Spigot
Copia el .jar en la carpeta /plugins/
Reinicia el servidor
LuckPerms crea su base de datos H2 local por defecto. Para producción con MySQL: edita /plugins/LuckPerms/config.yml

  Al arrancar verás en consola: [LuckPerms] Loading LuckPerms v5.x.x y [LuckPerms] Successfully loaded. Si no aparece, verifica que el .jar esté en /plugins y que no haya errores de Java.

� Paso 2: Conceptos Fundamentales

LuckPerms se organiza en grupos y permisos. Los jugadores son asignados a grupos, y los grupos tienen permisos. Los grupos pueden heredar permisos de otros grupos.

Grupo: coleción de permisos. Ejemplos: default, vip, moderador, admin
Permiso: un nodo que activa o niega una función. Ej: essentials.fly
Herencia: un grupo puede heredar permisos de otro. admin hereda de moderador
Peso (weight): determina qué grupo tiene prioridad si un jugador está en varios

🔧 Paso 3: Configurar Grupos Básicos

Setup típico para un servidor survival:

# 1. Crear grupo VIP
/lp creategroup vip

# 2. Dar permisos básicos al grupo default (todos los jugadores)
/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.warp true

# 3. Dar permisos adicionales a VIP
/lp group vip permission set essentials.fly true
/lp group vip permission set essentials.kit.vip true
/lp group vip setweight 10

# 4. Crear grupo Moderador con herencia de VIP
/lp creategroup moderador
/lp group moderador parent add vip
/lp group moderador permission set essentials.kick true
/lp group moderador permission set essentials.mute true
/lp group moderador permission set worldguard.region.bypass.* true
/lp group moderador setweight 50

# 5. Crear grupo Admin con herencia de Moderador
/lp creategroup admin
/lp group admin parent add moderador
/lp group admin permission set * true  # todos los permisos
/lp group admin setweight 100

🏷️ Paso 4: Prefijos y Colores de Chat

LuckPerms puede añadir prefijos y sufijos a los grupos que aparecen en el chat. Necesitas EssentialsXChat o Vault + un plugin de chat compatible:

# Prefijo para VIP (verde)
/lp group vip meta setprefix "&a[VIP] &f"

# Prefijo para Moderador (azul)
/lp group moderador meta setprefix "&9[MOD] &f"

# Prefijo para Admin (rojo)
/lp group admin meta setprefix "&c[ADMIN] &f"

# Sufijo (va después del nombre)
/lp group vip meta setsuffix " &7(VIP)"

Los códigos de color son los de Minecraft: &a=verde, &c=rojo, &9=azul, &e=amarillo, &f=blanco, etc.

👤 Paso 5: Asignar Jugadores a Grupos

# Añadir jugador al grupo VIP
/lp user OliveerF group add vip

# Añadir con tiempo limitado (30 días)
/lp user OliveerF group add vip 30d

# Ver configuración completa de un jugador
/lp user OliveerF info

# Quitar de un grupo
/lp user OliveerF group remove vip

# Ver todos los permisos efectivos del jugador
/lp user OliveerF permission info

🌐 Paso 6: Editor Web Visual (Recomendado)

LuckPerms tiene un editor web que permite gestionar grupos y permisos visualmente sin memorizar comandos:

Ejecuta /lp editor en consola o como admin en el chat
Se genera un link único — ábrelo en el navegador
Crea grupos, asigna permisos arrastrando y soltando, configura prefijos
Haz clic en "Save changes" — se genera un código
Ejecuta /lp applyedits [código] para aplicar los cambios

🗄️ Paso 7: Configurar MySQL (Para Producción)

Por defecto LuckPerms usa H2 (base de datos local). Para servidores en producción o con múltiples servidores (BungeeCord), usa MySQL:

# /plugins/LuckPerms/config.yml
storage-method: mysql

data:
  address: localhost:3306
  database: luckperms
  username: mc_user
  password: tu_password
  
  # Pool de conexiones
  pool-settings:
    maximum-pool-size: 10
    minimum-idle: 10
    maximum-lifetime: 1800000
    connection-timeout: 5000

⚠️ Troubleshooting Frecuente

❌ Los prefijos no aparecen en el chat

Causa: Necesitas un plugin de chat que lea los metadatos de LuckPerms. Instala EssentialsXChat o configura tu plugin de chat para usar {displayname} o {prefix} del PlaceholderAPI.

❌ "You do not have permission" cuando tengo `*`

Causa: Algunos plugins tienen sus permisos en negativo explícito. Verifica con /lp user tuNombre permission info si hay permisos en false que sobreescriban el *. También asegúrate de que paper.yml no tiene disable-permissions-manager: true.

❌ Los cambios no se guardan al reiniciar

Causa: Error al guardar en la base de datos o configuración incorrecta. Revisa los logs al arrancar — busca errores de LuckPerms. Si usas H2, verifica que la carpeta /plugins/LuckPerms/ tiene permisos de escritura.

🔖 Comandos Rápidos de Referencia

/lp creategroup <nombre>                          — crear grupo
/lp deletegroup <nombre>                          — eliminar grupo
/lp listgroups                                    — listar grupos
/lp group <g> permission set <perm> true          — dar permiso
/lp group <g> permission set <perm> false         — negar permiso
/lp group <g> permission unset <perm>             — quitar permiso
/lp group <g> parent add <otroGrupo>              — herencia
/lp group <g> meta setprefix "&a[TAG] "           — prefijo
/lp group <g> setweight <número>                 — prioridad
/lp user <jugador> group add <grupo>              — asignar al grupo
/lp user <jugador> group add <grupo> <tiempo>    — temporal (30d, 1mo)
/lp user <jugador> info                           — ver config
/lp editor                                        — abrir editor web
/lp sync                                          — sincronizar BD
/lp verbose on <filtro>                           — debug de permisos

🚀 Servidor con LuckPerms preconfigurado

OliveerF Hosting entrega servidores con LuckPerms configurado con grupos básicos listos (default, vip, admin).

🎮 Ver planes → 🔌 Instalar Plugins