Plugin Votifier para Hytale

Plugin de votación moderno para servidores Hytale desarrollado por Top-Games. Recompensa automáticamente a tus jugadores cuando votan con un sistema de niveles configurable.

Descargar SimpleVotifier Código fuente

Compatible con Hytale

Auth HMAC-SHA256

10 idiomas

Recompensas integradas

Requisitos

Importante: Esta configuración requiere un servidor Hytale con el plugin WebServer instalado.

Servidor Hytale funcional
Java 25 o superior
Plugin WebServer instalado (plugin recomendado por Hytale)
Acceso a los archivos de configuración del servidor

Instalación de SimpleVotifier

Descargar SimpleVotifier

Descarga la última versión del plugin desde Modtale.

Descargar en Modtale

Instalar el plugin

Copia el archivo SimpleVotifier.jar en la carpeta mods/ de tu servidor Hytale.

mods/SimpleVotifier.jar

Verificar WebServer

Asegúrate de que el plugin WebServer (plugin recomendado por Hytale) esté instalado y funcionando.

Iniciar el servidor

Inicia tu servidor Hytale para que SimpleVotifier genere automáticamente su configuración.

Configurar el plugin

Edita el archivo de configuración generado según tus necesidades (ver sección Configuración).

Configuración

Después del primer inicio, SimpleVotifier crea automáticamente el archivo de configuración mods/SimpleVotifier/config.json.

Configuración por defecto

mods/SimpleVotifier/config.json

{
  "language": "es",
  "token": "AbCdEfGh123456789XyZ0123",
  "allowedIps": [],
  "logVotes": true,
  "broadcastVotes": true,
  "rewards": {
    "enabled": false,
    "monthlyReset": true,
    "everyVoteCommands": [
      "give {player} Plant_Crop_Carrot_Item"
    ],
    "tiers": [
      {
        "votesRequired": 10,
        "commands": ["give {player} Container_Bucket"]
      },
      {
        "votesRequired": 50,
        "commands": ["give {player} Armor_Iron_Head"]
      },
      {
        "votesRequired": 100,
        "commands": ["give {player} Rock_Gem_Diamond"]
      }
    ]
  },
  "leaderboard": {
    "enabled": true,
    "format": "html",
    "showVoteSites": true
  },
  "voteSites": [
    {
      "service": "Top-Games",
      "url": "https://top-games.net/hytale/my-server"
    }
  ]
}

Opciones de configuración

Opción	Tipo	Descripción
`language`	string	Código de idioma (en, fr, es, de, it, pt, ru, uk, zh, ja)
`token`	string	Token seguro para autenticación HMAC (generado automáticamente)
`allowedIps`	array	Lista blanca de IPs (vacío = permitir todas)
`logVotes`	boolean	Registrar votos en la consola
`broadcastVotes`	boolean	Anunciar votos a todos los jugadores

Token seguro: El token se genera automáticamente. Cópialo en tu panel de Top-Games para activar la conexión.

Configuración de Top-Games

Obtener tu token

SimpleVotifier genera automáticamente un token que debes recuperar del archivo de configuración.

                                        Ubicación del archivo:
                                        mods/SimpleVotifier/config.json
                                    

Configurar en Top-Games

Ve a tu panel de Top-Games, sección "Votifier" de tu servidor Hytale.

Activar "SimpleVotifier"
Introduce la IP de tu servidor
Puerto: por defecto, el puerto de tu servidor + 3 (ejemplo: 5523)
Introduce tu token desde config.json

Probar la conexión

Usa el botón "Probar" en tu panel de Top-Games para verificar que la comunicación funciona correctamente.

Sistema de recompensas (opcional)

SimpleVotifier incluye un sistema de recompensas integrado con comandos para cada voto y recompensas por niveles.

Configuración de recompensas

config.json (rewards section)

{
  "rewards": {
    "enabled": true,
    "monthlyReset": true,
    "everyVoteCommands": ["give {player} Plant_Crop_Carrot_Item"],
    "tiers": [
      {
        "votesRequired": 10,
        "commands": ["give {player} Container_Bucket"]
      },
      {
        "votesRequired": 50,
        "commands": ["give {player} Armor_Iron_Head"]
      },
      {
        "votesRequired": 100,
        "commands": ["give {player} Rock_Gem_Diamond"]
      }
    ]
  }
}

Placeholder disponible: Usa {player} en tus comandos - será reemplazado por el nombre del jugador.

Comandos de jugador

Comando	Descripción
`/rewards`	Reclamar recompensas de votos pendientes
`/vote`	Listar sitios de votación configurados
`/voteinfo`	Ver tus estadísticas de votos y progreso de niveles

API para desarrolladores

Los plugins de terceros pueden escuchar eventos de votación a través del EventBus de Hytale.

MyPlugin.java

import com.hypixel.hytale.server.core.HytaleServer;
import net.top_games.hytale.plugins.simplevotifier.VoteEvent;

public class MyPlugin extends JavaPlugin {

    @Override
    protected void setup() {
        HytaleServer.get().getEventBus()
            .listenFor(VoteEvent.class, null)
            .listen(this::onVote);
    }

    private void onVote(VoteEvent event) {
        String username = event.getUsername();
        String service = event.getServiceName();

        getLogger().atInfo().log(username + " voted on " + service);
        // Add your custom logic here
    }
}

Nota: Cuando el módulo VoteRewards está activado, gestiona automáticamente las recompensas. Desactívalo (rewards.enabled: false) si quieres control total a través de tu propio plugin de recompensas.

Clasificación (opcional)

SimpleVotifier incluye un endpoint de clasificación para mostrar los mejores votantes de tu servidor.

Configuración de clasificación

config.json (leaderboard section)

{
  "leaderboard": {
    "enabled": true,
    "format": "html",
    "showVoteSites": true
  }
}

Opciones de clasificación

Opción	Tipo	Descripción
`enabled`	boolean	Activar/desactivar el endpoint de clasificación (desactivado por defecto)
`format`	string	Formato de salida por defecto: "html" o "json" (html por defecto)
`showVoteSites`	boolean	Mostrar/ocultar la sección de sitios de votación en la clasificación

Endpoint de clasificación

GET https://your-server:port/Top-Games/SimpleVotifier/leaderboard

Solución de problemas

Verifica que el plugin WebServer esté instalado
Revisa los logs del servidor en busca de mensajes de error

Verifica que la firma HMAC se genere correctamente
Revisa la configuración de allowedIps
Revisa los logs del servidor en busca de mensajes de error

Asegúrate de que rewards.enabled esté en true
Verifica la sintaxis de los comandos en la configuración
Verifica que el jugador esté en línea o usa /rewards para reclamar

Confirma que monthlyReset esté activado
Revisa el archivo last_reset.txt para la fecha del último reinicio
El reinicio se activa en el primer voto del nuevo mes

Información

Tipo: Plugin Hytale

Compatibilidad: Servidor Hytale

Java: Java 25+

Protocolo: HMAC-SHA256 + HTTP

Idiomas: 10 idiomas soportados

Características

Autenticación HMAC-SHA256 segura
Sistema de recompensas integrado
Soporte para 10 idiomas
Anuncios de votos a todos los jugadores
Reinicios mensuales de votos
API basada en eventos para plugins de terceros
Endpoint de clasificación (HTML/JSON)

Resumen de configuración

Instalar plugin WebServer
Instalar SimpleVotifier
Configurar config.json
Configurar en Top-Games
Probar la conexión
Configurar recompensas
Configurar clasificación

Soporte

¿Necesitas ayuda para configurar SimpleVotifier? Nuestro equipo está aquí para ayudarte.

Contáctanos Reportar un bug

Descubre servidores de Hytale

Explora nuestro ranking de los mejores servidores de Hytale y únete a la comunidad!

Ver servidores de Hytale