DiscordWebhook

Un plugin para servidores de Hytale que vincula eventos del juego a un canal de Discord utilizando un webhook. Este plugin envía automáticamente las notificaciones de unión, salida, muertes y mensajes de chat de los jugadores a tu servidor de Discord.

Funciones Actuales

• Sistema de Configuración de Eventos: Archivos de configuración individuales para cada tipo de evento
• Sistema de Marcadores de Posición: Marcadores de posición dinámicos como {player}, {message}, {deathCause}, etc.
• Múltiples Canales de Webhook: Dirige diferentes eventos a diferentes canales de Discord
• Personalización de Mensajes: Control total sobre el formato del mensaje (embeds, texto plano o ambos)
• Activación y Desactivación de Eventos: Habilita o deshabilita eventos individuales
• Comprobación de Actualizaciones: Verifica las versiones en Github para actualizaciones y te notifica si hay alguna
• Recarga Rápida: Recarga la configuración sin reiniciar el servidor utilizando /dw-reload

Eventos Actuales

• Eventos de Unión de Jugadores: Envía notificaciones personalizables cuando un jugador se une al servidor
• Eventos de Salida de Jugadores: Envía notificaciones personalizables cuando un jugador sale del servidor
• Eventos de Muerte de Jugadores: Envía notificaciones personalizables cuando un jugador muere en el servidor
• Chat de Jugadores: Reenvía todos los mensajes de chat de los jugadores a Discord con total personalización

Instalación

• Descarga la última versión desde la página de lanzamientos
• Coloca el archivo DiscordWebhook-x.x.x.jar en la carpeta mods de tu servidor de Hytale
• Inicia tu servidor para generar los archivos de configuración
• Edita el archivo Jemsire_DiscordWebhook/WebhookConfig.json y añade tu(s) URL(s) de webhook de Discord
• (Opcional) Personaliza las configuraciones de eventos individuales en la carpeta Jemsire_DiscordWebhook/events/
• En el juego, escribe /dw-reload para recargar la configuración y comenzar el plugin

Nota: Las configuraciones de eventos predeterminadas se crean automáticamente en el primer lanzamiento. Puedes personalizarlas o dejarlas como están.

Configuración

Después del primer lanzamiento, se crearán archivos de configuración en tu carpeta de mods. El plugin utiliza un sistema de configuración de dos niveles:

• WebhookConfig.json: Configuración principal con URLs de webhook y canales
• events/: Archivos de configuración de eventos individuales

Obteniendo una URL de Webhook de Discord

• Abre la configuración de tu servidor de Discord
• Ve a Integraciones → Webhooks
• Haz clic en Nuevo Webhook o selecciona un webhook existente
• Copia la URL del webhook
• Pégala en tu archivo WebhookConfig.json

Archivo de Configuración Principal (WebhookConfig.json)

El archivo de configuración principal se encuentra en Jemsire_DiscordWebhook/WebhookConfig.json:

{
  "WebhookLink": "https://discord.com/api/webhooks/YOUR_WEBHOOK_URL_HERE",
  "Version": 2,
  "UpdateCheck": true,
  "WebhookChannels": {
    "default": "https://discord.com/api/webhooks/YOUR_DEFAULT_WEBHOOK_URL",
    "staff": "https://discord.com/api/webhooks/YOUR_STAFF_WEBHOOK_URL"
  }
}

Opciones de Configuración:

• WebhookLink: URL de webhook predeterminada (utilizada como respaldo)
• Version: Versión de configuración (actualmente 2)
• UpdateCheck: Habilitar/deshabilitar la comprobación automática de actualizaciones
• WebhookChannels: Mapa de nombres de canales a URLs de webhook (por ejemplo, “default”, “staff”, “admin”)

Archivos de Configuración de Eventos

Cada evento tiene su propio archivo de configuración en Jemsire_DiscordWebhook/events/. Las configuraciones predeterminadas se crean automáticamente en el primer lanzamiento:

• PlayerChat.json – Mensajes de chat de jugadores
• PlayerReady.json – Eventos de unión de jugadores
• PlayerDisconnect.json – Eventos de salida de jugadores
• PlayerDeath.json – Eventos de muerte de jugadores

Estructura de Configuración de Eventos

{
  "Enabled": true,
  "WebhookChannel": "default",
  "MessageJson": "{"content": "💬 **{player}**: {message}"}"
}

Opciones de Configuración:

• Enabled: Habilitar o deshabilitar este evento (true/false)
• WebhookChannel: Qué canal de webhook usar (debe coincidir con una clave en WebhookChannels de la configuración principal)
• MessageJson: JSON de webhook de Discord en bruto con marcadores de posición (ver abajo)

Ejemplos de Formato de Mensaje

Mensaje de Texto Plano:

{
  "Enabled": true,
  "WebhookChannel": "default",
  "MessageJson": "{"content": "💬 **{player}**: {message}"}"
}

Mensaje Embed:

{
  "Enabled": true,
  "WebhookChannel": "default",
  "MessageJson": "{"embeds": [{"title": "📥 Jugador Unido", "description": "{player} ha entrado en el mundo!", "color": 65280}]}"
}

Combinado (Texto + Embed):

{
  "Enabled": true,
  "WebhookChannel": "default",
  "MessageJson": "{"content": "¡Nuevo jugador!", "embeds": [{"title": "Jugador Unido", "description": "{player} se unió al servidor", "color": 65280}]}"
}

Marcadores de Posición Disponibles

Los marcadores de posición se reemplazan en tiempo de ejecución con valores reales. Usa {placeholderName} en tus cadenas JSON.

• {player} – Nombre de usuario del jugador
• {playerUsername} – Nombre de usuario del jugador (alias)
• {message} – Contenido del mensaje de chat
• {content} – Contenido del mensaje de chat (alias)
• {playerUuid} – UUID del jugador (si está disponible)
• {deathCause} – Mensaje de muerte formateado
• {deathMessage} – Mensaje de muerte formateado (alias)
• {deathMessageRaw} – Mensaje de muerte en bruto (si está disponible)

Nota: Algunos marcadores de posición no funcionarán en ciertos eventos. Los marcadores de posición se escapan automáticamente para JSON, por lo que los caracteres especiales no romperán tu carga útil de webhook.

Comandos

• /dw-reload – Recarga la configuración del plugin sin reiniciar el servidor
  • Permiso: discordwebhook.reload
  • Uso: Solo recarga si la configuración ha cambiado

Este proyecto es de código abierto:

¡Siéntete libre de contribuir o adaptarlo a tu propio sistema! Consulta el Github

¿Quieres recibir actualizaciones de todos mis proyectos?

¡Únete al discord! ¡Únete ahora!