EasyLuckPerms

(🇪🇸 La versión en Español de esta descripción se encuentra más abajo)

---

🌟 EasyLuckPerms

EasyLuckPerms is a lightweight, modern companion plugin created to make managing LuckPerms 10x faster, cleaner, and more intuitive for server owners and staff.

No more memorizing long commands or struggling with broken prefix colors. Manage ranks, prefixes, suffixes, and permissions effortlessly with instant visual feedback!

⚠️ Disclaimer: EasyLuckPerms is an independent companion plugin created by Ale_256. It is not an official LuckPerms project and is not affiliated with or endorsed by Lucko.

---

✨ Key Features

• ⚡ Streamlined Commands: Manage ranks and groups with simple, memorable syntax (/rank set, /rank create, /prefix, /perm).
• 🎨 Full RGB & Hex Color Support: Works natively with hex codes (&#RRGGBB / <#RRGGBB>) and legacy Minecraft codes (&a, &l, etc.).
• 🧠 Smart Prefix & Suffix Formatting: Automatically appends spaces and color resets (&r) to prevent color bleeding into player names and chat.
• ⏱️ 0.2s Feedback Delay: Executes the underlying LuckPerms command and cleanly delivers an elegant confirmation message 0.2 seconds later.
• 🧙 Interactive First-Join Setup: When an administrator joins for the first time, interactive chat buttons allow choosing between English and Spanish with a single click.
• 🌐 Multi-Language (i18n): Ships with English (en) and Spanish (es) out of the box. Fully customizable in languages/.
• 🔍 Real-Time Group Autocomplete: Tab completion dynamically fetches existing LuckPerms ranks directly from the API.

---

📜 Commands

👑 Rank Management (/rank, /rk)

Command	Description
/rank set <player> <rank>	Sets the player's primary rank
/rank add <player> <rank>	Adds a secondary rank to the player
/rank remove <player> <rank>	Removes a rank from the player
/rank create <name> [prefix]	Creates a new rank (with optional formatted prefix)
/rank delete <rank>	Deletes an existing rank
/rank list	Lists all available ranks
/rank info <rank>	Displays detailed information about a rank

🏷️ Prefixes (/prefix, /eprefix)

Command	Description
/prefix player <player> <prefix>	Sets a custom prefix for a player
/prefix rank <rank> <prefix>	Sets a prefix for an entire rank
/prefix clear player <player>	Clears a player's prefix
/prefix clear rank <rank>	Clears a rank's prefix

🏷️ Suffixes (/suffix, /esuffix)

Command	Description
/suffix player <player> <suffix>	Sets a custom suffix for a player
/suffix rank <rank> <suffix>	Sets a suffix for an entire rank
/suffix clear player <player>	Clears a player's suffix
/suffix clear rank <rank>	Clears a rank's suffix

🔑 Permissions (/permission, /perm)

Command	Description
/perm player <player> add <permission>	Grants a permission to a player
/perm player <player> remove <permission>	Removes a permission from a player
/perm rank <rank> add <permission>	Grants a permission to a rank
/perm rank <rank> remove <permission>	Removes a permission from a rank

⚙️ Administrative (/easylp, /easyluckperms)

Command	Description
/easylp reload	Reloads config.yml and all language files
`/easylp setlang <en	es>`
/easylp info	Shows plugin version and author
/easylp help	Shows the help menu

---

🔒 Permissions

• easyluckperms.* - Full access to all plugin features (Default: OP)
• easyluckperms.rank - Access to /rank commands
• easyluckperms.prefix - Access to /prefix commands
• easyluckperms.suffix - Access to /suffix commands
• easyluckperms.permission - Access to /perm commands
• easyluckperms.admin - Access to /easylp reload and /easylp setlang
• easyluckperms.setup - Allows receiving the interactive setup wizard on join

---

🇪🇸 Versión en Español

---

🌟 EasyLuckPerms

EasyLuckPerms es un complemento ligero y moderno creado para que administrar LuckPerms sea 10 veces más rápido, limpio e intuitivo tanto para administradores como para el equipo de moderación.

Olvídate de memorizar comandos largos o lidiar con prefijos que rompen el color del chat. ¡Gestiona rangos, prefijos, sufijos y permisos al instante con mensajes elegantes!

⚠️ Aviso: EasyLuckPerms es un complemento independiente desarrollado por Ale_256. No es un proyecto oficial de LuckPerms ni está afiliado con Lucko.

---

✨ Características Principales

• ⚡ Comandos Simplificados: Gestiona rangos y grupos con comandos cortos e intuitivos (/rank set, /rank create, /prefix, /perm).
• 🎨 Soporte Completo RGB y Hex: Compatible con colores hexadecimales (&#RRGGBB / <#RRGGBB>) y códigos tradicionales de Minecraft (&a, &l, etc.).
• 🧠 Formateo Inteligente de Prefijos y Sufijos: Añade automáticamente el espacio final y el reseteo de color (&r) para evitar que el color del prefijo se desborde al nombre o al chat.
• ⏱️ Confirmación tras 0.2s: Ejecuta el comando de LuckPerms internamente y muestra un mensaje limpio de confirmación 0.2 segundos después.
• 🧙 Asistente Interactivo de Primer Inicio: Al instalar el plugin, cuando entra un administrador se muestra un mensaje interactivo en el chat con botones clicables para elegir el idioma ([ English ] o [ Español ]).
• 🌐 Multilenguaje (i18n): Viene listo con Español (es) e Inglés (en). Totalmente personalizable desde la carpeta languages/.
• 🔍 Autocompletado de Rangos en Tiempo Real: Sugiere automáticamente los grupos reales existentes en tu servidor al pulsar Tab.

---

📜 Comandos

👑 Gestión de Rangos (/rank, /rk)

Comando	Descripción
/rank set <jugador> <rango>	Establece el rango principal de un jugador
/rank add <jugador> <rango>	Añade un rango secundario al jugador
/rank remove <jugador> <rango>	Quita un rango del jugador
/rank create <nombre> [prefijo]	Crea un nuevo rango (con prefijo formateado opcional)
/rank delete <rango>	Elimina un rango existente
/rank list	Muestra la lista de rangos disponibles
/rank info <rango>	Muestra información detallada de un rango

🏷️ Prefijos (/prefix, /eprefix)

Comando	Descripción
/prefix player <jugador> <prefijo>	Establece un prefijo personalizado para un jugador
/prefix rank <rango> <prefijo>	Establece el prefijo para todo un rango
/prefix clear player <jugador>	Elimina el prefijo del jugador
/prefix clear rank <rango>	Elimina el prefijo del rango

🏷️ Sufijos (/suffix, /esuffix)

Comando	Descripción
/suffix player <jugador> <sufijo>	Establece un sufijo personalizado para un jugador
/suffix rank <rango> <sufijo>	Establece el sufijo para todo un rango
/suffix clear player <jugador>	Elimina el sufijo del jugador
/suffix clear rank <rango>	Elimina el sufijo del rango

🔑 Permisos Rápidos (/permission, /perm)

Comando	Descripción
/perm player <jugador> add <permiso>	Otorga un permiso a un jugador
/perm player <jugador> remove <permiso>	Quita un permiso a un jugador
/perm rank <rango> add <permiso>	Otorga un permiso a un rango
/perm rank <rango> remove <permiso>	Quita un permiso a un rango

⚙️ Comandos Administrativos (/easylp, /easyluckperms)

Comando	Descripción
/easylp reload	Recarga config.yml y todos los archivos de idioma
`/easylp setlang <en	es>`
/easylp info	Muestra la versión y autor del plugin
/easylp help	Muestra el menú de ayuda

---

🔒 Permisos

• easyluckperms.* - Acceso total a todas las funciones (Por defecto: OP)
• easyluckperms.rank - Acceso a los comandos de /rank
• easyluckperms.prefix - Acceso a los comandos de /prefix
• easyluckperms.suffix - Acceso a los comandos de /suffix
• easyluckperms.permission - Acceso a los comandos de /perm
• easyluckperms.admin - Acceso a /easylp reload y /easylp setlang
• easyluckperms.setup - Permite recibir el asistente de configuración al entrar