TulpenCraftVote

TulpenCraftVote verwerkt stemmen binnen het TulpenCraft-netwerk. De plugin beheert stemstatistieken, VoteParty-voortgang, stem-beloningen, VoteParty-beloningen en offline beloningen.

Voor een netwerk met meerdere Paper-servers kan gedeelde opslag via MySQL/MariaDB of p-core worden gebruikt. De huidige code bevat nog geen VotifierPlus-eventlistener; stemmen moeten momenteel via de beschikbare commandostructuur worden aangeleverd.

Jar-bestand:

TulpenCraftVote-1.0.0.jar

De artifactversie komt momenteel uit build.gradle en is 1.0.0; de pluginmetadata gebruikt versie 1.5.0. Deze versies moeten vóór productie gelijkgetrokken worden.

Locatie:

/srv/minecraft/{{SERVER}}/plugins/TulpenCraftVote-1.0.0.jar

Configuratiebestand:

/srv/minecraft/{{SERVER}}/plugins/TulpenCraftVote/config.yml

server-name: survival
master: false

sync:
  interval-seconds: 5

storage:
  type: mysql
  mysql:
    host: 172.16.0.30
    port: 3306
    database: tulpen_craft_vote
    username: user
    password: ""
    ssl: false

vote:
  goal: 50
  rewards:
    - "eco give {player} 100"
  party-global-rewards:
    - "broadcast &6De VoteParty is voltooid!"

De SQL-backends gebruiken de volgende tabellen:

• tulpen_vote_profiles
• tulpen_vote_state
• tulpen_vote_pending
• tulpen_vote_online
• tulpen_vote_milestones
• tulpen_vote_stats

De YAML-backend gebruikt votes.yml met onder andere de paden profiles, pending, online, milestones, shared-config en party-progress.

/tulpenvote

/tulpenvote reload

/tulpenvote add vote <aantal> <speler>

/tulpenvote party

/tulpenvote setmijlpaal <speler> <mijlpaal> <true|false>

/tulpenvote reset mijlpaal <speler|all> <mijlpaal|all>

/tulpenvote reset vote <total|days|hebdo|mois> <speler|all>

Legacy aliases /vp, /voteparty, setpallier en reset pallier zijn voorlopig behouden voor compatibiliteit.

• Paper of Folia
• PlaceholderAPI (optioneel)
• p-core (optioneel, voor managed opslag)
• MySQL/MariaDB-server wanneer storage.type: mysql wordt gebruikt
• VotifierPlus op Velocity is gewenst voor de toekomstige vote-receiver, maar nog niet in deze codebase geïntegreerd

Proxy-plugin: Ja, netwerkontwerp voor Velocity; VotifierPlus-koppeling nog niet geïmplementeerd.

Alle Paper-servers moeten bij gedeelde opslag dezelfde database gebruiken en een unieke server-name hebben.

Databasewachtwoorden horen alleen in de serverconfiguratie te staan en mogen niet in Git of deze wiki worden opgeslagen. Gebruik voor productie een beperkte databasegebruiker, TLS wanneer beschikbaar en een aparte database voor TulpenCraftVote.

De rewardconfiguratie voert servercommando's uit als console. Controleer daarom alle rewardcommando's voordat de configuratie wordt uitgerold.

• De VotifierPlus-eventlistener ontbreekt nog.
• De build-artifactversie (1.0.0) en pluginversie (1.5.0) lopen uiteen.
• De huidige Paper-metadata gebruikt nog api-version: 1.21.8; Paper 26.2 moet nog als build- en runtime-doel worden gevalideerd.
• VoteParty- en pending-rewardverwerking moeten vóór productie met meerdere gelijktijdige servers worden getest.
• Controleer de databaseback-up voordat storage- of schemawijzigingen worden uitgerold.

De plugin start niet of Gradle kan de Java-toolchain niet vinden.

./gradlew --version
./gradlew clean build

Gebruik een compatibele Gradle-versie en zorg dat Java 21 beschikbaar is of via de Foojay-toolchainresolver kan worden gedownload. Controleer bij Paper-problemen ook paper-plugin.yml, de bootstrapper en de loader.

Stemdata of pending beloningen zijn niet zichtbaar op een andere server.

storage.type: mysql
server-name: unieke-servernaam

Controleer of alle servers dezelfde database gebruiken, de database bereikbaar is en iedere server een unieke server-name heeft.

Laatste wijziging: 2026-09-12

Wijziging: TulpenCraftVote-hernoeming, nieuwe package-structuur, Nederlandse documentatie en opgeschoonde storage-namen.

Status: ⚠️ Aandacht nodig vóór productie

• TulpenCraft
• PaperMC-documentatie
• PlaceholderAPI
• Foojay/Gradle toolchain-documentatie