Anleitung
So erstellst du ein Minecraft-Minigame-Plugin
Aktualisiert am 18. Oktober 2026
Ein Minigame-Plugin führt Runden aus: Spieler warten in einer Lobby, ein Countdown startet, das Spiel läuft nach seinen eigenen Regeln, jemand gewinnt und die Arena wird für die nächste Runde zurückgesetzt. Jedes Minigame, von Spleef bis Bed Wars, hat dasselbe Grundgerüst. Stimmt das, sind die Spielregeln der einfache Teil.
Starte mit diesem Beispiel und passe die Regeln an.
Mit Codexe erstellenSchritt für Schritt
1.Schreibe die Regeln einer Runde auf
Wie viele Spieler, wie eine Runde beginnt und endet, wie man gewinnt, was beim Tod passiert (raus, Respawn, Zuschauer) und was Spieler zu Beginn bekommen.
2.Plane die Einrichtung der Arena
Admin-Befehle, um eine Arena zu erstellen und ihre Lobby, Spawnpunkte und Grenzen festzulegen, zum Beispiel
/mg create <name>und/mg setspawn <name>. Arenen werden in einer Datei gespeichert, damit sie Neustarts überstehen.3.Lege die Spielzustände fest
Warten, Start (Countdown), Spiel und Ende. In jedem Zustand ist etwas anderes erlaubt: In der Lobby baut niemand Blöcke ab, und niemand tritt einem laufenden Spiel bei.
4.Entscheide, wie die Arena zurückgesetzt wird
Merke dir die während der Runde veränderten Blöcke und mach sie rückgängig, oder lade eine Kopie einer Vorlagenwelt neu. Ohne Zurücksetzen beginnt die zweite Runde auf einer kaputten Map.
5.Ergänze, was Spieler sehen
Ein Sidebar-Scoreboard mit verbleibenden Spielern und Zeit, eine Bossbar oder Titel für den Countdown und Chatnachrichten für Kills und den Gewinner.
6.Generieren, bauen und eine Runde spielen
Beschreibe es Codexe, lass es kompilieren und tritt dann mit Jetzt testen dem Testserver bei. Setze die Mindestspielerzahl beim Testen niedrig, damit eine Runde starten kann.
Die Spielzustände
Die meisten Minigame-Bugs entstehen, wenn Spieler im falschen Zustand etwas tun. Wenn du die Zustände in die Anfrage schreibst, baut die KI das Plugin um sie herum.
| Zustand | Was passiert | Typische Regeln |
|---|---|---|
| Warten | Spieler betreten die Lobby | Kein Schaden, kein Abbauen von Blöcken, Verlassen per Item oder Befehl |
| Wird gestartet | Countdown, sobald das Minimum erreicht ist | Countdown stoppt, wenn so viele Spieler gehen, dass das Minimum unterschritten wird |
| Spiel | Die Spielregeln gelten | Kein Beitreten, Tode scheiden aus oder führen zum Respawn, Verlassen zählt als Niederlage |
| Ende | Gewinner wird verkündet, Belohnungen werden vergeben | Spieler werden nach ein paar Sekunden zurückgeschickt, Arena wird zurückgesetzt |
Die Arena zurücksetzen
- Änderungen aufzeichnen und rückgängig machen: Speichere jeden Block, bevor er sich während der Runde ändert, und setze ihn am Ende zurück. Schnell bei kleinen Arenen, in denen Spieler nur wenige Blöcke abbauen oder setzen.
- Vorlagenwelt: Bewahre eine saubere Kopie der Map auf, entlade die bespielte Welt nach der Runde und kopiere die Vorlage darüber. Einfach und zuverlässig für Maps, die zerstört werden.
- Keine Änderungen erlaubt: Bei Spielen wie Parkour oder PvP-Duellen werden Blockänderungen komplett abgebrochen, und es muss nichts zurückgesetzt werden.
Beispielbeschreibung
„Ein Spleef-Minigame-Plugin für Paper 1.21.4. Admins erstellen Arenen mit /spleef create <name>, /spleef setlobby und /spleef setfloor (die zwei Ecken des Schneebodens). Spieler treten mit /spleef join <arena> bei. Die Runde startet 15 Sekunden, nachdem 2 Spieler drin sind, bis zu 8. Spieler bekommen eine Diamantschaufel, bauen Schnee sofort ab und scheiden aus, wenn sie unter den Boden fallen. Der letzte Spieler gewinnt 50 Coins über Vault. Ausgeschiedene Spieler werden Zuschauer. Der Schneeboden wird nach jeder Runde wiederhergestellt. Sidebar mit verbleibenden Spielern und Zeit. Arenen in arenas.yml gespeichert, Mindestspielerzahl und Belohnungen in der config.yml.“
Ein Minigame testen
Ein Minigame lässt sich am Code schwer beurteilen: Du musst eine Runde spielen. Jetzt testen startet einen privaten Paper-Server deiner Version mit installiertem Plugin, meist in einer flachen Welt, und Freunde können beitreten, wenn du sie unter Serverzugang hinzufügst. Im kostenlosen Tarif sind 2 Personen auf einem Testserver erlaubt, bei Pro 5, bei Business 10 und bei Enterprise 20.
Lass die Mindestspielerzahl in die config.yml legen, damit du sie beim Testen auf 1 oder 2 setzen kannst. Auch Testspieler können beitreten, die Beitritts- und Admin-Befehle ausführen und die Nachrichten prüfen. So findest du kaputte Befehle, bevor du spielst.
Fragen
Eine Arena oder viele?
Verlange von Anfang an mehrere Arenen. Ein Plugin mit einer Arena später auf mehrere umzustellen heißt, neu zu schreiben, wie Spieler und Spielzustand gespeichert werden.
Kann ich ein 1.8-PvP-Minigame erstellen?
Ja. Schreib Spigot oder Paper 1.8.8 in die Anfrage: Codexe schreibt den Code für diese ältere API, und Testserver laufen mit Versionen von 1.8 bis 26.3.
Wie funktionieren Minigame-Netzwerke?
Große Netzwerke betreiben jedes Spiel auf einem eigenen Server hinter einem BungeeCord- oder Velocity-Proxy, mit einem Lobby-Server, der Spieler in ein freies Spiel schickt. Das sind ein Proxy-Plugin und ein Spiel-Plugin, als zwei Projekte.
Baue dein Minigame
Dieser Prompt öffnet sich versandfertig:
“Ein Spleef-Minigame-Plugin für Paper 1.21.4: Arenen werden mit /spleef create, setlobby und setfloor erstellt, Spieler treten mit /spleef join bei, die Runde startet 15 Sekunden nach 2 Spielern (max. 8), Diamantschaufeln, raus beim Fallen unter den Boden, der letzte Spieler gewinnt 50 Coins über Vault, Zuschauermodus für Ausgeschiedene, Schneeboden nach jeder Runde wiederhergestellt, Sidebar mit verbleibenden Spielern und Zeit, Arenen in arenas.yml gespeichert.”
Mit Codexe erstellen