Hytale-Discord Chat Bridge

¡Sincroniza tu servidor de Hytale con Discord en tiempo real!

🌟 Descripción

Hytale-Discord Chat Bridge es un potente plugin que conecta tu servidor de Hytale con Discord, permitiendo una comunicación bidireccional instantánea entre los jugadores y los miembros de Discord. ¡Mantén a tu comunidad conectada incluso cuando estén en diferentes plataformas!

🔧 Características Principales

💬 Sincronización de Chat Bidireccional

• Los mensajes del juego aparecen automáticamente en Discord
• Los mensajes de Discord aparecen en el chat del juego
• Sistema de prefijos personalizables para identificar los orígenes de los mensajes

🎮 Notificaciones Automáticas

• Alertas en tiempo real cuando los jugadores entran/salen del servidor
• Mensajes configurables para eventos del servidor
• Supresión opcional de los mensajes predeterminados del servidor

🖼️ Personalización Completa

• Avatar personalizado para el webhook del servidor
• Mensajes totalmente configurables

🔧 Características Técnicas

• Reconexión automática en caso de fallos
• Sistema de registro detallado para diagnósticos
• Configuración sencilla a través de un archivo JSON

⚙️ Configuración

1. Instalación

1. Coloca el archivo `.jar` en la carpeta `mods` de tu servidor
2. Reinicia el servidor
3. Configura el archivo `config.json` generado

2. Archivo de Configuración

{
  "botToken": "TOKEN_DE_TU_BOT",
  "channelId": "ID_DEL_CANAL_DISCORD",
  "serverAvatarUrl": "URL_DE_LA_IMAGEN_DEL_SERVIDOR",
  "enableHytaleToDiscord": true,
  "enableDiscordToHytale": true,
  "discordMessagePrefix": "[Discord] ",
  "hytaleMessagePrefix": "[Hytale] ",
  "hytaleMessageFormat": "[Discord] %s: %s",
  "playerJoinMessage": "🎮 %s ha entrado en el servidor!",
  "playerLeaveMessage": "👋 %s ha salido del servidor!",
  "serverStartMessage": "🚀 ¡Servidor iniciado!",
  "serverStopMessage": "🛑 ¡Servidor apagándose... Volvemos ya!",
  "showJoinLeaveMessages": true,
  "suppressDefaultJoinMessages": true,
  "reconnectAttempts": 3,
  "reconnectDelayMs": 5000
}

3. Obtención de Credenciales

• Token del Bot: Crea un bot en el Portal de Desarrolladores de Discord
• ID del Canal: Activa el modo desarrollador en Discord y copia el ID del canal
• Avatar: Usa cualquier URL de imagen pública (PNG, JPG, GIF)

🎯 Beneficios

Para Administradores

• Monitorea la actividad del servidor en tiempo real
• Comunica fácilmente con tu comunidad
• Mantén a todos informados sobre eventos importantes

Para Jugadores

• Interactúa con amigos de Discord mientras juegas
• Ve quién está en línea en el servidor
• Participa en discusiones incluso fuera del juego

Para la Comunidad

• Fortalece el sentido de comunidad
• Facilita la organización de eventos
• Mantiene a todos conectados y comprometidos

🛠️ Requisitos

• Bot de Discord con permisos apropiados
• Canal de texto en Discord para la sincronización

🔒 Permisos Requeridos

Tu bot de Discord necesita los siguientes permisos:

• `VIEW_CHANNEL` – Ver canales
• `SEND_MESSAGES` – Enviar mensajes
• `MANAGE_WEBHOOKS` – Gestionar webhooks
• `READ_MESSAGE_HISTORY` – Leer el historial de mensajes

📊 Ejemplo de Uso

Con el plugin instalado y configurado:

1. Un jugador escribe en el chat: “¡Hola a todos!”
2. El mensaje aparece instantáneamente en Discord como: `[Hytale] NombreDelJugador: ¡Hola a todos!`
3. Un miembro de Discord responde: “¡Bienvenido!”
4. La respuesta aparece en el juego como: `[Discord] NombreDeUsuario: ¡Bienvenido!`

🆘 Soporte y Problemas

Si encuentras problemas:

1. Revisa los registros del servidor en busca de mensajes de error
2. Confirma que todas las credenciales son correctas
3. Prueba con URLs de avatar conocidas
4. Verifica los permisos del bot en Discord

—

*¡Mantén a tu comunidad de Hytale conectada con el mundo de Discord!* 🚀