mcMMO Rewards: een gids voor de level-beloningsplugin voor Minecraft

Het populaire RPG-systeem mcMMO voegt skill-leveling-mechanieken toe aan Minecraft-servers, zoals vissen, delven of kruidenkunde. De ontwikkelaars van de originele plugin hebben echter geen flexibel systeem ingebouwd om automatisch items, valuta of eigen titels uit te delen wanneer spelers bepaalde levels bereiken. De aanvullende add-on mcMMO Rewards lost precies dat probleem op. Het koppelt het levelsysteem van mcMMO aan serverconsole-commando's, waardoor servereigenaren automatische beloningen kunnen instellen voor actieve spelers zonder ingewikkelde scripts te schrijven.

Event-afhandeling en API-integratie

mcMMO Rewards werkt als een lichte event listener die rechtstreeks in de kern van de Spigot/Paper-server haakt en communiceert met de officiële API van de mcMMO-plugin.

Het onderscheppen van McMMOPlayerLevelUpEvent

Telkens wanneer een speler een level omhoog gaat in een vaardigheid (bijvoorbeeld door erts te delven of gewassen te oogsten), genereert mcMMO een McMMOPlayerLevelUpEvent. mcMMO Rewards onderschept dit event en voert de volgende logica uit:

1. Leest de naam van de vaardigheid en het nieuwe level dat de speler heeft bereikt.

2. Vergelijkt deze gegevens met de beloningslijsten die zijn gedefinieerd in het configuratiebestand config.yml.

3. Als er een match wordt gevonden, voert de plugin namens de console de ingestelde lijst met commando's uit en vervangt daarbij de placeholder %player% door de naam van de speler.

Belangrijke beperkingen van de event-afhandeling

Omdat de plugin uitsluitend gekoppeld is aan het event McMMOPlayerLevelUpEvent, reageert hij alleen op natuurlijke level-ups die tijdens het spelen worden behaald. ⚠️ Levelresets en databasewijzigingen: als een beheerder het level van een speler rechtstreeks wijzigt via de SQLite/MySQL-databasebestanden (bijvoorbeeld bij een statistiekmigratie of een wipe), of console-commando's gebruikt die de levelwaarde wijzigen zonder het standaard level-up-event te activeren, worden er geen beloningen geactiveerd. De plugin ondersteunt ook geen retroactieve toekenning van beloningen: als een speler al level 50 had bereikt vóór de installatie van mcMMO Rewards, ontvangt hij geen beloningen voor de eerder behaalde levels (10, 20, enz.) totdat hij het volgende level bereikt.

De structuur van config.yml en het instellen van beloningen

Alle beloningen worden gedefinieerd in één configuratiebestand, plugins/mcMMORewards/config.yml. Dankzij de eenvoudige YAML-syntax kunnen ontwikkelaars snel meerlaagse beloningssystemen bouwen.

Overzicht van de configuratiesyntax

Elk beloningsblok volgt een strikte hiërarchie:

• Vaardigheidsnaam (Skill): moet overeenkomen met de officiële vaardigheidsnaam in mcMMO (bijvoorbeeld mining, woodcutting, swords, herbalism).

• Level: een geheel getal — het level waarbij de commando's worden uitgevoerd.

• Commandolijst: de lijst met console-acties. Een voorloopschuine streep / vóór de commando's is niet nodig, omdat ze allemaal rechtstreeks door de server namens de console (OP-niveau) worden uitgevoerd.

Voorbeeld van een configuratiebestand

Hieronder staat een voorbeeld van een correct gestructureerd bestand voor het uitdelen van items en geld:

rewards:
  mining:
    10:
      - "give %player% iron_ingot 5"
      - "broadcast &6[RPG] &e%player% &fдосяг 10-го рівня видобутку руди!"
    50:
      - "eco give %player% 1000"
      - "give %player% diamond 3"
  swords:
    25:
      - "xp give %player% 500"

In dit voorbeeld ontvangt de speler %player%, wanneer die level 10 bereikt in mining, ijzeren staven, en wordt er een bericht naar de hele server verzonden. Bij level 50 ontvangt de speler 1000 eenheden valuta via een economie-plugin (zoals EssentialsX) en 3 diamanten.

De plugin beheren: commando's en rechten

Omdat mcMMO Rewards een zeer compacte add-on is, is de lijst met commando's en rechten beperkt tot alleen administratieve functies.

Commando om de configuratie opnieuw te laden

Je hoeft niet de hele Minecraft-server opnieuw op te starten of het spel te onderbreken om wijzigingen in het bestand config.yml toe te passen. Voer gewoon het commando uit: /mcmmorewards reload Dit commando verwijdert de oude instellingen uit het geheugen van de server en leest het configuratiebestand opnieuw in, waardoor de nieuwe beloningen direct worden toegepast.

Rechten voor beheerders (Permissions)

Voor de veiligheid van de server is de mogelijkheid om het reload-commando uit te voeren beperkt tot een speciaal recht (permission node). Gewone spelers hebben geen toegang tot dit commando. Om het recht toe te kennen aan een beheerder of moderator (bijvoorbeeld via LuckPerms), gebruik je het volgende knooppunt: mcmmorewards.reload Standaard wordt dit recht automatisch toegekend aan elke speler met de status van serveroperator (OP).

Conclusie

mcMMO Rewards is een uitstekend hulpmiddel voor Minecraft-servers met RPG- en survivalelementen die gebruikmaken van het vaardighedensysteem van mcMMO. Het maakt het eenvoudig om automatische beloningen voor in-game activiteit in te stellen, zonder ingewikkelde scripttalen te hoeven leren of zware scripts te gebruiken.

Vergeleken met complexe scripts zoals Skript (waarvoor je een eigen syntax moet schrijven om naar mcMMO-events te luisteren) of volwaardige questplugins, biedt mcMMO Rewards een systeem dat zo eenvoudig en snel mogelijk is in te stellen, met vrijwel geen belasting van de serverresources. De volledige afhankelijkheid van een geïnstalleerde mcMMO-plugin en het feit dat commando's alleen namens de console kunnen worden uitgevoerd, blijven echter de belangrijkste beperkingen. De plugin is perfect voor servers die snel eenvoudige beloningen willen toevoegen voor het verzamelen van grondstoffen of het opleveren van gevechtsvaardigheden.