mcMMO Rewards: en guide til belønningspluginet for nivåer i Minecraft

Det populære RPG-systemet mcMMO legger til nivåmekanikker for ferdigheter på Minecraft-servere, som fiske, gruvedrift eller urtekunnskap. Utviklerne av det opprinnelige pluginet bygde imidlertid ikke inn et fleksibelt system for automatisk å dele ut gjenstander, valuta eller egendefinerte titler når spillere når bestemte nivåer. Tilleggsutvidelsen mcMMO Rewards løser nettopp dette problemet. Den kobler mcMMOs nivåsystem til serverens konsollkommandoer, slik at servereiere kan sette opp automatiske belønninger for aktive spillere uten å skrive kompliserte skript.

Hendelseshåndtering og API-integrasjon

mcMMO Rewards fungerer som en lettvekts event listener som kobles direkte inn i kjernen på Spigot/Paper-serveren og kommuniserer med det offisielle API-et til mcMMO-pluginet.

Fange opp hendelsen McMMOPlayerLevelUpEvent

Hver gang en spiller går opp et nivå i en ferdighet (for eksempel ved å utvinne malm eller høste avlinger), utløser mcMMO en McMMOPlayerLevelUpEvent. mcMMO Rewards fanger opp denne hendelsen og kjører følgende logikk:

1. Leser navnet på ferdigheten og det nye nivået spilleren har nådd.

2. Sammenligner disse dataene med belønningslistene som er definert i konfigurasjonsfilen config.yml.

3. Hvis det finnes en match, kjører pluginet den konfigurerte kommandolisten på vegne av konsollen, og erstatter plassholderen %player% med spillerens navn.

Viktige begrensninger ved hendelseshåndtering

Fordi pluginet utelukkende er knyttet til hendelsen McMMOPlayerLevelUpEvent, reagerer det bare på naturlige nivåoppganger oppnådd under spill. ⚠️ Nullstilling av nivåer og databaseendringer: hvis en administrator endrer nivået til en spiller direkte via SQLite/MySQL-databasefilene (for eksempel under en statistikkmigrering eller en wipe), eller bruker konsollkommandoer som endrer nivåverdien uten å utløse den vanlige nivåopp-hendelsen, vil ikke belønninger bli utløst. Pluginet støtter heller ikke retroaktiv tildeling av belønninger: hvis en spiller allerede hadde nådd nivå 50 før mcMMO Rewards ble installert, mottar vedkommende ikke belønningene for de tidligere nivåene (10, 20 osv.) før neste nivå nås.

Strukturen til config.yml og oppsett av belønninger

Alle belønninger defineres i én samlet konfigurasjonsfil, plugins/mcMMORewards/config.yml. Takket være YAMLs enkle syntaks kan utviklere raskt bygge flernivå belønningssystemer.

Beskrivelse av konfigurasjonssyntaksen

Hver belønningsblokk følger et strengt hierarki:

• Ferdighetsnavn (Skill): må samsvare med det offisielle ferdighetsnavnet i mcMMO (for eksempel mining, woodcutting, swords, herbalism).

• Nivå (Level): et heltall — nivået kommandoene utføres på.

• Kommandoliste: listen over konsollhandlinger. Det er ikke nødvendig å sette en skråstrek / foran kommandoene, siden de alle utføres direkte av serveren på vegne av konsollen (OP-nivå).

Eksempel på konfigurasjonsfil

Nedenfor er et eksempel på en korrekt strukturert fil for å dele ut gjenstander og penger:

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"

I dette eksempelet mottar spilleren %player% jernbarrer når vedkommende når nivå 10 i mining, og en melding kringkastes til hele serveren. Ved nivå 50 mottar spilleren 1000 valutaenheter gjennom et økonomiplugin (for eksempel EssentialsX) og 3 diamanter.

Administrere pluginet: kommandoer og tillatelser

Siden mcMMO Rewards er en svært kompakt utvidelse, er listen over kommandoer og tillatelser begrenset til kun administrative funksjoner.

Kommando for å laste inn konfigurasjonen på nytt

Du trenger ikke å starte hele Minecraft-serveren på nytt eller avbryte spillingen for å bruke endringer i filen config.yml. Det holder å kjøre kommandoen: /mcmmorewards reload Denne kommandoen laster ut de gamle innstillingene fra serverens minne og leser konfigurasjonsfilen på nytt, slik at de nye belønningene tas i bruk umiddelbart.

Administratortillatelser (Permissions)

Av hensyn til serversikkerheten er muligheten til å kjøre reload-kommandoen begrenset til en egen tillatelse (permission node). Vanlige spillere har ikke tilgang til denne kommandoen. For å gi rettigheten til en administrator eller moderator (for eksempel via LuckPerms), bruk følgende node: mcmmorewards.reload Som standard blir denne tillatelsen automatisk gitt til alle spillere med server-operatørstatus (OP).

Konklusjon

mcMMO Rewards er et utmerket hjelpeverktøy for Minecraft-servere med RPG- og overlevelseselementer som bruker mcMMOs ferdighetssystem. Det gjør det enkelt å sette opp automatisk utdeling av belønninger for spillaktivitet uten å måtte lære kompliserte skriptspråk eller bruke tunge skript.

Sammenlignet med kompliserte skript som Skript (som krever at man skriver egen syntaks for å lytte etter mcMMO-hendelser) eller fullverdige quest-plugins, tilbyr mcMMO Rewards et system som er så enkelt og raskt å sette opp som mulig, med nesten ingen belastning på serverressursene. Den fullstendige avhengigheten av at mcMMO-pluginet er installert, samt at kommandoer kun kan kjøres på vegne av konsollen, er likevel dets viktigste begrensninger. Pluginet passer perfekt for servere som raskt vil legge til enkle belønninger for ressursinnsamling eller oppgradering av kampferdigheter.