Guide de Configuration HyVotifier

Récompensez les joueurs qui votent pour votre serveur et augmentez votre visibilité sur les listes de serveurs.

Comment Fonctionnent les Récompenses de Vote

Lorsque les joueurs votent pour votre serveur sur notre site, nous envoyons une notification à votre serveur. HyVotifier reçoit le vote et récompense automatiquement le joueur.

Voter

Le joueur vote sur notre site

→
Notifier

Nous envoyons le vote à votre serveur

→
Récompenser

Le joueur reçoit sa récompense

Fonctionnalités HyVotifier

  • Commandes de récompense personnalisées
  • Messages de chat et diffusions
  • Notifications à l'écran
  • Sons personnalisés
  • Rappels de vote quotidiens
  • Interface de vote personnalisée avec /vote
  • Transfert de votes pour les réseaux
  • Votes de test pour vérification

Étape 1 : Installer HyVotifier

1

Télécharger HyVotifier

Téléchargez HyVotifier depuis CurseForge :

Télécharger depuis CurseForge
2

Installer le Mod

Placez le fichier .jar ou .zip téléchargé dans le dossier mods/ de votre serveur et redémarrez le serveur.

Étape 2 : Configurer HyVotifier

Après le premier démarrage, HyVotifier crée des fichiers de configuration dans mods/HSL_Votifier/

Configuration Principale (config.json)

{
  "BindHost": "0.0.0.0",
  "BindPort": 8192,
  "DisableV1Protocol": false,
  "DebugMode": false,
  "Tokens": {
    "HytaleTopServers": "your-secure-token-here"
  },
  "RewardCommands": [
    "give %player% diamond 1"
  ],
  "RewardMessages": [
    "<gray>Thanks for your vote on <gold>%from%</gold>. <green>Enjoy your rewards!</green>"
  ],
  "BroadcastWhenOffline": false,
  "RewardBroadcasts": [
    "<gray>Player <gold>%player%</gold> has voted for our server!</gray>"
  ]
}
BindHost- IP à écouter (0.0.0.0 pour toutes)
BindPort- Port pour les connexions de vote (par défaut : 8192)
Tokens- Tokens du protocole V2 (nom du service → token)
RewardCommands- Commandes à exécuter quand le joueur vote
RewardMessages- Messages envoyés au votant
RewardBroadcasts- Messages diffusés à tous les joueurs

Variables disponibles : %player% (voter username), %from% (voting site name)

Protocoles Votifier

Recommandé

Protocole V2 (Token/HMAC)

Protocole moderne utilisant des tokens partagés pour l'authentification.

"Tokens": {
  "SiteName": "your-token"
}

Ajoutez le token fourni par le site de vote à votre configuration.

Protocole V1 (RSA)

Protocole hérité utilisant le chiffrement par clé publique RSA.

Fournissez le contenu de votre fichier de clé publique au site de vote :

mods/HSL_Votifier/rsa/public.key

Étape 3 : Ouvrir le Port Votifier

Important: Votifier utilise TCP (pas UDP comme le serveur de jeu). Ouvrez le port TCP 8192 dans votre pare-feu.

Linux (ufw)

sudo ufw allow 8192/tcp

Linux (iptables)

sudo iptables -A INPUT -p tcp --dport 8192 -j ACCEPT

Vérifier que le Port est Ouvert

Utilisez un vérificateur de port comme ping.eu/port-chk pour vérifier que votre port Votifier est accessible.

Si le port apparaît comme "fermé", les sites de vote ne peuvent pas envoyer de votes à votre serveur.

Fonctionnalités Optionnelles

Notifications à l'Écran (notification.json)

Affichez une notification visuelle quand les joueurs votent :

{
  "Enabled": true,
  "TitleMessage": "<#e2b0ff>Vote Received!</#e2b0ff>",
  "DescriptionMessage": "<gray>Thanks for voting on <#9f44d3>%from%</#9f44d3>!</gray>",
  "IconItem": "Ingredient_Voidheart"
}

Rappels de Vote (voteReminder.json)

Rappelez aux joueurs de voter s'ils ne l'ont pas fait récemment :

{
  "Enabled": true,
  "SendOnJoin": true,
  "ExpireAfterHours": 24,
  "DelayInMinutes": 1,
  "Message": "<red><b>Heads Up!</b></red> <gray>You haven't voted today! Use <green>/vote</green> for free rewards!</gray>"
}

Formatage des Couleurs

HyVotifier supporte les balises de couleur style MiniMessage :

<gray>, <gold>, <green>, <red>, <yellow>, <blue>, <aqua>, <white>

<gradient:red:yellow:green:blue:purple>Rainbow!</gradient>

Commandes

CommandePermissionDescription
/voteAucuneOuvre l'interface de vote avec des liens cliquables
/testvote <player>votifier.testEnvoie un vote de test pour vérifier la configuration

Étape 4 : Configurer sur Hytale Top Servers

  1. 1Allez dans votre tableau de bord serveur
  2. 2Cliquez sur Modifier le Serveur
  3. 3Faites défiler jusqu'à Intégration Votifier
  4. 4Activez Votifier et sélectionnez votre version de protocole
  5. 5Entrez votre port Votifier (par défaut : 8192)
  6. 6Pour V2 : Entrez votre token | Pour V1 : Collez votre clé publique
  7. 7Utilisez Tester la Connexion pour vérifier
  8. 8Enregistrez vos paramètres

Dépannage

Votes Non Reçus

  • Vérifiez que le port TCP 8192 est ouvert dans votre pare-feu
  • Utilisez ping.eu/port-chk pour vérifier que le port est accessible
  • Vérifiez que HyVotifier s'est chargé correctement dans les logs du serveur
  • Revérifiez vos paramètres d'adresse et de port sur notre site

Échec du Test de Connexion

  • Pour V2 : Vérifiez que le token correspond exactement (sensible à la casse)
  • Pour V1 : Assurez-vous d'avoir copié tout le contenu de la clé publique
  • Assurez-vous que votre serveur fonctionne lors du test
  • Essayez d'utiliser votre adresse IP au lieu du nom de domaine

Erreurs de Format de Configuration

Les configurations HyVotifier sont des fichiers JSON. Utilisez JSONLint pour vérifier les erreurs de format si le mod ne charge pas correctement.

Utiliser les Votes de Test

Exécutez /testvote VotreNom dans la console du serveur pour simuler un vote et vérifier que vos récompenses fonctionnent correctement.

Serveurs Utilisant Votifier

Découvrez ces serveurs qui récompensent les joueurs pour voter.