Vote-Belohnungen mit VotingPlugin einrichten

So wird aus einem Vote eine Belohnung

Drei Teile arbeiten zusammen. Ein Spieler votet auf einer Serverliste. Die Liste schickt eine Vote-Nachricht an Votifier auf deinem Server, mit dem Spielernamen und einem Dienstnamen, an dem man die Liste erkennt. VotingPlugin hört auf diese Nachrichten, sucht die Vote-Seite, deren ServiceSite zum Dienstnamen passt, und führt deren Belohnungen aus.

VotingPlugin empfängt also selbst keine Votes. Du brauchst zuerst ein funktionierendes Votifier, meistens NuVotifier. Falls das noch fehlt, arbeite zuerst die Anleitung zu NuVotifier durch und komm dann zurück.

• Votifier nimmt den Vote an und prüft ihn (Token bei v2, RSA-Schlüssel bei v1).
• VotingPlugin ordnet den Dienstnamen zu und verteilt die Belohnungen.
• BestMCServerList schickt den Dienstnamen BestMCServerList.

Schritt 1: VotingPlugin installieren

1. Stell sicher, dass NuVotifier läuft und erreichbar ist. Ein Testvote von deiner Votifier-Seite sollte in der Konsole auftauchen.
2. Leg die JAR von VotingPlugin in den Ordner plugins deines Spigot- oder Paper-Servers und starte ihn einmal neu.
3. VotingPlugin legt seine Dateien an, darunter plugins/VotingPlugin/VoteSites.yml für die Vote-Seiten und Config.yml für allgemeine Einstellungen.

In einem Netzwerk kommen Votes meist am Proxy an, und die Belohnungen laufen auf den Backend-Servern. Halte die VoteSites.yml auf allen Backends gleich.

Schritt 2: BestMCServerList in der VoteSites.yml eintragen

Jede Liste, auf der du stehst, bekommt einen eigenen Eintrag unter VoteSites. Der Schlüssel ist ein interner Name: kurz, ohne Leerzeichen und ohne Punkte. Die wichtigste Zeile ist ServiceSite.

VoteSites:
  BestMCServerList:
    Enabled: true
    Name: 'BestMCServerList'
    Priority: 5
    ServiceSite: 'BestMCServerList'
    VoteURL: 'https://bestmcserverlist.net/de/server/dein-server/vote'
    VoteDelay: 24h
    WaitUntilVoteDelay: false
    VoteDelayDaily: true
    ForceOffline: false
    DisplayItem:
      Material: 'DIAMOND'
      Amount: 1
    Rewards:
      Commands:
      - 'eco give %player% 250'
      - 'give %player% diamond 2'
      Messages:
        Player: '&aDanke fürs Voten auf BestMCServerList!'

• Enabled: true muss gesetzt sein, standardmäßig steht es auf false.
• ServiceSite muss zu dem Dienstnamen passen, den die Liste schickt. Groß- und Kleinschreibung ist VotingPlugin egal, sonst muss der Text genau stimmen. Bei uns ist es BestMCServerList.
• VoteURL ist der Link, den Spieler mit /vote bekommen. Kopier deinen Vote-Link von deiner Serverseite; dein-server steht für deinen eigenen Slug.
• DisplayItem ist für jede Seite Pflicht, weil VotingPlugin es in seinen Menüs anzeigt.
• Die Befehle laufen über die Konsole, und %player% wird durch den Namen des Voters ersetzt. eco give braucht ein Economy-Plugin; nimm die Befehle, die dein Server kennt.

Speichere die Datei und führ /av reload aus.

Schritt 3: Vote-Delay und täglicher Reset

Bei BestMCServerList kann jeder Minecraft-Name einmal pro Server und Kalendertag voten, und der Tag richtet sich nach der Zeitzone Europe/Berlin. Ein neuer Vote geht also direkt nach Mitternacht deutscher Zeit, nicht erst 24 Stunden nach dem letzten.

• VoteDelay: 24h nutzt VotingPlugin für /vote next, den Countdown, den Spieler sehen. Votes blockiert es nicht.
• VoteDelayDaily: true setzt den Delay stattdessen einmal am Tag zurück und passt damit zu Listen mit täglichem Reset wie unserer. Mit VoteDelayDailyHour legst du die Stunde in Serverzeit fest (1–24). Läuft die Uhr deines Servers nicht auf deutscher Zeit, denk beim Einstellen an den Unterschied.
• WaitUntilVoteDelay: true würde Votes ablehnen, die vor Ablauf des Delays ankommen. Lass es auf false: Wir sorgen schon für einen Vote pro Name und Tag, und ein falsch eingestellter Delay kostet Spieler ihre Belohnung.

Schritt 4: Belohnungen testen

1. Führ /av vote <spieler> BestMCServerList aus. Das löst die Belohnungen dieser Seite für einen Spieler aus und zeigt, dass deine Belohnungs-Config funktioniert. Votifier wird dabei nicht getestet.
2. Öffne deine Votifier-Seite bei BestMCServerList und drück „Testvote senden“. Wir schicken einen Vote für den Namen TestVote, der nicht fürs Ranking zählt. Im Zustell-Protokoll siehst du, ob dein Server ihn angenommen hat.
3. Schau in der Konsole nach einer Zeile wie [VotingPlugin] Received a vote from service site 'BestMCServerList' by player 'TestVote'!.
4. Mit /av servicesites siehst du, welche Dienstnamen VotingPlugin bisher empfangen hat.

Kommt der Testvote an, aber VotingPlugin meldet eine unbekannte Vote-Seite, liegt es an der Zeile ServiceSite. Mit AutoCreateVoteSites: true in der Config.yml (Standard) legt VotingPlugin unter Umständen selbst einen neuen Eintrag an; der braucht trotzdem Enabled: true und deine Belohnungen.

Bedrock-Spieler und Votes im Offline-Zustand

Bedrock-Spieler, die über Geyser und Floodgate joinen, haben ein Namenspräfix, standardmäßig einen Punkt: .Steve. Diese Spieler voten mit dem vollen Namen, und wir geben ihn unverändert an Votifier weiter. In VotingPlugin trägst du dasselbe Präfix in der Config.yml ein, im Netzwerk mit demselben Wert auf dem Proxy und jedem Backend:

BedrockPlayerPrefix: '.'

.Steve und Steve sind zwei verschiedene Spieler. Entfern das Präfix nie, nur damit ein Name passt.

Spieler müssen beim Voten nicht online sein. Belohnungen haben einen RewardType mit ONLINE, OFFLINE oder BOTH (Standard). Teste auch Votes von Spielern, die gerade offline sind, denn Befehle, die einen Spieler im Spiel brauchen, verhalten sich dann anders.

Vote-Partys, Meilensteine und Streaks

Sobald die normalen Belohnungen laufen, bringt die SpecialRewards.yml Ziele, die zum Weitervoten motivieren: eine VoteParty, wenn der ganze Server eine bestimmte Zahl an Votes erreicht, VoteMilestones für persönliche Summen und VoteStreaks für mehrere Tage am Stück. Halte die Belohnungen nützlich, aber fair; wenn sie deine Wirtschaft sprengen, fühlt sich Voten wie eine Pflicht an.

Du willst Top-Votern ein Rangabzeichen geben? Die Anleitung zu LuckPerms-Präfixen zeigt, wie ein Bild-Präfix per Befehl vergeben wird, und den kannst du als Belohnung ausführen.

Typische Fehler