mcMMO Rewards: přehled pluginu pro odměny za úrovně v Minecraftu

Oblíbený RPG systém mcMMO přidává na servery Minecraft mechaniky postupu úrovní v dovednostech, jako je rybaření, těžba rudy nebo bylinkářství. Vývojáři původního pluginu ale nepočítali s flexibilním systémem pro automatické udělování předmětů, měny nebo vlastních titulů při dosažení určitých úrovní. Doplňkové rozšíření mcMMO Rewards řeší přesně tento problém. Propojuje systém úrovní mcMMO s konzolovými příkazy serveru a umožňuje provozovatelům serverů vytvářet automatické odměny pro aktivní hráče bez psaní složitých skriptů.

Zpracování událostí a integrace s API

mcMMO Rewards funguje jako odlehčený event listener, který se napojuje přímo na jádro serveru Spigot/Paper a komunikuje s oficiálním API pluginu mcMMO.

Zachycení události McMMOPlayerLevelUpEvent

Každokrát, když hráč postoupí o úroveň v jakékoli dovednosti (například těžbou rudy nebo sklizní úrody), mcMMO vyvolá událost McMMOPlayerLevelUpEvent. mcMMO Rewards tuto událost zachytí a spustí následující logiku:

1. Přečte název dovednosti a novou úroveň, které hráč dosáhl.

2. Porovná tato data se seznamy odměn definovanými v konfiguračním souboru config.yml.

3. Pokud najde shodu, plugin jménem konzole spustí nastavený seznam příkazů a nahradí zástupný symbol %player% jménem hráče.

Důležitá omezení zpracování událostí

Protože je plugin vázán výhradně na událost McMMOPlayerLevelUpEvent, reaguje pouze na přirozený postup úrovní dosažený během hraní. ⚠️ Resetování úrovní a úpravy databáze: pokud administrátor změní úroveň hráče přímo prostřednictvím souborů databáze SQLite/MySQL (například při migraci statistik nebo wipe), nebo použije konzolové příkazy, které mění hodnotu úrovně bez vyvolání standardní události postupu, odměny se neaktivují. Plugin také nepodporuje zpětné udělování odměn: pokud hráč dosáhl úrovně 50 už před instalací mcMMO Rewards, nedostane odměny za dříve dosažené úrovně (10, 20 atd.), dokud nedosáhne další úrovně.

Struktura souboru config.yml a nastavení odměn

Všechny odměny jsou definovány v jediném konfiguračním souboru, plugins/mcMMORewards/config.yml. Díky jednoduché syntaxi YAML mohou vývojáři rychle vytvářet vícestupňové systémy odměn.

Popis konfigurační syntaxe

Každý blok odměn má přísnou hierarchii:

• Název dovednosti (Skill): musí odpovídat oficiálnímu názvu dovednosti v mcMMO (například mining, woodcutting, swords, herbalism).

• Úroveň (Level): celé číslo — úroveň, při jejímž dosažení se příkazy spustí.

• Seznam příkazů: výčet konzolových akcí. Před příkazy není potřeba psát lomítko /, protože všechny příkazy provádí přímo server jménem konzole (úroveň OP).

Ukázka konfiguračního souboru

Níže je uveden příklad správně strukturovaného souboru pro udělování předmětů a peněz:

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"

V tomto příkladu hráč %player% po dosažení 10. úrovně dovednosti mining obdrží železné ingoty a na celý server se odešle zpráva. Při dosažení 50. úrovně hráč obdrží 1000 jednotek měny prostřednictvím ekonomického pluginu (například EssentialsX) a 3 diamanty.

Správa pluginu: příkazy a oprávnění

Protože je mcMMO Rewards velmi kompaktní rozšíření, seznam jeho příkazů a oprávnění je omezen pouze na administrativní funkce.

Příkaz pro opětovné načtení konfigurace

Pro použití jakýchkoli změn v souboru config.yml není potřeba restartovat celý server Minecraft ani přerušovat hru. Stačí spustit příkaz: /mcmmorewards reload Tento příkaz uvolní stará nastavení z paměti serveru a znovu načte konfigurační soubor, čímž se nové odměny okamžitě uplatní.

Oprávnění pro administrátory (Permissions)

Z bezpečnostních důvodů je možnost spustit příkaz pro opětovné načtení omezena speciálním oprávněním (permission node). Běžní hráči k tomuto příkazu přístup nemají. Chcete-li udělit práva administrátorovi nebo moderátorovi (například přes LuckPerms), použijte následující uzel: mcmmorewards.reload Ve výchozím nastavení je toto oprávnění automaticky uděleno každému hráči se statusem operátora serveru (OP).

Závěr

Plugin mcMMO Rewards je vynikajícím pomocným nástrojem pro servery Minecraft s RPG a survival prvky, které využívají systém dovedností mcMMO. Umožňuje snadno nastavit automatické udělování odměn za herní aktivitu bez nutnosti učit se složité skriptovací jazyky nebo používat těžkopádné skripty.

Ve srovnání se složitými skripty, jako je Skript (které vyžadují psaní vlastní syntaxe pro naslouchání událostem mcMMO), nebo s rozsáhlými questovými pluginy nabízí mcMMO Rewards systém, který je co nejjednodušší a nejrychlejší na nastavení a téměř nezatěžuje prostředky serveru. Jeho hlavním omezením však zůstává úplná závislost na nainstalovaném pluginu mcMMO a skutečnost, že příkazy lze spouštět pouze jménem konzole. Plugin je ideální pro servery, které chtějí rychle přidat jednoduché odměny za těžbu surovin nebo rozvoj bojových dovedností.