Guide för Röstbelöningar

Lär dig hur du ställer in belöningar i spelet för spelare som röstar på din server på Hylist.

Vad är Votifier2?

Votifier2 är ett protokoll som tillåter serverlistsidor som Hylist att skicka röstnotifieringar direkt till din spelserver. När en spelare röstar på din server skickar Hylist ett säkert meddelande till din server, som sedan kan belöna spelaren automatiskt.

Krav

  • En Votifier2-kompatibel plugin installerad på din server
  • En öppen port för Votifier-lyssnaren (standard: 8192)
  • En belöningsplugin för att ge föremål/förmåner till röstare (valfritt men rekommenderat)

Steg 1: Installera en Votifier2-plugin

Först måste du installera en Votifier2-kompatibel plugin på din Hytale-server. Vi rekommenderar:

Ladda ner Hytale Votifier

Följ pluginens installationsinstruktioner för att lägga till den på din server.

Steg 2: Aktivera Belöningar i Spelet på Hylist

Aktivera belöningar i spelet på din Hylist-kontrollpanel för att få din Votifier-token.

  1. Gå till din servers redigeringssida på Hylist-kontrollpanelen
  2. Slå på "Aktivera belöningar i spelet"
  3. Ställ in Votifier-porten (standard: 8192)
  4. Spara dina ändringar
  5. Kopiera din Votifier-token för nästa steg

Steg 3: Konfigurera Pluginen

Klistra in Votifier-token från Hylist i din plugins konfigurationsfil.

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

Valfritt: Röstkommandokonfiguration (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>"
  }
}

Ersätt <YOUR_SERVER_SLUG> med din servers slug (t.ex. "my-awesome-server"). Du hittar detta i din servers URL på Hylist.

Tips: Förfyll användarnamn för bättre upplevelse

Du kan lägga till ?username=Spelarnamn till röst-URL:en för att automatiskt fylla i spelarens användarnamn:

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

Obs: Detta kräver anpassat pluginstöd eftersom de flesta plugins inte stöder detta som standard.

Steg 4: Öppna Porten

Se till att Votifier-porten är öppen och tillgänglig från internet.

Se till att porten är öppen i din servers brandvägg. Om du använder en värdleverantör kan du behöva konfigurera portvidarebefordran.

Testa Din Installation

För att verifiera att allt fungerar:

  1. Se till att din server är online och Votifier-pluginen körs
  2. Rösta på din server på Hylist och ange ditt användarnamn i spelet
  3. Kontrollera din serverkonsol för röstnotifieringar
  4. Verifiera att du får de konfigurerade belöningarna i spelet

Säkerhetstips

Dela aldrig din Votifier-token offentligt! Vem som helst med tillgång till din token kan skicka falska röstnotifieringar till din server.

  • Håll din Votifier-token privat och säker
  • Återgenerera din token omedelbart om du misstänker att den har komprometterats
  • Öppna endast Votifier-porten för betrodda IP-adresser om möjligt

Felsökning

Får du inga röster?

  • Verifiera att porten är öppen och tillgänglig från internet
  • Kontrollera att din servers IP-adress är korrekt på Hylist
  • Se till att Votifier-pluginen körs (kontrollera serverloggar)
  • Verifiera att token matchar exakt (inga extra mellanslag)

Röster mottagna men inga belöningar?

  • Se till att spelaren är online när rösten behandlas
  • Kontrollera att användarnamnet är korrekt stavat (skiftlägeskänsligt!)
  • Verifiera att din belöningsplugin är korrekt konfigurerad

Viktigt: Användarnamn är skiftlägeskänsligt

Spelare måste ange sitt användarnamn exakt som det visas i spelet, inklusive korrekt versalisering. Till exempel behandlas "Player123" och "player123" som olika användare.

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.
Tillbaka till Mina Servrar