Plugin Votifier per Hytale

Plugin di voto moderno per server Hytale sviluppato da Top-Games. Ricompensa automaticamente i tuoi giocatori quando votano con un sistema di livelli configurabile.

Scarica SimpleVotifier Codice sorgente

Compatibile Hytale

Auth HMAC-SHA256

10 lingue

Ricompense integrate

Requisiti

Importante: Questa configurazione richiede un server Hytale con il plugin WebServer installato.

Server Hytale funzionante
Java 25 o superiore
Plugin WebServer installato (plugin consigliato da Hytale)
Accesso ai file di configurazione del server

Installazione di SimpleVotifier

Scarica SimpleVotifier

Scarica l'ultima versione del plugin da Modtale.

Scarica su Modtale

Installa il plugin

Copia il file SimpleVotifier.jar nella cartella mods/ del tuo server Hytale.

mods/SimpleVotifier.jar

Verifica WebServer

Assicurati che il plugin WebServer (plugin consigliato da Hytale) sia installato e funzionante.

Avvia il server

Avvia il tuo server Hytale per far generare automaticamente la configurazione a SimpleVotifier.

Configura il plugin

Modifica il file di configurazione generato secondo le tue esigenze (vedi sezione Configurazione).

Configurazione

Dopo il primo avvio, SimpleVotifier crea automaticamente il file di configurazione mods/SimpleVotifier/config.json.

Configurazione predefinita

mods/SimpleVotifier/config.json

{
  "language": "it",
  "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"
    }
  ]
}

Opzioni di configurazione

Opzione	Tipo	Descrizione
`language`	string	Codice lingua (en, fr, es, de, it, pt, ru, uk, zh, ja)
`token`	string	Token sicuro per autenticazione HMAC (generato automaticamente)
`allowedIps`	array	Whitelist IP (vuoto = consenti tutti)
`logVotes`	boolean	Registra i voti nella console
`broadcastVotes`	boolean	Annuncia i voti a tutti i giocatori

Token sicuro: Il token viene generato automaticamente. Copialo nel tuo pannello Top-Games per attivare la connessione.

Configurazione Top-Games

Ottieni il tuo token

SimpleVotifier genera automaticamente un token che devi recuperare dal file di configurazione.

                                        Posizione del file:
                                        mods/SimpleVotifier/config.json
                                    

Configura in Top-Games

Vai al tuo pannello Top-Games, sezione "Votifier" del tuo server Hytale.

Attiva "SimpleVotifier"
Inserisci l'IP del tuo server
Porta: per default, la porta del tuo server + 3 (esempio: 5523)
Inserisci il tuo token da config.json

Testa la connessione

Usa il pulsante "Testa" nel tuo pannello Top-Games per verificare che la comunicazione funzioni correttamente.

Sistema di ricompense (opzionale)

SimpleVotifier include un sistema di ricompense integrato con comandi per ogni voto e ricompense a livelli.

Configurazione ricompense

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 disponibile: Usa {player} nei tuoi comandi - verrà sostituito con il nome del giocatore.

Comandi giocatore

Comando	Descrizione
`/rewards`	Riscatta le ricompense di voto in sospeso
`/vote`	Elenca i siti di voto configurati
`/voteinfo`	Visualizza le tue statistiche di voto e il progresso dei livelli

API per sviluppatori

I plugin di terze parti possono ascoltare gli eventi di voto tramite l'EventBus di 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: Quando il modulo VoteRewards è attivato, gestisce automaticamente le ricompense. Disattivalo (rewards.enabled: false) se vuoi il controllo completo tramite il tuo plugin di ricompense.

Classifica (opzionale)

SimpleVotifier include un endpoint classifica per mostrare i migliori votanti del tuo server.

Configurazione classifica

config.json (leaderboard section)

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

Opzioni classifica

Opzione	Tipo	Descrizione
`enabled`	boolean	Attiva/disattiva l'endpoint classifica (disattivato per default)
`format`	string	Formato di output predefinito: "html" o "json" (html per default)
`showVoteSites`	boolean	Mostra/nascondi la sezione siti di voto nella classifica

Endpoint classifica

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

Risoluzione problemi

Verifica che il plugin WebServer sia installato
Controlla i log del server per messaggi di errore

Verifica che la firma HMAC sia generata correttamente
Controlla la configurazione allowedIps
Rivedi i log del server per messaggi di errore

Assicurati che rewards.enabled sia true
Verifica la sintassi dei comandi nella configurazione
Verifica che il giocatore sia online o usa /rewards per riscattare

Conferma che monthlyReset sia attivato
Controlla il file last_reset.txt per la data dell'ultimo reset
Il reset si attiva al primo voto del nuovo mese

Informazioni

Tipo: Plugin Hytale

Compatibilità: Server Hytale

Java: Java 25+

Protocollo: HMAC-SHA256 + HTTP

Lingue: 10 lingue supportate

Funzionalità

Autenticazione HMAC-SHA256 sicura
Sistema di ricompense integrato
Supporto per 10 lingue
Annunci di voto a tutti i giocatori
Reset mensili dei voti
API basata su eventi per plugin di terze parti
Endpoint classifica (HTML/JSON)

Riepilogo configurazione

Installa il plugin WebServer
Installa SimpleVotifier
Configura config.json
Configura in Top-Games
Testa la connessione
Configura le ricompense
Configura la classifica

Supporto

Hai bisogno di aiuto per configurare SimpleVotifier? Il nostro team è qui per assisterti.

Contattaci Segnala un bug

Scopri i server Hytale

Esplora la nostra classifica dei migliori server Hytale e unisciti alla community!

Visualizza server Hytale