Anleitung zur Einrichtung von Abstimmungsbelohnungen

Erfahre, wie du In-Game-Belohnungen für Spieler einrichtest, die für deinen Server auf Hylist abstimmen.

Was ist Votifier2?

Votifier2 ist ein Protokoll, das es Server-Listen-Websites wie Hylist ermöglicht, Abstimmungsbenachrichtigungen direkt an deinen Spielserver zu senden. Wenn ein Spieler für deinen Server abstimmt, sendet Hylist eine sichere Nachricht an deinen Server, der den Spieler dann automatisch belohnen kann.

Voraussetzungen

  • Ein Votifier2-kompatibles Plugin auf deinem Server installiert
  • Ein offener Port für den Votifier-Listener (Standard: 8192)
  • Ein Belohnungs-Plugin, um Wählern Items/Vorteile zu geben (optional, aber empfohlen)

Schritt 1: Ein Votifier2-Plugin installieren

Zuerst musst du ein Votifier2-kompatibles Plugin auf deinem Hytale-Server installieren. Wir empfehlen:

Hytale Votifier herunterladen

Folge den Installationsanweisungen des Plugins, um es zu deinem Server hinzuzufügen.

Schritt 2: In-Game-Belohnungen in Hylist aktivieren

Aktiviere In-Game-Belohnungen in deinem Hylist-Dashboard, um deinen Votifier-Token zu erhalten.

  1. Gehe zur Bearbeitungsseite deines Servers im Hylist-Dashboard
  2. Schalte "In-Game-Belohnungen aktivieren" auf EIN
  3. Stelle den Votifier-Port ein (Standard: 8192)
  4. Speichere deine Änderungen
  5. Kopiere deinen Votifier-Token für den nächsten Schritt

Schritt 3: Das Plugin konfigurieren

Füge den Votifier-Token von Hylist in die Konfigurationsdatei deines Plugins ein.

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

Optional: Vote-Befehl-Konfiguration (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>"
  }
}

Ersetze <YOUR_SERVER_SLUG> durch den Slug deines Servers (z.B. "mein-toller-server"). Du findest ihn in der URL deines Servers auf Hylist.

Tipp: Benutzername für bessere UX vorausfüllen

Du kannst ?username=SpielerName zur Vote-URL hinzufügen, um den Benutzernamen automatisch auszufüllen:

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

Hinweis: Dies erfordert benutzerdefinierte Plugin-Unterstützung, da die meisten Plugins dies standardmäßig nicht unterstützen.

Schritt 4: Den Port öffnen

Stelle sicher, dass der Votifier-Port offen und aus dem Internet erreichbar ist.

Stelle sicher, dass der Port in der Firewall deines Servers geöffnet ist. Bei einem Hosting-Anbieter musst du möglicherweise die Portweiterleitung konfigurieren.

Deine Einrichtung testen

Um zu überprüfen, ob alles funktioniert:

  1. Stelle sicher, dass dein Server online ist und das Votifier-Plugin läuft
  2. Stimme für deinen Server auf Hylist ab und gib deinen Spielernamen ein
  3. Überprüfe die Serverkonsole auf Abstimmungsbenachrichtigungen
  4. Überprüfe, ob du die konfigurierten Belohnungen im Spiel erhältst

Sicherheitstipps

Teile deinen Votifier-Token niemals öffentlich! Jeder, der Zugang zu deinem Token hat, kann gefälschte Abstimmungsbenachrichtigungen an deinen Server senden.

  • Halte deinen Votifier-Token privat und sicher
  • Generiere deinen Token sofort neu, wenn du vermutest, dass er kompromittiert wurde
  • Öffne den Votifier-Port wenn möglich nur für vertrauenswürdige IP-Adressen

Fehlerbehebung

Keine Stimmen erhalten?

  • Überprüfe, ob der Port offen und aus dem Internet erreichbar ist
  • Stelle sicher, dass die IP-Adresse deines Servers in Hylist korrekt ist
  • Stelle sicher, dass das Votifier-Plugin läuft (überprüfe die Server-Logs)
  • Überprüfe, ob der Token genau übereinstimmt (keine zusätzlichen Leerzeichen)

Stimmen erhalten, aber keine Belohnungen?

  • Stelle sicher, dass der Spieler online ist, wenn die Stimme verarbeitet wird
  • Überprüfe, ob der Benutzername richtig geschrieben ist (Groß-/Kleinschreibung beachten!)
  • Überprüfe, ob dein Belohnungs-Plugin richtig konfiguriert ist

Wichtig: Benutzername ist groß-/kleinschreibungsabhängig

Spieler müssen ihren Benutzernamen genau so eingeben, wie er im Spiel erscheint, einschließlich korrekter Groß-/Kleinschreibung. Zum Beispiel werden "Player123" und "player123" als verschiedene Benutzer behandelt.

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.
Zurück zu Meinen Servern