🐎Eigene Quests

In diesem Guide lernst du, wie du eigene tägliche Lieferquests für das DailyQuests-Plugin erstellst und anpasst.

---

Grundlagen des Quest-Systems

Das Questsystem funktioniert auf Basis von Abgabe-Quests (Delivery Quests):

1. Das System wählt zufällig eine konfigurierte Quest aus und zeigt sie dem Spieler in der GUI an.

2. Der Spieler muss das geforderte Item sammeln (mit genau passendem Namen, Lore und Verzauberung).

3. Durch Anklicken der Quest im Menü (oder per Linksklick mit dem Item) gibt der Spieler die Quest ab und erhält die konfigurierte Belohnung (Geld/Tokens).

---

Konfigurations-Struktur

Jede Quest wird in der config.yml unter dem Hauptschlüssel quests definiert. Die Quests werden fortlaufend nummeriert (z. B. '1', '2', '3').

quests:
  '1':
    material: 'MATERIALNAME'   # Minecraft-Material (z.B. DIAMOND, STONE)
    amount: 1                  # Anzahl der geforderten Gegenstände
    shortid: 0                 # Sub-ID (wichtig für ältere Versionen, z.B. Wolle-Farben)
    price: 150                 # Belohnung (Geld/Tokens) bei Abgabe
    name: 'Anzeigename'         # Custom Name des Items (optional)
    lore:                      # Custom Lore des Items (optional)
      - '&7Zeile 1'
    ench:                      # Custom Verzauberungen (optional)
      - 'ENCHANTMENT_NAME;STUFE' # Format: Name;Stufe (z.B. DURABILITY;3)

---

Item-Vergleichsregeln beim Abgeben

Wenn ein Spieler ein Item abgibt, vergleicht das Plugin das Inventar-Item mit dem konfigurierten Quest-Item. Dabei gilt:

• ✅ Material und Sub-ID (shortid) müssen übereinstimmen.

• ✅ Anzeigename (Display Name) und Lore (Beschreibung) müssen exakt übereinstimmen (inklusive aller Farbcodes).

• ✅ Verzauberungen müssen exakt übereinstimmen.

• ❌ Die Menge (Amount) wird nicht auf exakte Übereinstimmung geprüft; der Spieler muss mindestens die geforderte Menge besitzen, überschüssige Items bleiben erhalten.

---

Schritt-für-Schritt-Anleitung: Neue Quest hinzufügen

Hier siehst du, wie du beispielsweise eine Quest für das Abliefern von 5 verzauberten Diamantschwertern erstellst.

1

Quest-ID wählen

Finde die nächste freie Nummer unter quests (z. B. '4').

2

Material & Belohnung konfigurieren

Als Material wählen wir DIAMOND_SWORD. Die Belohnung soll 1000 Coins betragen.

3

Verzauberungen & Namen bestimmen

Wir möchten, dass der Spieler ein Schwert mit Schärfe V (DAMAGE_ALL;5) und Haltbarkeit III (DURABILITY;3) abliefern muss. Der Name soll &bKriegsklinge lauten.

4

YAML in config.yml eintragen

Füge den Block zu deiner config.yml hinzu:

quests:
  '4':
    material: DIAMOND_SWORD
    amount: 1
    shortid: 0
    price: 1000
    name: '&bKriegsklinge'
    lore:
      - '&7Eine geschmiedete Waffe'
      - '&7für die tägliche Quest.'
    ench:
      - 'DAMAGE_ALL;5'
      - 'DURABILITY;3'