Average Discord Bridge

Un completo plugin de puente entre Discord y Hytale que conecta sin problemas tu servidor de juego Hytale con Discord, permitiendo la sincronización de chat en tiempo real y notificaciones sobre el estado del servidor.

Descripción General

AverageDiscord es un potente plugin diseñado para servidores de Hytale que establece un puente de comunicación bidireccional entre tu chat en el juego y un canal de Discord designado. Monitorea la actividad del servidor, recibe notificaciones de entrada/salida de jugadores y permite a los miembros de Discord chatear con los jugadores en tu servidor de Hytale, todo en tiempo real.

Características

🔗 Puente de Chat Bidireccional

• Sincronización en tiempo real entre el chat del juego y Discord
• Soporte para mensajes formateados con un correcto análisis de texto
• Los mensajes de Discord enviados al canal designado aparecen en el juego
• Los mensajes del chat del juego se reenvían a Discord con los nombres de los jugadores

📢 Notificaciones del Estado del Servidor

• Notificación automática de inicio del servidor
• Notificación automática de apagado del servidor
• Notificaciones de entrada de jugadores con los nombres de los jugadores
• Notificaciones de desconexión de jugadores con los nombres de los jugadores
• Mensajes mejorados con emojis para una mejor visibilidad (✅ ☒ ➡️ ⬅️)

📡 Salida Multi-Canal Flexible

• Dirige diferentes tipos de mensajes a diferentes canales de Discord
• Soporte para 5 tipos de salida distintos: Todos, Chat, Entrada/Salida, Estado del Servidor, Registro Interno
• Configura múltiples canales con diferentes filtros de salida
• Organiza tu servidor de Discord con canales especializados para diferentes eventos

⚙️ Fácil Configuración

• Archivo de configuración basado en JSON con soporte multi-canal
• Funcionalidad de recarga en caliente sin reiniciar el servidor
• Prefijo personalizable para el bot de Discord en los mensajes del juego
• Mensaje de actividad/estado del bot personalizado
• Soporte para códigos de color formateados en los mensajes de Discord
• Opcionalmente, mostrar el conteo de jugadores activos

🛠️ Comandos de Administrador

• /discordbridge reload – Recarga la configuración del plugin al instante
• Alias: /gm, /agm, /groupman
• Sincronización de configuración de manera elegante

Instalación

Descarga el último archivo JAR de AverageDiscord

Colócalo en la carpeta de plugins de tu servidor Hytale

Crea un bot de Discord en Discord Developer Portal

Configura el plugin (consulta la sección de Configuración más abajo)

Reinicia tu servidor Hytale o usa /discordbridge reload

Configuración

Después de la primera ejecución, se creará un archivo de configuración discord_bridge.json en la carpeta AverageDiscord de tu servidor.

Ejemplo de Archivo de Configuración

{
  "botToken": "tu_token_de_bot_aquí",
  "channels": [
    {
      "channelId": "1234567890",
      "type": ["all"]
    },
    {
      "channelId": "2345678901",
      "type": ["chat"]
    },
    {
      "channelId": "3456789012",
      "type": ["join_leave", "server_state"]
    },
    {
      "channelId": "4567890123",
      "type": ["internal_log"]
    }
  ],
  "botActivityMessage": "¡Jugando a Hytale!",
  "discordIngamePrefix": "&9[Discord] ",
  "showActivePlayerCount": true
}

Opciones de Configuración

Opción	Tipo	Descripción	Ejemplo
botToken	String	Tu token de bot de Discord del Portal de Desarrolladores	"token_aquí"
channels	Array	Array de configuraciones de canales (consulta la Configuración de Canales más abajo)	[{...}]
botActivityMessage	String	El mensaje de estado del bot en Discord	"¡Jugando a Hytale!"
discordIngamePrefix	String	Prefijo para los mensajes de Discord en el juego (soporta códigos de color)	"&9[Discord] "
showActivePlayerCount	Boolean	Mostrar el conteo de jugadores activos en el estado de actividad del bot	true

Configuración de Canales

Cada objeto de canal en el array channels tiene la siguiente estructura:

Opción	Tipo	Descripción	Ejemplo
channelId	String	El ID del canal de Discord donde se enviarán los mensajes de este tipo	"1234567890"
type	Array de Strings	Tipos de salida para este canal (consulta los Tipos de Salida más abajo)	["chat", "join_leave"]

Tipos de Salida de Canal

Configura qué tipos de mensajes se envían a cada canal:

Tipo	Descripción
all	Todos los mensajes excepto los registros internos (chat, entrada/salida, estado del servidor)
chat	Mensajes de chat de jugadores en el juego
join_leave	Notificaciones de entrada y desconexión de jugadores
server_state	Notificaciones de inicio y apagado del servidor
internal_log	Mensajes de registro y depuración internos del plugin

Nota: El tipo de salida all no incluye internal_log. Si deseas registros internos, debes agregar explícitamente el tipo internal_log a un canal.

Cómo Obtener Tu Token de Bot y ID de Canal

Token de Bot:

• Ve al Discord Developer Portal
• Crea una nueva aplicación o selecciona una existente
• Navega a la pestaña “Bot”
• Haz clic en “Add Bot” (si es nuevo)
• Copia el token en la sección “TOKEN”

ID de Canal:

• Activa el Modo Desarrollador en Discord (Configuración de Usuario → Avanzado → Modo Desarrollador)
• Haz clic derecho en tu canal deseado
• Selecciona “Copiar ID de Canal”
• Pégalo en la configuración

Cómo Funciona

Enrutamiento de Mensajes

El plugin utiliza un sistema flexible multi-canal para enrutar diferentes tipos de mensajes a diferentes canales de Discord. Cada canal se configura con uno o más tipos de salida que determinan qué mensajes recibe.

Sincronización de Chat

• Del Juego → Discord: Cuando un jugador escribe en el chat, el mensaje se envía a todos los canales configurados con los tipos de salida chat o all
• De Discord → En el Juego: Cuando un usuario que no es un bot envía un mensaje en un canal configurado con los tipos de salida chat o all, aparece en el juego con un prefijo personalizable

Eventos del Servidor

El plugin monitorea e informa sobre los siguientes eventos:

• Entrada de Jugador: Enviado a canales con tipos de salida join_leave o all
• Desconexión de Jugador: Enviado a canales con tipos de salida join_leave o all
• Inicio del Servidor: Enviado a canales con tipos de salida server_state o all
• Apagado del Servidor: Enviado a canales con tipos de salida server_state o all
• Chat de Jugador: Enviado a canales con tipos de salida chat o all
• Registros Internos: Enviado solo a canales configurados explícitamente con el tipo internal_log

Listeners de Eventos

El plugin registra listeners para:

• PlayerChatEvent – Reenvía el chat en el juego a Discord
• PlayerReadyEvent – Notifica a Discord cuando los jugadores se unen
• PlayerDisconnectEvent – Notifica a Discord cuando los jugadores se van
• AllWorldsLoadedEvent – Notifica a Discord cuando el servidor inicia
• ShutdownEvent – Notifica a Discord cuando el servidor se detiene

Dependencias

Por favor, ten en cuenta: El JAR que descargas es un JAR empaquetado que incluye todas las dependencias, por lo que no necesitas instalar bibliotecas adicionales. Estas se enumeran únicamente para referencia y transparencia.

• Servidor Hytale – La implementación central del servidor (HytaleServer.jar)
• AverageHytaleCore – Biblioteca de utilidades central
• JDA (Java Discord API) – Versión 6.3.0 para funcionalidad del bot de Discord
• Gson – Análisis y serialización JSON para la configuración
• SLF4J – Implementación de registro

Requisitos

• Java 11 o superior
• Instalación activa del servidor Hytale
• Bot de Discord con permisos adecuados:
  • View Channels
  • Send Messages
  • Read Message History
  • Intents: GUILD_MESSAGES, MESSAGE_CONTENT

Comandos

/discordbridge reload

Recarga la configuración del plugin sin necesidad de reiniciar el servidor.

Alias: gm, agm, groupman

Uso: /discordbridge reload

Permiso: Administrador/operador del servidor

Códigos de Color

El discordIngamePrefix soporta códigos de color de Minecraft para personalizar la apariencia de los mensajes:

• &9 – Azul
• &a – Verde
• &c – Rojo
• &e – Amarillo
• &f – Blanco
• Y muchos más códigos de color estándar de Minecraft

Resolución de Problemas

Token de Bot Inválido

• Verifica que el token del bot esté copiado correctamente desde el Discord Developer Portal
• Asegúrate de haber copiado el token completo sin espacios adicionales
• Regenera el token si es necesario

ID de Canal No Encontrado

• Asegúrate de que el Modo Desarrollador esté habilitado en Discord
• Verifica que el ID del canal sea correcto (debe ser numérico)
• Asegúrate de que el bot tenga acceso al canal

Mensajes No Aparecen en Discord

• Verifica que el bot tenga permiso para enviar mensajes en el canal
• Verifica que el ID del canal en la configuración sea correcto
• Asegúrate de que el canal esté configurado con los tipos de salida correctos (chat, all, join_leave, server_state o internal_log)
• Verifica que al menos un canal esté configurado con el tipo de mensaje que intentas enviar
• Revisa los registros del servidor en busca de errores
• Intenta usar /discordbridge reload para refrescar la configuración

Mensajes No Aparecen en el Juego

• Verifica que el bot de Discord tenga permiso para enviar mensajes en los canales configurados
• Asegúrate de que los IDs de los canales en la configuración sean correctos
• Asegúrate de que el canal de Discord esté configurado con tipos de salida chat o all para recibir mensajes de Discord y retransmitirlos en el juego

Problemas de Configuración

• Asegúrate de que el archivo discord_bridge.json sea un JSON válido (usa un validador de JSON si es necesario)
• Verifica que todos los campos requeridos estén presentes: botToken, channels, botActivityMessage, discordIngamePrefix
• Verifica que el array type en cada canal contenga tipos de salida válidos
• Intenta usar /discordbridge reload después de hacer cambios en la configuración

Bot Fuera de Línea

• Verifica que el token del bot sea válido
• Verifica que tu servidor tenga conectividad a Internet
• Busca mensajes de error en la consola del servidor

Autor

Average (js3 en Hytale)

Nota: Este plugin requiere un token de bot de Discord válido y una configuración adecuada para funcionar. Asegúrate de que todos los requisitos previos estén…