Integracion Minecraft con Discord

Sistema de integración avanzada con Discord

El sistema de integración con Discord desarrollado por Teramont Host es una solución propietaria diseñada para ofrecer un nivel de control, monitoreo e interacción que no existe de forma nativa en Minecraft Bedrock ni en terceros.

Este sistema permite conectar directamente el servidor Bedrock con uno o más canales de Discord, creando un entorno unificado donde la administración, la comunicación y la supervisión del servidor pueden realizarse sin necesidad de acceder constantemente a la consola del panel.

A diferencia de bots externos o addons tradicionales, esta integración opera a nivel de servidor, utilizando eventos internos del motor Bedrock y un sistema de validación propio, lo que garantiza estabilidad, seguridad y coherencia entre ambos entornos.

Objetivo del sistema

El objetivo principal es facilitar la administración remota del servidor y mejorar la comunicación entre administradores y jugadores, permitiendo:

• Centralizar la gestión desde Discord.
• Reducir la necesidad de acceso directo al panel TCP.
• Supervisar el estado del servidor en tiempo real.
• Mantener un mayor control sobre acciones administrativas sensibles.

Todo esto sin comprometer la integridad del mundo, los datos de los jugadores ni el rendimiento del servidor.

Características del sistema de integración con Discord

Comunicación bidireccional en tiempo real

• Visualización de mensajes del chat del juego directamente en Discord.
• Envío de mensajes desde Discord hacia el chat del servidor.
• Sincronización inmediata, sin retrasos perceptibles.
• Formato de mensajes personalizable para adaptarse a cada comunidad.

Vinculación del estado del servidor

• Notificaciones automáticas cuando el servidor:
  • Se inicia.
  • Se apaga.
• Información clara y legible sobre el estado del servicio.
• Ideal para comunidades que desean estar informadas sin ingresar al juego.

Eventos del jugador

El sistema permite reflejar eventos clave del juego en Discord, como:

• Conexión de jugadores.
• Desconexión de jugadores.
• Muertes de jugadores (con motivo y contexto cuando está disponible). Esto facilita la moderación y el seguimiento de la actividad del servidor.

Acceso remoto a la consola del servidor

• Visualización de la salida de la consola del servidor en un canal de Discord dedicado.
• Posibilidad de ejecutar comandos directamente desde Discord.
• Lectura en tiempo real de logs relevantes.

Control de permisos por roles

• Restricción de interacción mediante roles de Discord.
• Posibilidad de definir qué roles pueden:
  • Enviar mensajes al servidor.
  • Ejecutar comandos.
• Alternativamente, el control puede delegarse a los permisos del propio canal de Discord. Esto permite una gestión flexible sin necesidad de modificar el sistema constantemente.

Bloqueo de comandos sensibles

• Definición de comandos bloqueados que no pueden ejecutarse desde Discord.
• Prevención de acciones críticas como:
  • Apagar el servidor.
  • Modificar permisos de operadores.
• Aumenta la seguridad sin sacrificar funcionalidad.

Separación lógica de canales

• Canal exclusivo para chat del juego.
• Canal independiente para consola y administración.
• Evita mezclar mensajes y mantiene la organización.
• Mejora la legibilidad y el control.

Integración nativa sin addons

• No requiere modificaciones dentro del mundo.
• No consume recursos adicionales del servidor de juego.
• Funciona a nivel de sistema y consola.
• Compatible con servidores vanilla. Esto garantiza estabilidad y elimina conflictos con mundos o complementos.

Diseño orientado a estabilidad y seguridad

• Desarrollo bajo prácticas estrictas de validación.
• Control de entrada de comandos.
• Manejo seguro de eventos y mensajes.
• Aislamiento del sistema para evitar impactos en el mundo o los datos. El sistema no compromete la integridad del servidor ni del mundo, incluso ante un uso intensivo.

Requisitos técnicos obligatorios

Antes de configurar el sistema, es indispensable que el servidor tenga activadas las siguientes propiedades, las cuales habilitan la lectura de eventos y la interacción con el motor del juego:

gametest=true
console-log=true
content-log-console-output-enabled=true

Estas opciones cumplen funciones específicas:

• gametest: permite acceder a eventos internos del juego necesarios para detectar acciones de jugadores.
• console-log: habilita el registro detallado de la consola.
• content-log-console-output-enabled: permite capturar mensajes estructurados del sistema.

Archivo de configuración: discord-config.js

home / container / discord-config.js

Toda la integración se gestiona desde un único archivo de configuración, lo que permite un control claro y centralizado del sistema.

Activación global

enabled: false

• true: activa completamente el sistema de Discord.
• false: desactiva toda la integración, sin cargar procesos adicionales.

Este valor actúa como un interruptor maestro. Ninguna otra opción tendrá efecto si permanece desactivado.

Token del bot de Discord

botToken: "TU_TOKEN_AQUI"

Este campo debe contener el token del bot generado desde el Discord Developer Portal. El bot es el intermediario entre Discord y el servidor Bedrock.

Canal de chat (interacción con jugadores)

El canal de chat permite la comunicación directa entre jugadores del servidor y usuarios de Discord.

chatChannel: {
  enabled: true,
  channelId: "CHANNEL_ID_CHAT",
  allowedRoleIds: [],

Propiedades principales

• enabled: habilita o deshabilita este canal.
• channelId: ID del canal de Discord que actuará como chat puente.
• allowedRoleIds: restringe quién puede enviar mensajes al juego.

Si allowedRoleIds está vacío, cualquier usuario del canal podrá interactuar. Esta opción es recomendable cuando los permisos se administran directamente desde Discord mediante roles del canal.

Funciones del canal de chat

features: {
  showChat: true,
  showJoinLeave: true,
  showDeaths: true,
  showServerStatus: true,
}

Cada opción controla un tipo específico de evento:

• showChat: permite visualizar y enviar mensajes de chat entre jugadores y usuarios de Discord
• showJoinLeave: notifica entradas y salidas de jugadores.
• showDeaths: muestra eventos de muerte.
• showServerStatus: informa cuando el servidor inicia o se apaga.

Estas opciones pueden combinarse libremente según las necesidades del servidor.

Canal de consola (administración remota)

Este canal está destinado a tareas administrativas y monitoreo técnico.

consoleChannel: {
  enabled: true,
  channelId: "CHANNEL_ID_CONSOLE",
  allowedRoleIds: [],
  allowCommands: true,

Funciones clave

• Visualización en tiempo real de la consola del servidor.
• Ejecución remota de comandos Bedrock.
• Monitoreo de eventos internos y errores.

Seguridad y restricciones

features: {
  showAutoSaveMsg: false,
  blockedCommands: ["op", "stop"],
}

• blockedCommands: impide ejecutar comandos críticos incluso si allowCommands está activo.
• showAutoSaveMsg: controla la visibilidad de mensajes de guardado "Procesando Autoguardado..."

Informacion importante sobre el canal de consola en Discord

El canal de consola está diseñado para mostrar información sensible del servidor y, opcionalmente, permitir la ejecución remota de comandos directamente en la consola del juego.

Por este motivo, solo deben tener acceso a este canal personas de absoluta confianza o miembros del equipo de administración. El uso indebido de comandos sensibles puede provocar fallos graves, alteraciones en el servidor o incluso su detención.

Se recomienda:

• Limitar el acceso mediante roles específicos.
• Bloquear comandos críticos utilizando la opción blockedCommands.
• Deshabilitar el envío de comandos (allowCommands: false) si el canal se utilizará únicamente para visualización.

El uso responsable de esta funcionalidad es clave para mantener la estabilidad y seguridad del servidor.

Formato de mensajes y placeholders

Cada tipo de mensaje dispone de placeholders específicos, no todos comparten los mismos valores.

Chat de Minecraft → Discord

chat: "*{player}*: {message}"

Placeholders disponibles:

• {player}
• {message}
• {timestamp}

Discord → Minecraft

discordtominecraft: "**{username}**: {message}"

Placeholders disponibles:

• {username}
• {userTag}
• {userid}
• {message}
• {timestamp}

Eventos de jugador

Ingreso:

join: "> 🔹 **{player}** se ha unido al servidor."

Placeholders:

• {player}
• {timestamp}
• {coords}
• {health}
• {hunger}
• {world}
• {gamemode}

Salida:

leave: "> 🔸 **{player}** ha salido del servidor."

Placeholders:

• {player}
• {timestamp}

Muerte:

death: "💀 **{player}** ha muerto {reason}."

Placeholders:

• {player}
• {reason}
• {coords}
• {timestamp}

Estado del servidor

serverStart: "🟢 El servidor ha iniciado."
serverStop: "🔴 El servidor se está apagando."

No utilizan placeholders dinámicos.

Obtención del ID de un canal de Discord

1. Abra Configuración de usuario.
2. Diríjase a Avanzado.
3. Active Modo desarrollador.
4. Haga clic derecho sobre un canal.
5. Seleccione Copiar ID.

Ese valor debe pegarse en channelId o donde sea requerido.

Seguridad y estabilidad

Este sistema fue diseñado bajo criterios estrictos de desarrollo:

• Validación de comandos.
• Restricción por roles.
• Separación de funciones por canal.
• Bloqueo de acciones críticas.
• Comunicación controlada entre procesos.

Estado del sistema y desarrollo continuo

El sistema de integración con Discord de Teramont Host se encuentra en constante desarrollo y ampliación. Al tratarse de una funcionalidad avanzada y en evolución, es posible que en determinadas situaciones se presenten comportamientos inesperados o errores puntuales durante su uso.

En caso de detectar cualquier fallo, comportamiento anómalo o error en el funcionamiento del sistema, se agradecerá enormemente que sea reportado a través del servidor oficial de Discord de Teramont Host. Esto permitirá que el equipo de desarrollo pueda analizar el caso, reproducir el problema y aplicar una solución en el menor tiempo posible.

Asimismo, toda duda, sugerencia o propuesta de mejora es bienvenida. La retroalimentación de los usuarios es una parte fundamental para seguir perfeccionando este proyecto y continuar avanzando en el desarrollo de nuevas funciones que aporten valor real a la gestión y administración de los servidores.

Teramont Host apuesta por un desarrollo activo, responsable y enfocado en ofrecer herramientas únicas, seguras y útiles para la comunidad. ⚡