Classements
Recherche
Recherche avancée Ctrl + K pour ouvrir la recherche

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.

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

1
Télécharger SimpleVotifier

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

Télécharger sur Modtale
2
Installer le plugin

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

mods/SimpleVotifier.jar
3
Vérifier WebServer

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

4
Démarrer le serveur

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

5
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

1
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
2
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
3
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
  1. Installer le plugin WebServer
  2. Installer SimpleVotifier
  3. Configurer config.json
  4. Configurer dans Top-Serveurs
  5. Tester la connexion
  6. Configurer les récompenses
  7. Configurer le classement
Support

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