Handleiding voor Stembeloningen

Leer hoe je in-game beloningen instelt voor spelers die op je server stemmen via Hylist.

Wat is Votifier2?

Votifier2 is een protocol waarmee serverlijst-websites zoals Hylist stemmeldingen rechtstreeks naar je gameserver kunnen sturen. Wanneer een speler op je server stemt, stuurt Hylist een beveiligd bericht naar je server, die de speler vervolgens automatisch kan belonen.

Vereisten

  • Een Votifier2-compatibele plugin geïnstalleerd op je server
  • Een open poort voor de Votifier listener (standaard: 8192)
  • Een beloningsplugin om items/voordelen aan stemmers te geven (optioneel maar aanbevolen)

Stap 1: Een Votifier2 Plugin Installeren

Eerst moet je een Votifier2-compatibele plugin op je Hytale-server installeren. Wij raden aan:

Hytale Votifier Downloaden

Volg de installatie-instructies van de plugin om deze aan je server toe te voegen.

Stap 2: In-Game Beloningen Inschakelen in Hylist

Schakel in-game beloningen in via je Hylist-dashboard om je Votifier-token te krijgen.

  1. Ga naar de bewerkingspagina van je server in het Hylist-dashboard
  2. Zet "In-game beloningen inschakelen" op AAN
  3. Stel de Votifier-poort in (standaard: 8192)
  4. Sla je wijzigingen op
  5. Kopieer je Votifier-token voor de volgende stap

Stap 3: De Plugin Configureren

Plak het Votifier-token van Hylist in het configuratiebestand van je plugin.

Voorbeeldconfiguratie (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>"
  }
}

Optioneel: Stem-commando configuratie (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>"
  }
}

Vervang <YOUR_SERVER_SLUG> door de slug van je server (bijv. "mijn-geweldige-server"). Je kunt deze vinden in de URL van je server op Hylist.

Tip: Gebruikersnaam vooraf invullen voor betere UX

Je kunt ?username=SpelerNaam toevoegen aan de stem-URL om de gebruikersnaam automatisch in te vullen:

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

Let op: Dit vereist aangepaste plugin-ondersteuning omdat de meeste plugins dit standaard niet ondersteunen.

Stap 4: De Poort Openen

Zorg ervoor dat de Votifier-poort open en toegankelijk is vanaf internet.

Zorg ervoor dat de poort open staat in de firewall van je server. Als je een hostingprovider gebruikt, moet je mogelijk port forwarding configureren.

Je Configuratie Testen

Om te controleren of alles werkt:

  1. Zorg ervoor dat je server online is en de Votifier-plugin draait
  2. Stem op je server via Hylist en voer je in-game gebruikersnaam in
  3. Controleer je serverconsole op stemmeldingen
  4. Controleer of je de geconfigureerde beloningen in-game ontvangt

Beveiligingstips

Deel je Votifier-token nooit publiekelijk! Iedereen met toegang tot je token kan valse stemmeldingen naar je server sturen.

  • Houd je Votifier-token privé en veilig
  • Genereer je token onmiddellijk opnieuw als je vermoedt dat het is gecompromitteerd
  • Open de Votifier-poort indien mogelijk alleen voor vertrouwde IP-adressen

Probleemoplossing

Ontvang je geen stemmen?

  • Controleer of de poort open en toegankelijk is vanaf internet
  • Controleer of het IP-adres van je server correct is in Hylist
  • Zorg ervoor dat de Votifier-plugin draait (controleer de serverlogs)
  • Controleer of het token exact overeenkomt (geen extra spaties)

Stemmen ontvangen maar geen beloningen?

  • Zorg ervoor dat de speler online is wanneer de stem wordt verwerkt
  • Controleer of de gebruikersnaam correct is gespeld (hoofdlettergevoelig!)
  • Controleer of je beloningsplugin correct is geconfigureerd

Belangrijk: Gebruikersnaam is hoofdlettergevoelig

Spelers moeten hun gebruikersnaam exact invoeren zoals deze in-game verschijnt, inclusief correcte hoofdletters. Bijvoorbeeld, "Player123" en "player123" worden als verschillende gebruikers behandeld.

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.
Terug naar Mijn Servers