JHS-Votifier

JHS-Votifier es un plugin Votifier moderno y seguro para Hytale que permite a los sitios web de votación notificar a tu servidor cuando los jugadores votan, recompensando automáticamente a los jugadores y fomentando la participación.

Diseñado específicamente para Hytale, este plugin soporta múltiples protocolos de votación, mensajería rica dentro del juego y compatibilidad fluida con sitios web de listas de servidores.

Inicio Rápido: https://joinhytaleservers.com/how-to-install-votifier-for-hytale

🆕 Novedades en 1.0.1

JHS-Votifier 1.0.1 introduce notificaciones emergentes nativas en pantalla, mejor seguridad HTTP y ayudantes de configuración más claros.

Aspectos Destacados

• Notificaciones Emergentes en Pantalla
  • Las transmisiones de votación pueden mostrar emergentes a todos los jugadores
  • Los mensajes de “gracias” a los votantes pueden mostrar emergentes al votante
  • Los recordatorios de votación pueden mostrar emergentes para recordar a los jugadores que voten
  • Cada tipo de notificación tiene interruptores independientes chatEnabled y popupEnabled
  • Estilos de emergente configurables: Predeterminado, Éxito (verde), Advertencia (amarillo), Peligro (rojo)
  • El título y la descripción del emergente soportan el formato TaleMessage y marcadores de posición
• Token HTTP Dedicado
  • El punto final HTTP ahora tiene su propio token, separado del token TCP V2
  • Separación más clara entre V2 TCP (puerto 8192) y protocolos HTTP POST
  • Generado automáticamente en la primera ejecución (eliminar http_config.json para regenerar)
• Mejoras en la Guía de Configuración
  • serviceTokens ahora incluye un formato de ejemplo incorporado _serviceTokensHelp
  • http_config.json incluye campos de documentación del punto final

✨ Características

🔌 Soporte Multi-Protocolo

• Votifier V1 (cifrado RSA)
• Votifier V2 (HMAC / basado en token)
• Puntos finales HTTP POST (a través del plugin WebServer, asegurados con token)

🎁 Recompensas Automáticas por Votación

• Ejecutar comandos cuando los jugadores votan
• Recompensas opcionales por servicio

💬 Mensajería para Jugadores

• Mensajes de transmisión de votación global
• Mensajes privados de agradecimiento
• Recordatorios de votación programados
• Notificaciones emergentes en pantalla opcionales (UI nativa de Hytale)

🖥 Notificaciones Emergentes Nativas (1.0.1+)

• Utiliza el sistema de emergentes en pantalla incorporado de Hytale
• Funciona junto a los mensajes de chat o independientemente
• Interruptores por notificación: chatEnabled y popupEnabled
• Estilos de emergente configurables: Éxito (verde), Advertencia (amarillo), Peligro (rojo), Predeterminado
• El título y la descripción del emergente soportan el formato TaleMessage y marcadores de posición

📸 Ejemplos de Emergentes

🧭 Interfaz de Votación Personalizada

• Menú GUI clickeable /vote
• Enlaces de votación clickeables en el chat

🌐 Compatibilidad con Listas de Servidores

• Protocolo de consulta UDP para sondeo de estado del servidor

🎨 Formateo de Texto Rico

• Soporte completo de TaleMessage (colores, gradientes, enlaces clickeables)

🧑‍💻 Amigable para Desarrolladores

• Genera un VoteEvent para integraciones personalizadas

📦 Instalación

Descarga el último JAR de JHS-Votifier

Colócalo en el directorio mods/ de tu servidor

Inicia el servidor para generar archivos de configuración predeterminados

Configura tu(s) protocolo(s) de votación preferido(s)

Reinicia el servidor o ejecuta /votereload

🧾 Comandos

Comando
Descripción

/vote
Abre el menú de votación y/o envía enlaces de votación

/testvote <player> [service]
Ejecuta una votación de prueba (sin recompensas) (Comando de Administrador)

/votifieradmin status
Ver estado del protocolo y del oyente (Comando de Administrador)

/votifieradmin reload
Recargar archivos de configuración (Comando de Administrador)

📸 Ejemplos de Comandos

🧩 Ejemplo de Configuración

A continuación se muestra una configuración de ejemplo básica que muestra una configuración común utilizando Votifier V2 con recompensas por votación y un comando /vote.

Esta configuración funciona directamente para la mayoría de los servidores.

config.json (Configuración Principal)

{
  "debug": false,
  "keyPath": "keys",
  "messages": {
    "voteBroadcast": [
      "<gradient:blue:aqua><bold>[ VOTE ]</bold></gradient> <green>%player%</green> <white>votó en</white> <gold>%service%</gold><white>!</white>",
      "<gray>Usa <aqua>/vote</aqua> para votar y ganar recompensas!</gray>"
    ],
    "votePrivate": [
      "<gradient:gold:yellow>----------------------</gradient>",
      "<green><bold>¡Gracias por votar!</bold></green>",
      "<white>Tu voto en <aqua>%service%</aqua> fue recibido.</white>",
      "<gray>Las recompensas han sido aplicadas a tu cuenta.</gray>",
      "<gradient:gold:yellow>----------------------</gradient>"
    ],
    "voteReminder": [
      "<gradient:gold:orange>----------------------</gradient>",
      "<yellow><bold>¡No olvides votar!</bold></yellow>",
      "<white>¡Apoya nuestro servidor y gana recompensas!</white>",
      "<gray>Escribe <aqua>/vote</aqua> para ver enlaces de votación.</gray>",
      "<gradient:gold:orange>----------------------</gradient>"
    ],
    "reminderIntervalMinutes": 1
  },
  "rewards": {
    "enabled": true,
    "commands": [
      "# Comandos de ejemplo (eliminar # para habilitar):",
      "# give %player% diamond 1",
      "# give %player% emerald 5",
      "# experience add %player% 100"
    ],
    "perService": {
      "TopHytaleServers": [
        "# Comandos para votos de TopHytaleServers:",
        "# give %player% gold_ingot 5"
      ],
      "HytaleServerList": [
        "# Comandos para votos de HytaleServerList:",
        "# give %player% diamond 2"
      ]
    }
  },
  "voteCommand": {
    "openCustomGui": true,
    "sendChatMessage": true,
    "chatHeader": [
      "<gray>--------------- <gold><bold>Enlaces de Votación</bold></gold> ---------------</gray>",
      "<white>¡Haz clic en un enlace a continuación para votar y ganar recompensas!</white>"
    ],
    "chatFooter": [
      "<gray>------------------------------------------</gray>"
    ],
    "chatLinkTemplate": "<gold>[<yellow>#%id%</yellow>]</gold> <yellow><click:%link%>%name% <bold>(Clic para Votar)</bold></click></yellow>"
  },
  "voteLinks": [
    {
      "serviceName": "JoinHytaleServers",
      "link": "https://joinhytaleservers.com/"
    }
  ]
}

🔔 Configuración de Notificaciones Emergentes (1.0.1+)

JHS-Votifier soporta emergentes nativas en pantalla utilizando el sistema UI de Hytale. Cada tipo de notificación puede habilitar independientemente los mensajes de chat y los emergentes.

Ejemplo de configuración notifications

{
  "notifications": {
    "voteBroadcast": {
      "chatEnabled": true,
      "popupEnabled": true,
      "popupStyle": "Success",
      "popupTitle": "<gold>¡Voto Recibido!</gold>",
      "popupDescription": "<green>%player%</green> votó en <aqua>%service%</aqua>"
    },
    "voterNotify": {
      "chatEnabled": true,
      "popupEnabled": true,
      "popupStyle": "Success",
      "popupTitle": "<green>¡Gracias!</green>",
      "popupDescription": "¡Tu voto en <aqua>%service%</aqua> fue recibido!"
    },
    "reminder": {
      "chatEnabled": true,
      "popupEnabled": false,
      "popupStyle": "Warning",
      "popupTitle": "<yellow>Recordatorio de Votación</yellow>",
      "popupDescription": "¡No olvides <aqua>/vote</aqua> para recompensas!"
    }
  }
}

🔐 Seguridad del Token HTTP (1.0.1+)

Los puntos finales de votación HTTP ahora utilizan un token dedicado, separado del token TCP V2.

• El token se genera automáticamente en el primer inicio
• Se almacena en http_config.json
• Puede regenerarse eliminando http_config.json y reiniciando
• Se admiten tokens HTTP por servicio opcionales

🔐 Permisos

Permiso
Descripción

jhs.votifier.admin
Acceso a todos los comandos de administrador

🔒 Seguridad

• Cifrado RSA para el protocolo V1
• Autenticación HMAC basada en token para V2
• Claves criptográficamente seguras, generadas automáticamente
• Tokens por servicio opcionales
• Las votaciones de prueba están aisladas (sin recompensas ni transmisiones)

🌐 Soporte de Protocolos

Protocolo
Soportado

Votifier V1 (RSA)
✅

Votifier V2 (HMAC)
✅

HTTP POST
✅

Consulta UDP
✅

🔗 Puntos Finales HTTP

Punto Final
Método
Propósito

/JHS/Votifier/vote
POST
Recibir notificaciones de votación

/JHS/Votifier/status
GET
Verificación de salud

/JHS/Votifier/test
GET
Pruebas de depuración

🧱 Dependencias y Créditos

JHS-Votifier está diseñado para funcionar directamente sin dependencias externas requeridas.

Librerías Incluidas

• TaleMessage
  Usado para formateo de texto rico (colores, gradientes, enlaces clickeables).
  ➜ https://www.curseforge.com/hytale/mods/talemessage

Dependencias Opcionales

• Nitrado WebServer
  Requerido solo si deseas recibir votos a través de puntos finales HTTP POST.
  ➜ https://www.curseforge.com/hytale/mods/nitrado-webserver

  Si no está instalado, simplemente desactiva el soporte HTTP en http_config.json.

Configuración Mínima

No se requieren plugins adicionales.
Soporta Votifier V1 y V2 sobre TCP por defecto.

Configuración Completa

Instala Nitrado WebServer para habilitar votaciones basadas en HTTP.

🛠 Para Desarrolladores

JHS-Votifier genera un VoteEvent al que otros plugins pueden suscribirse, permitiendo un comportamiento personalizado cuando se reciben votos.

Soporta bibliotecas estándar de envío de votos de Votifier e integraciones personalizadas.

🧪 Solución de Problemas

• Asegúrate de que el puerto TCP 8192 esté abierto
• Verifica el estado del protocolo usando /votifieradmin status
• Habilita debug: true para un registro detallado
• Reinicia el servidor después de cambios en la habilitación/deshabilitación del protocolo

🆘 Soporte

¿Necesitas ayuda, encontraste un error o tienes una solicitud de función?