HyVotifier – Votifier Plugin & Mod (NuVotifier)

HyVotifier es un potente mod/plugin de Votifier para Hytale, diseñado para servidores modernos de Hytale. Si buscas un Votifier fiable para Hytale, HyVotifier facilita el seguimiento de votos, recompensar a los jugadores y aumentar la actividad de tu servidor con características completamente personalizables.

🌟 Características

• Enviar mensajes de chat personalizados a los jugadores después de que voten
• Transmitir anuncios de votos a todo el servidor cuando alguien vote
• Ejecutar comandos de recompensa automáticamente al votar (funciona con otros mods y plugins)
• Mostrar notificaciones de voto en pantalla para una retroalimentación y visibilidad instantáneas
• Reproducir sonidos personalizados cuando un jugador vota
• Recordatorios de voto diarios para fomentar la votación constante y aumentar el conteo de votos
• Probar votos utilizando un comando en el juego para verificar que todo esté configurado correctamente
• Comando de GUI de voto personalizado que abre un menú completamente configurable donde los jugadores pueden copiar fácilmente los enlaces de voto

¡Únete a nuestro Discord! para obtener soporte rápido e informes de errores!
¿Tienes problemas con tus configuraciones? Utiliza esta herramienta para comprobar errores de formato: https://jsonlint.com/

✨ Recompensas y Configuración General

Ejemplo de config.json:

{
"BindHost": "0.0.0.0",
"BindPort": 8192,
"DisableV1Protocol": false,
"RewardCommands": [
"gm adventure %player%"
],
"RewardMessages": [
"¡Gracias por tu voto en %from%! ¡Disfruta de tus recompensas!"
],
"RewardBroadcasts": [
"¡El jugador %player% ha votado por nuestro servidor!"
],
"Tokens": {
"HytaleServerList.me": "exampleSecret"
}
}

BindHost: La IP en la que votifier escucha, déjalo en 0.0.0.0 si quieres usar la IP pública de tu servidor.
BindPort: El puerto que se utiliza para escuchar votos, 8192 es el puerto por defecto.
RewardMessages: Una lista de mensajes que se envían al jugador que votó por tu servidor.
RewardBroadcasts: Una lista de mensajes que se transmiten a todos una vez que se recibe un voto.
RewardCommands: Una lista de comandos que se ejecutan cuando un jugador vota.
Tokens: Los tokens para el protocolo votifier v2.

✨ Notificaciones

Ejemplo de notification.json:

{
"Enabled": true,
"TitleMessage": "¡Voto Recibido!",
"TitleColor": "#e2b0ff",
"DescriptionMessage": "¡Gracias por tu voto en %from%!",
"DescriptionColor": "#9f44d3",
"IconItem": "Ingredient_Voidheart"
}

Enabled: Te permite activar o desactivar esta función.
TitleMessage: El mensaje principal para la notificación que se muestra en la parte superior.
TitleColor: Un color hexadecimal para el título.
DescriptionMessage: El mensaje secundario para la notificación que se muestra en la parte inferior.
DescriptionColor: El color para la descripción.
IconItem: El nombre del ítem que se renderiza a la izquierda de la notificación. ¡Puede ser cualquier ítem de Hytale que esté disponible en tu servidor!

✨ Recordatorios de Voto

Ejemplo de voteReminder.json:

{
"Enabled": true,
"SendOnJoin": true,
"ExpireAfterHours": 24,
"DelayInMinutes": 5,
"Message": "[!] ¡No has votado hoy! ¡Hazlo con '/vote' para recibir recompensas gratis!",
"MessageColor": "#e2b0ff"
}

Enabled: Te permite activar o desactivar esta función.
SendOnJoin: Envía el recordatorio inmediatamente después de que un jugador haya aparecido en el servidor si aún no ha votado.
ExpireAfterHours: Cuánto tiempo debe permanecer válido un voto. Si este tiempo expira, el jugador comenzará a recibir recordatorios nuevamente.
DelayInMinutes: Con qué frecuencia se debe enviar el mensaje de recordatorio.
Message: El mensaje para el recordatorio.
MessageColor: Un código de color hexadecimal para el mensaje.

✨ Sonidos

Ejemplo de sound.json:

{
"Enabled": true,
"SoundName": "SFX_Portal_Neutral_Open",
"SoundCategory": "UI"
}

Enabled: Te permite activar o desactivar esta función.
SoundName: El sonido que deseas reproducir para el usuario después de que voten.
SoundCategory: La categoría para el sonido. No estoy seguro de cómo se utiliza exactamente, así que lo añadí como una opción configurable. Déjalo en UI para usar todos los sonidos predeterminados de Hytale.

✨ GUI de Voto

Ejemplo de voteCommand.json:

{
"Enabled": true,
"VoteLinks": {
"HytaleServerList.me": "https://hytaleserverlist.me/download-votifier-for-hytale",
"Otra Página": "https://example.com"
}
}

Enabled: Te permite activar o desactivar esta función.
VoteLinks: Los enlaces que tus usuarios pueden visitar para votar por tu servidor.

✨ Comandos

/testvote <player>
Permiso: votifier.test
Descripción: Ejecuta un voto simulado para el jugador especificado. ¡Bueno para probar tu configuración!

/vote
Permiso: hsl.votifier.command.vote
Descripción: Abre una GUI de voto para el jugador que le permite copiar enlaces de voto fácilmente!

✨ Para Desarrolladores

Todo lo que sigue está destinado a desarrolladores que deseen integrar la votación en sus propios mods o en un sitio web de votación como HytaleServerList.me.

🎗️ Evento Personalizado

HyVotifier activa el PlayerVoteEvent cuando se registra un voto, al que puedes suscribirte en tus propios mods.

me.hytaleserverlist.mods.hytalevotifier.event.PlayerVoteEvent

Agrega nuestro plugin como una dependencia para tu proyecto y suscríbete al evento de esta manera:

getEventRegistry().registerGlobal(PlayerVoteEvent.class, (playerVoteEvent) -> {
    // Haz algo aquí
});

playerVoteEvent.getWorld() – Para obtener el mundo del jugador
playerVoteEvent.getPlayerRef() – Para obtener el objeto PlayerRef
playerVoteEvent.getVote() – Para obtener el objeto Vote

📩 Envío de Votos

Este mod te permite enviar votos a servidores de Hytale utilizando tanto los protocolos Votifier V1 como Votifier V2.
Soporta todas las mismas características conocidas que el popular plugin NuVotifier.

Paquetes de Envío de Votos NodeJS

• Protocolo V1: https://www.npmjs.com/package/votifier-send
• Protocolo V2: https://www.npmjs.com/package/votifier2

🔐 Seguridad y Cómo Funciona

Ambos protocolos de voto son seguros y seguros de usar, pero funcionan de manera ligeramente diferente:

V1 (Cifrado RSA)

• Los datos de tu voto se cifran utilizando la clave pública RSA del servidor
• El servidor luego descifra y valida el voto utilizando su clave privada
  
• Los propietarios del servidor proporcionan su clave pública RSA al sitio web de votación

V2 (Token + Cifrado)

V2 añade una capa extra de seguridad:

• Los votos deben incluir un token
• Cada sitio de votación tiene su propio token único
• Los propietarios del servidor pueden usar tokens para rastrear de dónde provienen los votos si alguna vez ocurre una filtración de datos
• El propietario del servidor debe configurar el token y proporcionarlo al sitio web de votación (o tu configuración web)

✨ Créditos

Para una documentación detallada visita: https://hytaleserverlist.me/download-votifier-for-hytale

Consulta NuVotifier para Minecraft: https://github.com/NuVotifier/NuVotifier

Se establecerá un repositorio público para contribuciones públicas en los próximos días. ¡Disfruta! ❤️