Plugin Votifier pour Hytale

Plugin de vote moderne pour serveurs Hytale développé par Top-Serveurs. Récompensez automatiquement vos joueurs lorsqu'ils votent avec un système de paliers configurable.

Télécharger SimpleVotifier Code source

Compatible Hytale

Auth HMAC-SHA256

10 langues

Récompenses intégrées

Prérequis

Important: Cette configuration nécessite un serveur Hytale avec le plugin WebServer installé.

Serveur Hytale fonctionnel
Java 25 ou supérieur
Plugin WebServer installé (plugin recommandé par Hytale)
Accès aux fichiers de configuration du serveur

Installation de SimpleVotifier

Télécharger SimpleVotifier

Téléchargez la dernière version du plugin depuis Modtale.

Télécharger sur Modtale

Installer le plugin

Copiez le fichier SimpleVotifier.jar dans le dossier mods/ de votre serveur Hytale.

mods/SimpleVotifier.jar

Vérifier WebServer

Assurez-vous que le plugin WebServer (plugin recommandé par Hytale) est installé et fonctionnel.

Démarrer le serveur

Démarrez votre serveur Hytale pour que SimpleVotifier génère automatiquement sa configuration.

Configurer le plugin

Modifiez le fichier de configuration généré selon vos besoins (voir section Configuration).

Configuration

Après le premier démarrage, SimpleVotifier crée automatiquement le fichier de configuration mods/SimpleVotifier/config.json.

Configuration par défaut

mods/SimpleVotifier/config.json

{
  "language": "fr",
  "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-Serveurs",
      "url": "https://top-serveurs.net/hytale/my-server"
    }
  ]
}

Options de configuration

Option	Type	Description
`language`	string	Code de langue (en, fr, es, de, it, pt, ru, uk, zh, ja)
`token`	string	Token sécurisé pour l'authentification HMAC (auto-généré)
`allowedIps`	array	Liste blanche d'IPs (vide = autoriser toutes)
`logVotes`	boolean	Afficher les votes dans la console
`broadcastVotes`	boolean	Annoncer les votes à tous les joueurs

Token sécurisé: Le token est généré automatiquement. Copiez-le dans votre panel Top-Serveurs pour activer la connexion.

Configuration Top-Serveurs

Récupérer votre token

SimpleVotifier génère automatiquement un token que vous devez récupérer depuis le fichier de configuration.

                                        Emplacement du fichier:
                                        mods/SimpleVotifier/config.json
                                    

Configurer dans Top-Serveurs

Rendez-vous dans votre panel Top-Serveurs, section "Votifier" de votre serveur Hytale.

Activez "SimpleVotifier"
Entrez l'IP de votre serveur
Port : par défaut, le port de votre serveur + 3 (exemple : 5523)
Entrez votre token depuis config.json

Tester la connexion

Utilisez le bouton "Tester" dans votre panel Top-Serveurs pour vérifier que la communication fonctionne correctement.

Système de récompenses (optionnel)

SimpleVotifier inclut un système de récompenses intégré avec commandes à chaque vote et paliers de récompenses.

Configuration des récompenses

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: Utilisez {player} dans vos commandes - il sera remplacé par le nom du joueur.

Commandes joueur

Commande	Description
`/rewards`	Récupérer les récompenses en attente
`/vote`	Afficher les liens de vote configurés
`/voteinfo`	Voir ses statistiques de vote et sa progression

API pour développeurs

Les plugins tiers peuvent écouter les événements de vote via l'EventBus 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
    }
}

Note: Si le module VoteRewards est activé, il gère automatiquement les récompenses. Désactivez-le (rewards.enabled: false) si vous voulez un contrôle total via votre propre plugin.

Classement (optionnel)

SimpleVotifier inclut un endpoint de classement pour afficher les meilleurs voteurs de votre serveur.

Configuration du classement

config.json (leaderboard section)

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

Options du classement

Option	Type	Description
`enabled`	boolean	Activer/désactiver l'endpoint du classement (désactivé par défaut)
`format`	string	Format de sortie par défaut : "html" ou "json" (html par défaut)
`showVoteSites`	boolean	Afficher/masquer la section des sites de vote sur le classement

Endpoint du classement

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

Dépannage

Vérifiez que le plugin WebServer est installé
Consultez les logs du serveur pour les messages d'erreur

Vérifiez que la signature HMAC est correctement générée
Vérifiez la configuration allowedIps
Consultez les logs du serveur pour les messages d'erreur

Assurez-vous que rewards.enabled est à true
Vérifiez la syntaxe des commandes dans la configuration
Vérifiez que le joueur est en ligne ou utilisez /rewards pour récupérer

Confirmez que monthlyReset est activé
Vérifiez le fichier last_reset.txt pour la date de dernière remise à zéro
La remise à zéro se déclenche au premier vote du nouveau mois

Informations

Type : Plugin Hytale

Compatibilité : Hytale Server

Java : Java 25+

Protocole : HMAC-SHA256 + HTTP

Langues : 10 langues supportées

Fonctionnalités

Authentification HMAC-SHA256 sécurisée
Système de récompenses intégré
Support de 10 langues
Annonces de votes aux joueurs
Remise à zéro mensuelle des votes
API événementielle pour plugins tiers
Endpoint classement (HTML/JSON)

Résumé configuration

Installer le plugin WebServer
Installer SimpleVotifier
Configurer config.json
Configurer dans Top-Serveurs
Tester la connexion
Configurer les récompenses
Configurer le classement

Support

Besoin d'aide pour configurer SimpleVotifier ? Notre équipe est là pour vous accompagner.

Nous contacter Signaler un bug

Découvrez les serveurs Hytale

Explorez notre classement des meilleurs serveurs Hytale français et rejoignez la communauté !

Voir les serveurs Hytale