Anleitung

So erstellst du ein Minecraft-Quest-Plugin

Aktualisiert am 18. Oktober 2026

Quests geben Spielern einen Grund zu spielen: 20 Zombies töten, 64 Eisen abbauen, einem Dorfbewohner 10 Brote bringen. Ein Quest-Plugin besteht aus drei Dingen: Zielen, die auf Spielereignisse hören, gespeichertem Fortschritt für jeden Spieler und Belohnungen. Wenn du Quests in einer Config-Datei definierst, kannst du neue hinzufügen, ohne den Code anzufassen.

Ersetze die Quests und Belohnungen durch deine eigenen.

Mit Codexe erstellen

Schritt für Schritt

  1. 1.Wähle die Zieltypen

    Fang mit wenigen an: einen Mob-Typ töten, Blöcke abbauen oder setzen, Items sammeln, craften, einen Ort erreichen, mit einem NPC sprechen. Jede Quest wird daraus gebaut.

  2. 2.Definiere Quests in einer Datei

    Jede Quest in quests.yml: eine ID, ein Name, eine Beschreibung, ihre Ziele mit Mengen, Belohnungen und Voraussetzungen (vorher eine andere Quest, eine Berechtigung, ein Level).

  3. 3.Verfolge den Fortschritt pro Spieler

    Hör auf die Events hinter jedem Ziel und erhöhe den Fortschritt des Spielers. Speichere ihn in SQLite oder einer Datei, damit er Ausloggen und Neustarts übersteht.

  4. 4.Zeige den Fortschritt an

    Ein Menü /quests mit aktiven und abgeschlossenen Quests, dazu eine Nachricht, ein Titel oder eine Bossbar, wenn sich der Fortschritt ändert.

  5. 5.Belohnungen vergeben

    Items, Erfahrung, Geld über Vault oder Konsolenbefehle wie lp user %player% permission set ... für alles andere.

  6. 6.Bauen und eine Quest im Spiel abschließen

    Lass Codexe kompilieren, tritt dem Testserver bei, nimm eine Quest an und schließ sie ab. Starte dann neu und prüfe, ob Fortschritt und Belohnungen gespeichert wurden.

Ziele und die Events dahinter

ZielEreignisZu klärendes Detail
Mobs tötenEntityDeathEventNur Kills des Spielers zählen oder auch die seiner Haustiere und Pfeile
Blöcke abbauenBlockBreakEventVom Spieler gesetzte Blöcke ignorieren, sonst setzen Spieler denselben Block immer wieder und bauen ihn ab
Items sammelnInventarprüfung oder Aufheben-EventOb die Items bei der Abgabe der Quest abgezogen werden
Items craftenCraftItemEventShift-Klick beim Craften stellt mehrere auf einmal her
Einen Ort erreichenPlayerMoveEventNur prüfen, wenn der Spieler den Block wechselt, nicht bei jeder Bewegung
Mit einem NPC sprechenPlayerInteractEntityEventWelche Entity der Questgeber ist

Questgeber

Der einfachste Questgeber ist ein Befehl oder ein Menü. Für eine Figur in der Welt reicht ein Dorfbewohner oder Rüstungsständer mit eigenem Namen und einem PersistentDataContainer-Tag, ganz ohne weitere Plugins: Das Plugin erkennt ihn, wenn ein Spieler ihn rechtsklickt. Wenn dein Server bereits ein NPC-Plugin wie Citizens nutzt, nenne es in der Anfrage, damit das Plugin sich daran anbindet.

Beispielbeschreibung

„Ein Quest-Plugin für Paper 1.21.4 namens Quests. Zieltypen: Mobs töten, Blöcke abbauen (nicht von Spielern gesetzt), Items sammeln und mit einem als Questgeber markierten Dorfbewohner sprechen. Quests in quests.yml definiert, mit Name, Zielen, vorausgesetzter Quest und Belohnungen (Items, Erfahrung, Vault-Geld, Konsolenbefehle). /quests öffnet ein Menü mit verfügbaren, aktiven und abgeschlossenen Quests. Fortschritt in der Actionbar angezeigt. Bis zu 3 aktive Quests. Tägliche Quests werden um Mitternacht Serverzeit zurückgesetzt. Fortschritt in SQLite gespeichert.“

Tägliche und wiederholbare Quests

  • Gib an, wann sie zurückgesetzt werden: jeden Tag zu einer festen Uhrzeit oder 24 Stunden, nachdem der Spieler sie abgeschlossen hat.
  • Gib an, ob tägliche Quests für jeden Spieler zufällig oder für alle gleich sind.
  • Speichere den Zeitpunkt des letzten Abschlusses, kein Flag, damit das Zurücksetzen auch funktioniert, während der Server aus ist.

Fragen

Können Quests PlaceholderAPI nutzen?

Ja. Verlange Platzhalter wie die aktive Quest und ihren Fortschritt, damit Scoreboards und Tab-Listen sie anzeigen können. Nenne PlaceholderAPI in der Anfrage, damit es als Abhängigkeit hinzugefügt wird.

Kann ich Quests mit Skript schreiben?

Kleine Quest-Systeme passen in ein Skript mit Variablen. Viele Zieltypen, Menüs und gespeicherter Fortschritt für Hunderte Spieler lassen sich in einem Plugin leichter schnell und übersichtlich halten.

Wie prüfe ich, ob die Quests funktionieren?

Spiel sie auf dem Codexe-Testserver und füge Tests in deinen eigenen Worten hinzu, zum Beispiel „ein normaler Spieler führt /quests aus und sieht, wie sich ein Menü öffnet“. Tests prüfen Nachrichten, Items und Menüs, nicht Mobs oder Blöcke in der Welt.

Erstelle dein Quest-Plugin

Dieser Prompt öffnet sich versandfertig:

“Ein Quest-Plugin für Paper 1.21.4: Zieltypen Mobs töten, nicht von Spielern gesetzte Blöcke abbauen, Items sammeln und mit einem markierten Dorfbewohner sprechen; Quests in quests.yml mit Zielen, vorausgesetzter Quest und Belohnungen (Items, XP, Vault-Geld, Konsolenbefehle); Menü /quests mit verfügbaren, aktiven und abgeschlossenen Quests; Fortschritt in der Actionbar; max. 3 aktive Quests; tägliche Quests werden um Mitternacht zurückgesetzt; Fortschritt in SQLite gespeichert.”

Mit Codexe erstellen
So erstellst du ein Minecraft-Quest-Plugin | Codexe