Qu'est-ce que HyVotifier ?
HyVotifier permet à votre serveur Hytale de recevoir les votes des sites de listes de serveurs, pour récompenser les joueurs et suivre qui vote.
Les sites de listes de serveurs amènent des joueurs sur votre serveur. Quand les gens votent pour vous, vous montez dans le classement et plus de joueurs vous trouvent. Mais ces votes ne servent pas à grand-chose si vous ne pouvez rien en faire. C'est là qu'HyVotifier intervient. Il permet à votre serveur de recevoir ces votes directement, pour que vous puissiez donner des récompenses aux joueurs quand ils votent et suivre vos statistiques de vote.
Ce que vous obtenez
- Montez dans le classement et attirez plus de joueurs sur votre serveur
- Offrez des récompenses aux joueurs quand ils votent — objets, avantages, ce que vous voulez
- Voyez qui vote et à quelle fréquence
- Intégrez les récompenses de vote dans l'économie de votre serveur
Télécharger HyVotifier
Récupérez la dernière version sur CurseForge. C'est totalement gratuit. Une fois téléchargé, suivez les étapes d'installation et c'est parti.
Détails techniques
Compatible avec le dernier Java et supporte tous les protocoles de vote standards.
Java 25+
Nécessite Java 25 ou plus récent.
Protocole standard
Écoute les votes V1 et V2 via TCP. S'intègre parfaitement à votre serveur.
Support API
Connectez-vous aux événements de vote et personnalisez le comportement.
Communication chiffrée
Génère une paire de clés RSA pour une communication sécurisée.
Configurable
Configurez les commandes et messages pour récompenser vos joueurs.
Configuration réseau
Votre serveur Hytale fonctionne sur QUIC (port UDP 5520 par défaut), mais Votifier est totalement séparé. Il utilise son propre port TCP pour écouter les paquets de vote. Deux choses différentes, deux ports différents.
| Service | Protocole | Port par défaut |
|---|---|---|
| Serveur de jeu Hytale | UDP (QUIC) |
5520 |
| Votifier | TCP |
8192 |
Configuration du pare-feu
Vous devez ouvrir ces deux ports dans votre pare-feu :
UDP 5520— Pour la connexion des joueurs à votre serveurTCP 8192— Pour les paquets de vote (vous pouvez changer ce port si vous voulez)
Des problèmes ? Si les votes n'apparaissent pas, c'est généralement parce que votre pare-feu bloque le trafic TCP sur le port Votifier. La plupart des hébergeurs ont déjà ces ports ouverts, mais si ce n'est pas le cas, envoyez-leur un message et ils régleront ça.
Installation
- Déposez le fichier .jar dans le dossier mods/ de votre serveur
- Démarrez votre serveur
- Tapez /plugin load HSL:Votifier dans la console du serveur
Tester votre configuration
Vous pouvez tester votre configuration de vote sans attendre un vrai vote. Utilisez la commande /testvote pour simuler un vote et vérifier que vos récompenses, messages et diffusions fonctionnent correctement.
Crée un vote test simulé pour un joueur de votre choix et envoie tous les messages et donne les récompenses.
Permission: votifier.test
Placeholders
Vous pouvez utiliser des placeholders dans votre configuration pour personnaliser les messages et commandes :
%player%
— Nom du joueur
Disponible dans : RewardCommands, RewardMessages, RewardBroadcasts
%from%
— Nom du service de vote
Disponible dans : RewardMessages, RewardBroadcasts
Fichier de configuration
Après le chargement du plugin, il créera automatiquement un fichier config.json par défaut. Voici à quoi il ressemble :
{
"BindHost": "0.0.0.0",
"BindPort": 8192,
"DisableV1Protocol": false,
"RewardCommands": [
"gm adventure %player%"
],
"RewardMessages": [
"Thanks for your vote on %from%. Enjoy your rewards!"
],
"RewardBroadcasts": [
"Player %player% has voted for our server!"
],
"Tokens": {
"ExampleService": "exampleSecret"
}
}
Astuce: Après avoir modifié config.json, vous pouvez recharger la configuration sans redémarrer votre serveur en exécutant /plugin reload HSL:Votifier dans la console.
Tokens du protocole Votifier V2
La section Tokens vous permet de configurer des secrets pour le protocole Votifier V2. Chaque service de vote peut avoir son propre token secret pour une authentification sécurisée.
"Tokens": { "MyServerList": "mySecret123" }
Paire de clés RSA
Le plugin génère automatiquement une paire de clés RSA publique et privée dans le répertoire rsa/. Ces clés sont utilisées pour la communication sécurisée avec les services de vote et empêchent la falsification des données de vote.
Partagez votre clé publique (dans rsa/public.key) avec les sites de listes de serveurs qui la requièrent pour l'intégration du protocole Votifier V1.
Télécharger HyVotifier
Récupérez la dernière version sur CurseForge. C'est totalement gratuit. Une fois téléchargé, suivez les étapes d'installation et c'est parti.