Minecraft-stembeloningen met VotingPlugin

Zo wordt een stem een beloning

Drie onderdelen werken samen. Een speler stemt op een serverlijst. De lijst stuurt een stembericht naar Votifier op je server, samen met de spelernaam en een servicenaam die de lijst identificeert. VotingPlugin luistert naar die berichten, zoekt de stemsite waarvan ServiceSite overeenkomt met de servicenaam en voert de beloningen van die site uit.

VotingPlugin ontvangt dus zelf geen stemmen. Je hebt eerst een werkende Votifier nodig, meestal NuVotifier. Heb je die nog niet ingesteld, volg dan de handleiding voor NuVotifier en kom daarna terug.

• Votifier ontvangt de stem en controleert hem (token bij v2, RSA-sleutel bij v1).
• VotingPlugin koppelt de servicenaam en geeft de beloningen.
• BestMCServerList stuurt de servicenaam BestMCServerList.

Stap 1: Installeer VotingPlugin

1. Zorg dat NuVotifier draait en bereikbaar is. Een teststem vanaf je Votifier-pagina moet in de console verschijnen.
2. Zet de VotingPlugin-JAR in de map plugins van je Spigot- of Paper-server en herstart één keer.
3. VotingPlugin maakt zijn bestanden aan, waaronder plugins/VotingPlugin/VoteSites.yml voor de stemsites en Config.yml voor algemene instellingen.

Op een proxynetwerk komen stemmen meestal binnen op de proxy en draaien beloningen op de backendservers. Houd VoteSites.yml op elke backend gelijk.

Stap 2: Voeg BestMCServerList toe aan VoteSites.yml

Elke lijst waarop je staat, krijgt een eigen regel onder VoteSites. De sleutel is een interne naam: houd hem kort, zonder spaties en zonder punten. De belangrijke regel is ServiceSite.

VoteSites:
  BestMCServerList:
    Enabled: true
    Name: 'BestMCServerList'
    Priority: 5
    ServiceSite: 'BestMCServerList'
    VoteURL: 'https://bestmcserverlist.net/server/your-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: '&aThanks for voting on BestMCServerList!'

• Enabled: true is nodig, de standaard is false.
• ServiceSite moet overeenkomen met de servicenaam die de lijst stuurt. VotingPlugin negeert hoofdletters, maar verder moet de tekst identiek zijn. Bij ons is het BestMCServerList.
• VoteURL is de link die spelers krijgen met /vote. Kopieer je stemlink van je serverpagina; your-server staat voor je eigen slug.
• DisplayItem is voor elke site verplicht, omdat het in de menu’s van VotingPlugin wordt getoond.
• De commando’s draaien vanuit de console, en %player% wordt de naam van de stemmer. eco give heeft een economyplugin nodig; gebruik de commando’s die jouw server heeft.

Sla het bestand op en voer /av reload uit.

Stap 3: Stemvertraging en de dagelijkse reset

Op BestMCServerList kan elke Minecraft-naam één keer per server per kalenderdag stemmen, en de dag volgt de tijdzone Europe/Berlin. Een nieuwe stem kan direct na middernacht Berlijnse tijd, niet 24 uur na de vorige.

• VoteDelay: 24h wordt gebruikt voor /vote next, de aftelling die spelers zien. Het blokkeert geen stemmen.
• VoteDelayDaily: true reset de vertraging in plaats daarvan één keer per dag, wat past bij lijsten met een dagelijkse reset zoals de onze. VoteDelayDailyHour stelt het uur in servertijd in (1–24). Loopt je serverklok niet op Berlijnse tijd, houd dan rekening met het verschil.
• WaitUntilVoteDelay: true zou stemmen weigeren die binnenkomen voordat de vertraging voorbij is. Laat het op false staan: wij dwingen al één stem per naam per dag af, en een verkeerde instelling zou spelers hun beloningen kosten.

Stap 4: Test de beloningen

1. Voer /av vote <player> BestMCServerList uit. Dit voert de beloningen van die site uit voor een speler en laat zien dat je beloningsconfig werkt. Votifier wordt hiermee niet getest.
2. Open je Votifier-pagina op BestMCServerList en klik op Teststem versturen. We sturen een stem voor de naam TestVote, die niet meetelt voor de ranglijst. Het afleverlog laat zien of je server hem heeft geaccepteerd.
3. Zoek in de console naar een regel zoals [VotingPlugin] Received a vote from service site 'BestMCServerList' by player 'TestVote'!.
4. Voer /av servicesites uit om de servicenamen te zien die VotingPlugin tot nu toe heeft ontvangen.

Komt de teststem aan maar meldt VotingPlugin een onbekende service site, dan is de regel ServiceSite het probleem. Met AutoCreateVoteSites: true in Config.yml (de standaard) kan VotingPlugin ook zelf een nieuwe regel aanmaken; die heeft nog steeds Enabled: true en je beloningen nodig.

Bedrock-spelers en offline stemmen

Bedrock-spelers die via Geyser en Floodgate joinen, hebben een prefix vóór hun naam, standaard een punt: .Steve. Ze stemmen met die volledige naam, en wij geven hem ongewijzigd door aan Votifier. Stel in VotingPlugin dezelfde prefix in via Config.yml. Gebruik op een netwerk dezelfde waarde op de proxy en op elke backend:

BedrockPlayerPrefix: '.'

.Steve en Steve zijn verschillende spelers. Haal de prefix nooit weg om een naam passend te maken.

Spelers hoeven niet online te zijn als ze stemmen. Beloningen hebben een RewardType van ONLINE, OFFLINE of BOTH (de standaard). Test ook offline stemmen, want commando’s die een online speler nodig hebben, gedragen zich anders.

Vote parties, mijlpalen en streaks

Zodra de basisbeloningen werken, voegt SpecialRewards.yml doelen toe die spelers blijven laten stemmen: een VoteParty die afgaat als de hele server een aantal stemmen haalt, VoteMilestones voor persoonlijke totalen en VoteStreaks voor meerdere dagen achter elkaar stemmen. Houd beloningen nuttig maar eerlijk; beloningen die je economy slopen, laten stemmen als een verplichting voelen.

Wil je een rankbadge voor topstemmers? De handleiding voor LuckPerms-prefixen laat zien hoe je spelers met een commando een prefix als afbeelding geeft, en dat commando kun je als beloning uitvoeren.

Veelgemaakte fouten