Guía de Configuración de HyVotifier

Recompensa a los jugadores que votan por tu servidor y aumenta tu visibilidad en las listas de servidores.

Cómo Funcionan las Recompensas de Voto

Cuando los jugadores votan por tu servidor en nuestro sitio, enviamos una notificación a tu servidor. HyVotifier recibe el voto y recompensa automáticamente al jugador.

Votar

El jugador vota en nuestro sitio

→
Notificar

Enviamos el voto a tu servidor

→
Recompensar

El jugador recibe su recompensa

Características de HyVotifier

  • Comandos de recompensa personalizados
  • Mensajes de chat y broadcasts
  • Notificaciones en pantalla
  • Sonidos personalizados
  • Recordatorios de voto diarios
  • GUI de voto personalizada con /vote
  • Reenvío de votos para redes
  • Votos de prueba para verificación

Paso 1: Instalar HyVotifier

1

Descargar HyVotifier

Descarga HyVotifier desde CurseForge:

Descargar desde CurseForge
2

Instalar el Mod

Coloca el archivo .jar o .zip descargado en la carpeta mods/ de tu servidor y reinicia el servidor.

Paso 2: Configurar HyVotifier

Después del primer inicio, HyVotifier crea archivos de configuración en mods/HSL_Votifier/

Configuración Principal (config.json)

{
  "BindHost": "0.0.0.0",
  "BindPort": 8192,
  "DisableV1Protocol": false,
  "DebugMode": false,
  "Tokens": {
    "HytaleTopServers": "your-secure-token-here"
  },
  "RewardCommands": [
    "give %player% diamond 1"
  ],
  "RewardMessages": [
    "<gray>Thanks for your vote on <gold>%from%</gold>. <green>Enjoy your rewards!</green>"
  ],
  "BroadcastWhenOffline": false,
  "RewardBroadcasts": [
    "<gray>Player <gold>%player%</gold> has voted for our server!</gray>"
  ]
}
BindHost- IP para escuchar (0.0.0.0 para todas)
BindPort- Puerto para conexiones de votos (predeterminado: 8192)
Tokens- Tokens del protocolo V2 (nombre del servicio → token)
RewardCommands- Comandos a ejecutar cuando el jugador vota
RewardMessages- Mensajes enviados al votante
RewardBroadcasts- Mensajes transmitidos a todos los jugadores

Marcadores disponibles: %player% (voter username), %from% (voting site name)

Protocolos de Votifier

Recomendado

Protocolo V2 (Token/HMAC)

Protocolo moderno que usa tokens compartidos para autenticación.

"Tokens": {
  "SiteName": "your-token"
}

Agrega el token proporcionado por el sitio de votación a tu configuración.

Protocolo V1 (RSA)

Protocolo heredado que usa encriptación de clave pública RSA.

Proporciona el contenido de tu archivo de clave pública al sitio de votación:

mods/HSL_Votifier/rsa/public.key

Paso 3: Abrir el Puerto de Votifier

Important: Votifier usa TCP (no UDP como el servidor de juego). Abre el puerto TCP 8192 en tu firewall.

Linux (ufw)

sudo ufw allow 8192/tcp

Linux (iptables)

sudo iptables -A INPUT -p tcp --dport 8192 -j ACCEPT

Verificar que el Puerto está Abierto

Usa un verificador de puertos como ping.eu/port-chk para verificar que tu puerto de Votifier es accesible.

Si el puerto aparece como "cerrado", los sitios de votación no pueden enviar votos a tu servidor.

Características Opcionales

Notificaciones en Pantalla (notification.json)

Muestra una notificación visual cuando los jugadores votan:

{
  "Enabled": true,
  "TitleMessage": "<#e2b0ff>Vote Received!</#e2b0ff>",
  "DescriptionMessage": "<gray>Thanks for voting on <#9f44d3>%from%</#9f44d3>!</gray>",
  "IconItem": "Ingredient_Voidheart"
}

Recordatorios de Voto (voteReminder.json)

Recuerda a los jugadores votar si no lo han hecho recientemente:

{
  "Enabled": true,
  "SendOnJoin": true,
  "ExpireAfterHours": 24,
  "DelayInMinutes": 1,
  "Message": "<red><b>Heads Up!</b></red> <gray>You haven't voted today! Use <green>/vote</green> for free rewards!</gray>"
}

Formato de Colores

HyVotifier soporta etiquetas de color estilo MiniMessage:

<gray>, <gold>, <green>, <red>, <yellow>, <blue>, <aqua>, <white>

<gradient:red:yellow:green:blue:purple>Rainbow!</gradient>

Comandos

ComandoPermisoDescripción
/voteNingunoAbre la GUI de voto con enlaces de voto clicables
/testvote <player>votifier.testEnvía un voto de prueba para verificar la configuración

Paso 4: Configurar en Hytale Top Servers

  1. 1Ve a tu panel de servidor
  2. 2Haz clic en Editar Servidor
  3. 3Desplázate hasta Integración de Votifier
  4. 4Activa Votifier y selecciona tu versión de protocolo
  5. 5Ingresa tu puerto de Votifier (predeterminado: 8192)
  6. 6Para V2: Ingresa tu token | Para V1: Pega tu clave pública
  7. 7Usa Probar Conexión para verificar
  8. 8Guarda tu configuración

Solución de Problemas

No se Reciben Votos

  • Verifica que el puerto TCP 8192 esté abierto en tu firewall
  • Usa ping.eu/port-chk para verificar que el puerto es accesible
  • Verifica que HyVotifier se cargó correctamente en los logs del servidor
  • Revisa tu configuración de dirección y puerto en nuestro sitio

Falla la Prueba de Conexión

  • Para V2: Verifica que el token coincida exactamente (distingue mayúsculas)
  • Para V1: Asegúrate de haber copiado todo el contenido de la clave pública
  • Asegúrate de que tu servidor esté ejecutándose al probar
  • Intenta usar tu dirección IP en lugar del nombre de dominio

Errores de Formato de Configuración

Las configuraciones de HyVotifier son archivos JSON. Usa JSONLint para verificar errores de formato si el mod no carga correctamente.

Usar Votos de Prueba

Ejecuta /testvote TuNombre en la consola del servidor para simular un voto y verificar que tus recompensas funcionan correctamente.

Servidores Usando Votifier

Mira estos servidores que recompensan a los jugadores por votar.