mcMMO Rewards: Das Plugin für Level-Belohnungen in Minecraft im Überblick

Das beliebte RPG-System mcMMO bringt Skill-Leveling-Mechaniken auf Minecraft-Server – etwa Angeln, Bergbau oder Kräuterkunde. Die Entwickler des Original-Plugins haben jedoch kein flexibles System vorgesehen, um beim Erreichen bestimmter Level automatisch Items, Währung oder eigene Titel zu vergeben. Genau dieses Problem löst die Erweiterung mcMMO Rewards. Sie verknüpft das Levelsystem von mcMMO mit Server-Konsolenbefehlen und ermöglicht es Serverbetreibern, automatische Belohnungen für aktive Spieler einzurichten, ohne komplexe Skripte zu schreiben.

Event-Verarbeitung und API-Integration

mcMMO Rewards funktioniert als schlanker Event Listener, der sich direkt in den Kern des Spigot/Paper-Servers einklinkt und mit der offiziellen API des mcMMO-Plugins kommuniziert.

Abfangen des Events McMMOPlayerLevelUpEvent

Jedes Mal, wenn ein Spieler in einem beliebigen Skill aufsteigt (etwa durch Erzabbau oder Ernten), löst mcMMO das Event McMMOPlayerLevelUpEvent aus. mcMMO Rewards fängt dieses Event ab und führt folgenden Ablauf aus:

1. Liest den Namen des Skills und das neue Level, das der Spieler erreicht hat.

2. Gleicht diese Daten mit den in der Konfigurationsdatei config.yml hinterlegten Belohnungslisten ab.

3. Wird eine Übereinstimmung gefunden, führt das Plugin im Namen der Konsole die konfigurierte Befehlsliste aus und ersetzt dabei den Platzhalter %player% durch den Spielernamen.

Wichtige Einschränkungen der Event-Verarbeitung

Da das Plugin ausschließlich an das Event McMMOPlayerLevelUpEvent gebunden ist, reagiert es nur auf natürliche Level-Ups während des Spiels. ⚠️ Level-Resets und Datenbankänderungen: Ändert ein Administrator das Level eines Spielers direkt über die SQLite/MySQL-Datenbankdateien (etwa bei einer Statistik-Migration oder einem Wipe) oder verwendet er Konsolenbefehle, die den Levelwert ändern, ohne das Standard-Level-Up-Event auszulösen, werden keine Belohnungen ausgelöst. Zudem unterstützt das Plugin keine rückwirkende Vergabe von Belohnungen: Hatte ein Spieler bereits vor der Installation von mcMMO Rewards Level 50 erreicht, erhält er keine Belohnungen für die zuvor erreichten Level (10, 20 usw.), bis er das nächste Level erreicht.

Struktur der config.yml und Einrichtung der Belohnungen

Alle Belohnungen werden in einer einzigen Konfigurationsdatei definiert, plugins/mcMMORewards/config.yml. Dank der einfachen YAML-Syntax können Entwickler schnell mehrstufige Belohnungssysteme aufbauen.

Beschreibung der Konfigurationssyntax

Jeder Belohnungsblock folgt einer strengen Hierarchie:

• Skill-Name: muss dem offiziellen Skill-Namen in mcMMO entsprechen (zum Beispiel mining, woodcutting, swords, herbalism).

• Level: eine Ganzzahl – das Level, bei dessen Erreichen die Befehle ausgeführt werden.

• Befehlsliste: die Liste der Konsolenaktionen. Ein führender Schrägstrich / vor den Befehlen ist nicht nötig, da alle Befehle direkt vom Server im Namen der Konsole (OP-Ebene) ausgeführt werden.

Beispiel-Konfigurationsdatei

Nachfolgend ein Beispiel für eine korrekt strukturierte Datei zur Vergabe von Items und 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 diesem Beispiel erhält der Spieler %player% beim Erreichen von Level 10 im Skill mining Eisenbarren, und es wird eine Nachricht an den gesamten Server gesendet. Bei Level 50 erhält der Spieler 1000 Einheiten Währung über ein Wirtschafts-Plugin (zum Beispiel EssentialsX) sowie 3 Diamanten.

Plugin verwalten: Befehle und Berechtigungen

Da mcMMO Rewards eine sehr kompakte Erweiterung ist, beschränkt sich die Liste seiner Befehle und Berechtigungen ausschließlich auf administrative Funktionen.

Befehl zum Neuladen der Konfiguration

Um Änderungen an der Datei config.yml zu übernehmen, muss der gesamte Minecraft-Server nicht neu gestartet oder der Spielbetrieb unterbrochen werden. Es genügt der Befehl: /mcmmorewards reload Dieser Befehl entlädt die alten Einstellungen aus dem Arbeitsspeicher des Servers und liest die Konfigurationsdatei neu ein, wodurch die neuen Belohnungen sofort angewendet werden.

Berechtigungen für Administratoren (Permissions)

Aus Sicherheitsgründen ist die Ausführung des Reload-Befehls auf eine spezielle Berechtigung (Permission Node) beschränkt. Normale Spieler haben keinen Zugriff auf diesen Befehl. Um einem Admin oder Moderator die Rechte zu erteilen (zum Beispiel über LuckPerms), verwende folgenden Knoten: mcmmorewards.reload Standardmäßig wird diese Berechtigung automatisch an alle Spieler mit Server-Operator-Status (OP) vergeben.

Fazit

mcMMO Rewards ist ein hervorragendes Hilfswerkzeug für Minecraft-Server mit RPG- und Survival-Elementen, die das mcMMO-Skillsystem nutzen. Es ermöglicht die einfache Einrichtung automatischer Belohnungen für Spielaktivität, ohne komplexe Skriptsprachen erlernen oder schwergewichtige Skripte einsetzen zu müssen.

Im Vergleich zu komplexen Skripten wie Skript (die das Schreiben eigener Syntax zum Abhören von mcMMO-Events erfordern) oder umfangreichen Quest-Plugins bietet mcMMO Rewards ein System, das sich denkbar einfach und schnell einrichten lässt und dabei kaum Serverressourcen beansprucht. Die vollständige Abhängigkeit vom installierten mcMMO-Plugin sowie die Beschränkung, dass Befehle nur im Namen der Konsole ausgeführt werden können, sind jedoch die Hauptgrenzen. Das Plugin eignet sich perfekt für Server, die schnell einfache Belohnungen für das Sammeln von Ressourcen oder das Aufleveln von Kampf-Skills hinzufügen möchten.