Discord
Conecta tu servidor de Discord para vincular cuentas, sincronizar roles según los rangos, enlazar el chat, publicar registros del staff y ofrecer comandos de barra.
El módulo Discord conecta tu servidor o red de Minecraft con tu servidor de Discord a través de tu propio bot. Los jugadores vinculan sus cuentas, reciben roles de Discord según sus rangos y chatean entre el juego y Discord. Tu staff recibe los registros de sanciones, encarcelamientos, reportes y tickets en los canales que elijas.
Este módulo requiere la edición completa. Consulta ediciones.
Funciones
- Vinculación de cuentas. Un jugador escribe
/discord linken el juego y recibe un código. Lo envía en Discord con el comando de barra/link, o en un mensaje privado al bot. Cada cuenta de Minecraft se vincula a una sola cuenta de Discord y viceversa. - Recompensa por vincular. Da dinero y ejecuta comandos de consola la primera vez que un jugador vincula su cuenta. La recompensa se da una sola vez por cuenta de Minecraft y una sola vez por cuenta de Discord, a través del buzón.
- Roles según los rangos. Los jugadores vinculados reciben los roles de Discord que corresponden a sus rangos. Los roles se actualizan cuando se conectan y cuando cambia su rango.
- Apodos de Discord. Si quieres, renombra a los miembros vinculados con su nombre de Minecraft o con su apodo en el juego.
- Puente de chat. Un canal de Discord y el chat del juego se reflejan mutuamente. También se pueden publicar las entradas, salidas, muertes, progresos y el inicio y la parada del servidor. Los jugadores invisibles nunca se anuncian.
- Registros del staff. Las sanciones, los encarcelamientos, los reportes y los tickets se publican en sus propios canales. El staff con una cuenta vinculada puede encargarse de un reporte o cerrarlo con botones directamente desde Discord.
- Mensaje de estado. Un mensaje en el canal que elijas muestra los jugadores conectados, los TPS y el tiempo en línea de cada servidor, actualizado cada minuto.
- Comandos de barra en Discord:
/link <code>: vincula la cuenta de Discord a una cuenta de Minecraft./online: lista los jugadores conectados en cada servidor./player <name>: muestra el perfil de un jugador./leaderboard <board>: muestra el top 10 de una clasificación. Solo disponible cuando el módulo de clasificaciones tiene clasificaciones.
- Un solo bot para toda la red. Un único servidor ejecuta el bot. Los demás servidores le envían sus eventos, así que el puente de chat y los registros cubren todos los servidores.
Configuración
1. Crear el bot
Lo haces una sola vez y lleva unos cinco minutos. El panel Conexión de la página Discord en el editor web muestra los mismos pasos.
- Abre el portal de desarrolladores de Discord y crea una nueva aplicación. Ponle el nombre que quieras que tenga tu bot.
- Ve a la página Bot de la aplicación, haz clic en Reset Token y copia el token.
- En la misma página Bot, en Privileged Gateway Intents, activa Message Content Intent y guarda. El bot lo necesita para leer el canal del puente de chat y los códigos enviados por mensaje privado. Los demás intents privilegiados no son necesarios.
- En el editor web, abre Discord, pega el token en Token del bot y guarda.
- Haz clic en Invitar al bot y añádelo a tu servidor de Discord. El enlace de invitación aparece cuando el token está guardado y ya pide los permisos que necesita el bot: View Channels, Send Messages, Embed Links, Read Message History, Manage Roles y Manage Nicknames.
Mantén tu token en secreto. Una vez guardado, no se vuelve a mostrar en el editor web. Si se filtra, restablécelo en la página Bot del portal y pega el nuevo.
El panel Conexión muestra el estado del bot: Bot en línea cuando todo funciona. Si muestra Falta un intent, activa Message Content Intent y vuelve a guardar el token. Si muestra Bot no invitado, usa el botón de invitación. Si muestra Falta la biblioteca, el servidor del bot no ha podido descargar lo que necesita para hablar con Discord: comprueba su acceso a internet y reinícialo.
2. Elegir el servidor del bot y el servidor de Discord
| Ajuste | Qué hace |
|---|---|
| Servidor del bot | En una red, solo este servidor ejecuta el bot. Los demás servidores le envían sus eventos. Un servidor único siempre ejecuta el bot él mismo. |
| Servidor de Discord | Si el bot está en varios servidores de Discord, elige el que se va a usar. Por defecto, el primero. |
| Actividad del bot | Texto que se muestra bajo el nombre del bot, por ejemplo {online} players. Vacío: ninguno. |
Los canales y los roles aparecen en las listas de abajo cuando el bot está en línea en tu servidor de Discord. Aparece un aviso junto a cualquier canal donde el bot no pueda escribir.
3. Puente de chat
| Ajuste | Qué hace | Por defecto |
|---|---|---|
| Canal del chat | Este canal y el chat del juego se reflejan mutuamente. | Ningún canal |
| Chat del juego a Discord | Envía los mensajes del juego al canal. | Activado |
| Discord al chat del juego | Muestra los mensajes del canal en el juego. | Activado |
| Solo miembros vinculados | Solo los miembros con una cuenta vinculada pueden hablar en el juego desde Discord. | Desactivado |
| Entradas y salidas | Publica cuando los jugadores entran y salen. | Activado |
| Muertes | Publica los mensajes de muerte. | Activado |
| Progresos | Publica los progresos. | Activado |
| Inicio y parada del servidor | Publica cuando un servidor se inicia o se detiene. | Activado |
| Longitud máxima de los mensajes | Los mensajes más largos se cortan, en ambas direcciones. | 256 |
Las menciones y el formato escritos en el juego nunca se aplican en Discord. Los jugadores silenciados nunca pueden hablar en el juego desde Discord.
Formatos de los mensajes te permite cambiar el aspecto de cada mensaje del puente: los mensajes de Discord en el juego (con colores de Minecraft), y los mensajes del juego, entradas, salidas, muertes, progresos, inicio y parada del servidor en Discord (con **bold** y *italic*). Cada idioma tiene sus propios textos.
4. Registros del staff
Cada registro va a su propio canal. Deja un canal vacío y ese registro no se publica.
| Ajuste | Qué publica |
|---|---|
| Canal de sanciones | Baneos, silencios, expulsiones y advertencias, puestos y levantados. |
| Canal de la prisión | Jugadores enviados a la cárcel y liberados. |
| Canal de reportes | Reportes nuevos, en curso y cerrados. |
| Canal de tickets | Tickets nuevos, cerrados y valorados. |
| Respuestas de tickets | Publica también cada respuesta escrita en un ticket. Desactivado por defecto. |
| Botones de reportes | El staff con una cuenta vinculada puede encargarse de un reporte o cerrarlo desde Discord. Activado por defecto. |
| Imagen de la cabeza del jugador | Dirección de la cabeza que se muestra en los registros. {uuid} y {name} se sustituyen. Vacío: ninguna. |
Los botones de reportes solo funcionan para los miembros vinculados que tienen el permiso inglis.reports.notify en el juego.
5. Estado
Elige un Canal de estado y el bot mantiene allí un mensaje, actualizado cada minuto, con los jugadores conectados, los TPS y el tiempo en línea de cada servidor.
6. Roles
Solo los jugadores vinculados reciben roles.
| Ajuste | Qué hace | Por defecto |
|---|---|---|
| Dar roles según los rangos | Los jugadores vinculados reciben los roles de Discord de sus rangos. | Activado |
| Rangos usados | Todos los rangos (también los heredados) o solo el Rango más alto. | Todos los rangos |
| Quitar los demás roles | Se quita un rol de la tabla cuando el jugador ya no tiene su rango. | Activado |
| Apodo de Discord | Sin cambios, Nombre de Minecraft o Apodo. | Sin cambios |
| Roles por rango | Tabla que asocia cada rango con un rol de Discord. Usa Añadir un rol para añadir una línea. | Vacío |
Discord solo permite al bot dar roles que estén por debajo de su propio rol. Los roles demasiado altos aparecen marcados como "por encima del bot" en la lista. Sube el rol del bot en los ajustes de tu servidor de Discord. Lo mismo vale para los apodos.
7. Vinculación de cuentas
| Ajuste | Qué hace | Por defecto |
|---|---|---|
| Duración del código (minutos) | Tiempo que tiene un jugador para enviar el código que da /discord link. |
10 |
| Vincular por mensaje privado | Los jugadores también pueden enviar su código al bot por mensaje privado. | Activado |
| Dinero de recompensa | Se da una vez por cuenta en la primera vinculación. 0: nada. | 0 |
| Moneda de la recompensa | Identificador de la moneda. Vacío: la moneda principal. | Moneda principal |
| Comandos de recompensa | Comandos de consola que se ejecutan una vez en la primera vinculación. {player} es el nombre del jugador. |
Vacío |
La página Cuentas vinculadas lista cada jugador vinculado con su cuenta de Discord y la fecha de vinculación. Puedes buscar en ella y desvincular a un jugador. Desvincular quita los roles sincronizados, y la recompensa de la primera vinculación no se vuelve a dar.
Comandos
| Comando | Qué hace | Permiso |
|---|---|---|
/discord |
Muestra si tu cuenta está vinculada, y a qué cuenta de Discord. | inglis.discord.discord (todos) |
/discord link |
Te da un código para vincular tu cuenta en Discord. | inglis.discord.discord |
/discord unlink |
Desvincula tu cuenta. | inglis.discord.discord |
El alias, el permiso, el cooldown, el precio, los mundos y las reglas por rango de /discord se pueden cambiar en el editor web, consulta comandos.
Consejos
- Tras demasiados códigos incorrectos, una cuenta de Discord tiene que esperar un cuarto de hora antes de volver a intentarlo. Así se impide adivinar los códigos.
- Si los comandos de barra no aparecen en Discord, vuelve a invitar al bot con el botón del editor web.
- En una red, elige como servidor del bot uno que esté siempre encendido, como tu lobby.