⚙️ **Quests**

-----

{{ :wiki:plugins.png?nolink&400 |}}

-----

====⚙️ Quests====

=== Beschreibung ===
Quests ist ein kostenloses, hochgradig konfigurierbares Plugin, mit dem Spieler Aufgaben, Geschichten und Belohnungen erhalten können – einzeln oder in Reihen.  
Es unterstützt mehrere Questtypen (Töten, Suchen, Sammeln, NPC-Gespräche) und kann nahtlos mit Plugins wie **ZNPCsPlus**, **Vault** und **MythicMobs** kombiniert werden.  
Durch Quests können umfangreiche Abenteuer oder Fortschrittssysteme auf dem Server umgesetzt werden.

=== Installation ===
  * Eintrag in //mods.txt//:
  * Server neu starten  
  * Ab sofort steht // /quests// und // /questsadmin// zur Verfügung

=== Befehle ===
  * // /quests// – Questübersicht für Spieler
  * // /quests editor// – GUI-Editor für Questerstellung
  * // /questsadmin// – Adminbefehle (z. B. Spielerfortschritt löschen, Quests zurücksetzen)
  * // /quests give <Name>// – Startet eine bestimmte Quest für einen Spieler
  * // /quests journal// – Zeigt aktiven Questfortschritt im Chat

=== Editor ===
Der GUI-Editor erlaubt:
  * Start-Trigger (NPC, Block, Befehl, Auto-Start)
  * Ziele:
    * Töte Mobs
    * Erreiche Koordinaten
    * Liefere Items
    * Spreche mit NPC (via ZNPCsPlus)
    * Custom-Kommandos
  * Belohnungen:
    * Items
    * XP
    * Geld (Vault erforderlich)
    * Ausführen von Befehlen
    * Nachrichtensendungen (z. B. an alle Spieler)

=== Questtypen ===
  * 🧟 **Töte Mobs** – Standard oder MythicMobs  
  * 🎯 **Erreiche Koordinaten** – Ideal für Exploration  
  * 📦 **Liefere Items** – Mit Mengenprüfung  
  * 🧑 **Spreche mit NPC** – Integration mit ZNPCsPlus  
  * 💬 **Custom-Kommandos** – Z. B. Effekte, Teleports

=== Integration ===
  * **ZNPCsPlus**: NPCs als Questgeber  
  * **Vault**: Geldbelohnungen und Wirtschaftsintegration  
  * **MythicMobs**: Individuelle Gegner als Questziele  
  * **WorldGuard**: Zonenbasierte Questziele möglich (Region-Betreten)

=== Speicherorte ===
  * // plugins/Quests/quests.yml// – Hauptquestdaten  
  * // plugins/Quests/players.yml// – Spielerfortschritt  
  * // plugins/Quests/actions.yml// – Globale Aktionen  
  * **Backup-Tipp:** regelmäßig alle //.yml//-Dateien sichern

=== Tipps ===
  * Mit **delay** in Belohnungen Effekte zeitversetzt auslösen
  * //require//-Funktion nutzen, um Questreihen logisch zu verbinden
  * Belohnungen können mehrere Befehle enthalten (Portale, Ränge, Events)
  * Verwende optionale Quests, um Nebenmissionen zu erstellen
  * Nutze **PlaceholderAPI** für dynamische Nachrichten und Belohnungen

=== Beispielbelohnung ===

<code>
rewards:
  items:
    - material: DIAMOND
      amount: 3
    - material: EMERALD
      amount: 5
  experience: 500
  money: 100
  commands:
    - "say Gut gemacht, %player%!"
    - "warp belohnung"
  message: "&aDu hast die Quest erfolgreich abgeschlossen!"
</code>

-----
⬅️ [[..|zurück]]