Guide de Configuration des Récompenses de Vote

Apprenez à configurer les récompenses en jeu pour les joueurs qui votent pour votre serveur sur Hylist.

Qu'est-ce que Votifier2 ?

Votifier2 est un protocole qui permet aux sites de liste de serveurs comme Hylist d'envoyer des notifications de vote directement à votre serveur de jeu. Lorsqu'un joueur vote pour votre serveur, Hylist envoie un message sécurisé à votre serveur, qui peut ensuite récompenser le joueur automatiquement.

Prérequis

  • Un plugin compatible Votifier2 installé sur votre serveur
  • Un port ouvert pour l'écouteur Votifier (par défaut: 8192)
  • Un plugin de récompenses pour donner des objets/avantages aux votants (optionnel mais recommandé)

Étape 1 : Installer un Plugin Votifier2

Tout d'abord, vous devez installer un plugin compatible Votifier2 sur votre serveur Hytale. Nous recommandons :

Télécharger Hytale Votifier

Suivez les instructions d'installation du plugin pour l'ajouter à votre serveur.

Étape 2 : Activer les Récompenses en Jeu dans Hylist

Activez les récompenses en jeu dans votre tableau de bord Hylist pour obtenir votre jeton Votifier.

  1. Accédez à la page d'édition de votre serveur dans le tableau de bord Hylist
  2. Activez "Activer les récompenses en jeu"
  3. Définissez le port Votifier (par défaut: 8192)
  4. Enregistrez vos modifications
  5. Copiez votre jeton Votifier pour l'étape suivante

Étape 3 : Configurer le Plugin

Collez le jeton Votifier de Hylist dans le fichier de configuration de votre plugin.

Exemple de configuration (config.json) :

{
  "BindHost": "0.0.0.0",
  "BindPort": 8192,
  "DisableV1Protocol": false,
  "RewardCommands": [
    "gm adventure %player%"
  ],
  "RewardMessages": [
    "<gray>Thanks for your vote on <gold>%from%</gold>!"
  ],
  "Tokens": {
    "Hylist.io": "<YOUR_TOKEN_FROM_HYLIST>"
  }
}

Optionnel : Configuration de la commande de vote (voteCommand.json) :

{
  "Enabled": true,
  "OpenCustomGui": true,
  "SendChatMessage": true,
  "ChatMessageHeader": [
    "<gold><b>Vote for our server!</b></gold>"
  ],
  "ChatMessageTemplate": "<yellow><click:%link%>%name% (Click)</click></yellow>",
  "VoteLinks": {
    "Hylist.io": "https://hylist.io/vote/<YOUR_SERVER_SLUG>"
  }
}

Remplacez <YOUR_SERVER_SLUG> par le slug de votre serveur (ex: "mon-super-serveur"). Vous pouvez le trouver dans l'URL de votre serveur sur Hylist.

Astuce : Pré-remplir le pseudo pour une meilleure expérience

Vous pouvez ajouter ?username=NomDuJoueur à l'URL de vote pour remplir automatiquement le pseudo du joueur :

https://hylist.io/vote/your-server?username=PlayerName

Note : Cela nécessite un support de plugin personnalisé car la plupart des plugins ne le supportent pas par défaut.

Étape 4 : Ouvrir le Port

Assurez-vous que le port Votifier est ouvert et accessible depuis Internet.

Assurez-vous que le port est ouvert dans le pare-feu de votre serveur. Si vous utilisez un hébergeur, vous devrez peut-être configurer la redirection de port.

Tester Votre Configuration

Pour vérifier que tout fonctionne :

  1. Assurez-vous que votre serveur est en ligne et que le plugin Votifier fonctionne
  2. Votez pour votre serveur sur Hylist et entrez votre nom d'utilisateur en jeu
  3. Vérifiez la console de votre serveur pour les notifications de vote
  4. Vérifiez que vous recevez les récompenses configurées en jeu

Conseils de Sécurité

Ne partagez jamais votre jeton Votifier publiquement ! Toute personne ayant accès à votre jeton peut envoyer de fausses notifications de vote à votre serveur.

  • Gardez votre jeton Votifier privé et sécurisé
  • Régénérez votre jeton immédiatement si vous pensez qu'il a été compromis
  • N'ouvrez le port Votifier qu'aux adresses IP de confiance si possible

Dépannage

Vous ne recevez pas de votes ?

  • Vérifiez que le port est ouvert et accessible depuis Internet
  • Vérifiez que l'adresse IP de votre serveur est correcte dans Hylist
  • Assurez-vous que le plugin Votifier fonctionne (vérifiez les logs du serveur)
  • Vérifiez que le jeton correspond exactement (pas d'espaces supplémentaires)

Votes reçus mais pas de récompenses ?

  • Assurez-vous que le joueur est en ligne lorsque le vote est traité
  • Vérifiez que le nom d'utilisateur est correctement orthographié (sensible à la casse !)
  • Vérifiez que votre plugin de récompenses est correctement configuré

Important : Le nom d'utilisateur est sensible à la casse

Les joueurs doivent entrer leur nom d'utilisateur exactement comme il apparaît en jeu, y compris la bonne capitalisation. Par exemple, "Player123" et "player123" sont traités comme des utilisateurs différents.

Best Practices for Voting Rewards

Setting up voting rewards is just the first step. To maximize the impact on your server's ranking and player retention, follow these proven strategies that top-ranked Hytale servers use.

Choose Meaningful Rewards

Give rewards that players actually want but can't easily get otherwise. Exclusive cosmetics, bonus currency, or temporary boosters work better than common items. The goal is to make voting feel rewarding without making it mandatory for progression.

Create Vote Streaks

Consider implementing escalating rewards for consecutive daily votes. For example, voting 7 days in a row could unlock a special reward. This encourages habitual voting and dramatically increases your monthly vote count.

Announce Rewards In-Game

When a player receives a vote reward, broadcast it to the server. A message like "[Player] voted and received 500 coins!" reminds other players that voting rewards exist and encourages them to vote too.

Use Discord Reminders

Set up the Hylist Discord bot to post your server's vote link in a dedicated channel. Players who see a daily reminder are significantly more likely to vote consistently. You can also pin your vote link for easy access.

Frequently Asked Questions

What happens if my server is offline when a player votes?
The vote is still counted toward your server's ranking. However, the Votifier2 notification cannot be delivered while your server is offline, so the player won't receive their in-game reward immediately. Most Votifier2 plugins queue missed notifications and deliver them when the server comes back online, but this depends on your plugin's configuration.
Can I give different rewards to different players?
Yes, through your rewards plugin configuration. Most plugins support permission-based rewards, where players with certain ranks or groups receive different rewards. You can configure your voteCommand.json to run different commands based on player permissions or implement rank-based reward tiers.
Is Votifier2 compatible with proxy networks (BungeeCord/Velocity)?
Yes. Install the Votifier2 plugin on your proxy server (BungeeCord or Velocity) and configure it to forward vote notifications to backend servers. The vote port should be opened on the proxy machine. Most reward plugins support receiving forwarded votes from the proxy.
How do I test if voting rewards are working?
After setting up Votifier2 and enabling rewards in your Hylist dashboard, simply vote for your own server. Join your game server and check if you receive the configured reward. If the reward doesn't arrive, check your server console for Votifier2 connection logs and ensure the port is open and the token matches.
Retour à Mes Serveurs