Sincronización de roles

La sincronización de roles conecta roles de Discord con rangos de tu servidor de Minecraft. Cuando alguien recibe un rol en Discord, el servidor ejecuta un comando. Cuando alguien tiene un rango de LuckPerms en el juego, el bot le da el rol de Discord correspondiente. Las dos direcciones solo funcionan con jugadores que han vinculado sus cuentas.

Configurar

De Discord al juego

1. Crea una regla para el rol:

2. Permite los comandos en la configuración del servidor de Minecraft. Con el valor por defecto whitelist, el servidor los rechaza.

# Spigot, Paper, Folia: plugins/mc-sync/config.yml
commands:
  mode: allow
  allow: ["lp user * parent add", "lp user * parent remove"]

# Fabric, Quilt, Forge, NeoForge: config/mc-sync.properties
commands.mode=allow
commands.allow=lp user * parent add,lp user * parent remove

3. Ejecuta /mcsync reload. En Forge con Minecraft anterior a 1.19, reinicia el servidor.
4. Da el rol a un miembro vinculado. El comando se ejecuta en todos los servidores de Minecraft conectados a este servidor de Discord.

Encontrarás más sobre commands.mode en Comandos desde Discord.

Del juego a Discord

LuckPerms tiene que estar instalado en el servidor de Minecraft. Esta dirección solo está disponible en el panel.

1. En el panel, abre «Sincronización de roles» y ve a «Rangos de Minecraft».
2. Elige el rango en «Rango en el juego» y el rol en «Rol de Discord».
3. Haz clic en «Añadir».
4. Si hay varios servidores de Minecraft conectados, elige uno en «¿Qué servidor decide los rangos?».

El bot actualiza los roles cuando un jugador entra al servidor y cuando cambia su rango. Solo añade y quita los roles que aparecen aquí.

Ajustes

• {player} se sustituye por el nombre de Minecraft. Sin él, todos reciben el mismo comando.
• Los comandos van sin barra, con 300 caracteres como máximo. Uno de los dos comandos puede quedar vacío.
• Los comandos se ejecutan con permisos de consola.
• /role-sync list muestra todas las reglas, /role-sync remove role: @VIP borra una.

Problemas

El comando no se ejecuta en el juego

• La persona tiene que estar vinculada en este servidor de Discord. Puede comprobarlo con /link show.
• El servidor de Minecraft tiene que aceptar el comando en commands.mode y commands.allow, consulta Configurar.
• Los comandos rechazados aparecen en el registro de comandos. Elige su canal con /notices channel purpose: commands.

Quien ya tenía el rol no recibe el rango

El comando solo se ejecuta cuando se añade o se quita el rol. Quien lo tenía antes de vincularse o antes de que existiera la regla no recibe nada. Quítale el rol y vuelve a dárselo.

No se da el rol de Discord

• El rol del bot tiene que estar por encima del rol que debe dar, en los ajustes del servidor de Discord. Si no, el panel muestra «Rol del bot demasiado bajo».
• El jugador tiene que estar vinculado y entrar al servidor después de crear la asignación.

«Rango en el juego» está vacío

El servidor aún no ha informado de ningún rango. Comprueba que LuckPerms está funcionando y que el plugin está actualizado (descarga). Los rangos aparecen en cuanto un jugador entra o cambia un rango.

No puedes asignar un rol

Solo puedes asignar roles que estén por debajo de tu rol más alto. Los roles con permisos de moderación, como expulsar, banear o gestionar roles, solo puede asignarlos un administrador.

El rol aparece y desaparece una y otra vez

Dos servidores de Minecraft informan de rangos distintos para el mismo jugador. Elige uno en «¿Qué servidor decide los rangos?».