Plugin de Minecraft EssentialsDiscord

🔌 Acerca de EssentialsX Discord

EssentialsX Discord (distribuido como el módulo EssentialsDiscord) es un módulo oficial de EssentialsX que integra un servidor Minecraft con un servidor Discord. Funciona como un archivo JAR de plugin junto al módulo principal de EssentialsX y se conecta a Discord mediante un token de bot configurado para reenviar chat, eventos y ofrecer interacciones del lado de Discord con el apoyo de una pequeña API.

🎯 Propósito

El propósito principal del módulo es doble: reenviar chats/eventos seleccionados de Minecraft a canales de Discord y reenviar mensajes/comandos seleccionados de Discord al servidor de Minecraft. Está pensado para administradores de servidores que quieren comunicación directa y configurable, además de control remoto limitado entre Discord y un servidor Minecraft basado en EssentialsX.

⚙️ Funciones

• Asignación de canales configurable para distintos tipos de mensajes (chat, entrar/salir, staff, etc.).
• Reenvío del chat de Minecraft a Discord y, de forma opcional, de mensajes de Discord al chat de Minecraft.
• Comandos slash del lado de Discord que pueden ejecutar comandos de consola, enviar mensajes a jugadores y mostrar listas de jugadores (configurables y restringidos por roles).
• Sistema granular de tipos de mensaje y formato por tipo definido en la configuración del plugin.
• API para desarrolladores para registrar tipos de mensaje personalizados y comandos de interacción de Discord mediante la API DiscordService proporcionada.

🧩 Para quién es

• Propietarios de servidores que usan EssentialsX y quieren sincronización de chat entre Discord ↔ Minecraft.
• Equipos de staff que quieren conectar canales privados de staff con miembros del staff dentro del juego.
• Desarrolladores de plugins que quieren exponer interacciones sencillas con Discord o ganchos de mensajes personalizados hacia Discord.

🏗️ Casos de uso de ejemplo

• Reenviar el chat global a un canal dedicado de Discord mientras se envían mensajes de staff solo a los miembros del staff dentro del juego.
• Permitir que los roles verificados de Discord ejecuten consultas o comandos configurados del servidor mediante comandos slash sin exponerlos públicamente.
• Hacer que otro plugin envíe notificaciones estructuradas a Discord registrando un tipo de mensaje personalizado con la API de EssentialsX Discord.

⌨️ Comandos

EssentialsX Discord expone comandos slash configurables del lado de Discord (registrados en Discord) en lugar de los comandos de chat típicos de Minecraft. Esos comandos (con ejemplos en la documentación oficial) se ejecutan desde Discord y pueden ejecutar comandos de consola, enviar mensajes a jugadores o mostrar listas de jugadores. La disponibilidad de comandos y las funciones elevadas se controlan mediante la configuración de roles/IDs en el archivo de configuración del plugin.

🔐 Permisos

⚙️ Instalación

📥 Configuración

• Descarga el archivo JAR del módulo EssentialsX Discord y colócalo en el directorio plugins/ de tu servidor junto al JAR principal de EssentialsX.
• Inicia el servidor para generar la configuración del módulo y luego detén el servidor.
• Configura el token del bot, los IDs de los canales, los tipos de mensaje y la configuración de roles de los comandos en plugins/EssentialsDiscord/config.yml como se documenta y luego reinicia.

📦 Dependencias

• EssentialsX (core) — el módulo funciona como un complemento de la suite de plugins EssentialsX.

🧠 Notas técnicas

• El módulo proporciona una API de servicio (DiscordService) para que otros plugins registren tipos de mensaje personalizados y envíen mensajes a canales de Discord configurados.
• Los comandos del lado de Discord se controlan por roles/IDs configurados en el archivo del plugin en lugar de por nodos de permisos estándar de Minecraft.
• La configuración de tipo administrador (token del bot, IDs de canales, formato de mensajes, IDs de roles de comandos) se realiza en el archivo de configuración del módulo creado al iniciarse por primera vez.

🤝 Cuándo es útil este plugin

Cuando necesitas comunicación bidireccional, gestionada y configurable entre una comunidad de Discord y un servidor Minecraft basado en EssentialsX (incluidos comandos de Discord restringidos por roles y ganchos para desarrolladores), EssentialsX Discord ofrece un módulo centrado que gestiona el mapeo de mensajes y una pequeña API para integraciones.