Cómo configurar rangos de PermissionsEx en un server de Minecraft

Resumen de PermissionsEx

Muchos servers de Minecraft usan rangos para separar jugadores regulares, staff, donadores, moderadores y administradores. Esos rangos solo son útiles cuando cada uno tiene los permisos correctos asignados. PermissionsEx, a menudo abreviado como PEX, es un plugin que te permite crear grupos, asignar comandos, establecer herencia y controlar lo que cada jugador puede hacer.

Puedes administrar PEX con comandos dentro del juego o desde la consola, o editando directamente su archivo `permissions.yml`. Los comandos suelen ser más fáciles para una primera configuración, mientras que editar el archivo te da más control una vez que entiendes el formato. YAML es quisquilloso, así que un espacio mal puesto puede arruinar una tarde que iba bastante tranquila.

Para que los prefijos o sufijos de chat aparezcan junto a los nombres de los jugadores, también necesitas Vault y un plugin de chat compatible, como EssentialsXChat.

Instalación de PermissionsEx

1. Abre la página de releases de PEX 1.0 en GitHub y descarga el archivo `.jar` de la release que quieras usar.

1. Abre tu panel de server de HolyHosting y detén el server de Minecraft.
2. Revisa que el server esté usando un tipo de software compatible con plugin, como Paper o Spigot.
3. Abre el acceso a archivos del server y luego ve a la carpeta `plugins`.
4. Sube el archivo `.jar` de PEX descargado a esa carpeta.

1. Regresa a la página principal del server e inicia el server de nuevo.

Después del reinicio, ejecuta `/plugins` dentro del juego o `plugins` desde la consola. Si PermissionsEx aparece en la lista de plugin, la instalación funcionó y puedes empezar a crear grupos.

Crear tu primer grupo con comandos

Los primeros comandos deben ejecutarse desde la consola del server para que no necesites permisos antes de que existan los permisos. Al usar comandos de consola, quita el `/` del inicio. Por ejemplo, `/pex` se convierte en `pex`.

Para crear un grupo de administrador:

1. Ejecuta `pex group Admin create` para crear el grupo.
2. Ejecuta `pex group Admin add permissions.*` para darle a ese grupo todos los nodos de permiso.
3. Ejecuta `pex user YourPlayerName group set Admin` para colocarte en el grupo.

Ejemplo:

`pex user Steve group set Admin`

Una vez asignado, entra al server y prueba un comando de admin. Si funciona, el grupo está activo.

Personalización de grupos

Los grupos de PEX se pueden ajustar con rangos, prefijos y nodos de permiso específicos. Un número de rango más bajo significa mayor importancia, así que un grupo de owner o admin suele usar un valor muy bajo.

Ejemplos útiles:

• `pex group Admin set rank 1` hace que Admin sea uno de los grupos de mayor prioridad.
• `pex group Moderator set rank 100` le da a Moderator menor prioridad que Admin.
• `pex group Admin prefix "&0(&4Admin&0)&7 "` agrega un prefijo de Admin en el chat, si Vault y un plugin de chat están instalados.
• `pex group Mod add essentials.fly` le da al grupo Mod acceso al comando fly de EssentialsX.

Puedes repetir el mismo patrón para grupos como Member, VIP, Helper, Moderator, Admin y Owner. Mantén los nombres de grupo simples para que sean fáciles de escribir al asignar jugadores.

Editar el archivo de permisos

Algunos owners de servers prefieren editar el archivo de config porque muestra la estructura completa en un solo lugar. Esto es útil para configuraciones más grandes, pero perdona menos errores que los comandos.

Antes de editar, detén el server y conserva una copia backup del archivo actual. Un backup de texto plano es suficiente. Tu yo del futuro quizá lo agradezca.

Encontrar el archivo

1. Detén el server desde el panel de HolyHosting.
2. Abre el acceso a archivos del server.
3. Ve a `plugins` y luego abre la carpeta `PermissionsEx`.
4. Edita `permissions.yml`.

Entender el formato

Un archivo nuevo normalmente contiene solo el grupo predeterminado. Para crear un nuevo grupo manualmente, copia la estructura del grupo predeterminado y cambia los valores.

Un grupo Admin normalmente incluye estas partes:

• `Admin:` es el nombre del grupo. Puedes renombrarlo a cualquier cosa clara y consistente.
• `permissions:` lista los nodos de permiso que recibe el grupo.
• `permissions.*` da acceso a todos los permisos, y solo debe usarse para administradores de confianza.
• `rank:` controla la prioridad del grupo. Los números más bajos tienen mayor prioridad.
• `prefix:` controla la etiqueta de chat que se muestra antes del nombre del jugador cuando Vault y un plugin de chat están presentes.

Después de agregar el grupo, agrega tu nombre de usuario o UUID debajo de la sección users y configura el grupo como Admin. Asegúrate de que la indentación coincida con el resto del archivo, luego guarda y reinicia el server.

Qué agregar después

Después de que el primer rango de admin funcione, arma el resto de tu estructura de permisos. Un server simple podría usar:

• `Member` para jugadores regulares.
• `VIP` para seguidores o acceso especial.
• `Mod` para comandos de moderación.
• `Admin` para acceso completo de administración.

Agrega solo los permisos que cada rango realmente necesita. Darle `permissions.*` a todos los grupos es rápido, pero también convierte errores básicos en problemas para todo el server.

Para una cobertura más profunda de comandos, revisa la documentación oficial de PermissionsEx o la wiki de la versión del plugin que estás usando.

Problemas comunes

Los comandos del plugin no funcionan

Confirma que el server esté ejecutando Paper, Spigot u otro tipo de server compatible con plugin. También revisa que el archivo `.jar` de PEX esté dentro de la carpeta `plugins`, no en la raíz del server ni en otro directorio. Reinicia después de subir el archivo.

Los permisos no se aplican después de editar el archivo

Esto suele ser un problema de formato YAML. Revisa la indentación, los espacios y la anidación de grupos. Un validador de YAML puede ayudar a encontrar errores antes de pegar el archivo corregido de vuelta en el editor del panel. Después de guardar, reinicia el server.

Los prefijos no aparecen en el chat

PEX no muestra prefijos de chat por sí solo. Instala Vault y un plugin de chat como EssentialsXChat, luego reinicia el server. Si el prefijo todavía no aparece, confirma que el grupo tenga un valor `prefix` válido y que el jugador realmente esté asignado a ese grupo.

Referencias útiles

• EssentialsX
• Vault
• PermissionsEx wiki

Notas finales

PermissionsEx es una forma práctica de crear un sistema de rangos para un server de Minecraft. Una vez que el primer grupo esté funcionando, el resto es principalmente repetición cuidadosa: crea un grupo, agrega los permisos que necesita, asigna jugadores y luego prueba. Mantén backups antes de editar `permissions.yml`, revisa la indentación y evita entregar permisos wildcard a menos que el jugador realmente necesite control total.