💸Eigene Belohnungen

In diesem Guide lernst du, wie du eigene tägliche Belohnungen (Daily Rewards) für Standard- und Premium-Spieler (VIPs) in deinem DailyRewards-Plugin konfigurierst.

---

Grundlagen des Belohnungssystems

Belohnungen werden in einem GUI-Menü auf bestimmten Slots angezeigt. Du definierst für jede Belohnung:

1. Den Slot-Index: Bestimmt die Position im Menü (z. B. Slot 10).

2. Den Cooldown: Wartezeit in Sekunden (z. B. 86400 für 24 Stunden), bis die Belohnung wieder abgeholt werden kann.

3. Ausgeführte Befehle (cmds): Eine Liste von Konsolenbefehlen, die bei Beanspruchung ausgeführt werden (z. B. Geld oder Items geben).

4. Den Permission-Schutz: Optional kannst du Belohnungen an Berechtigungen binden.

---

Die drei Item-Zustände

Um dem Spieler das passende Icon im Menü anzuzeigen, benötigt jede Belohnung Definitionen für verschiedene Zustände:

• claimable (Bereit zum Abholen): Das Item, das angezeigt wird, wenn der Cooldown abgelaufen ist und der Spieler die Belohnung abholen darf.

• claimed (Bereits abgeholt / Cooldown): Das Item, das während des Cooldowns angezeigt wird. Hierbei werden Platzhalter wie %hour%, %min% und %sec% automatisch durch die Restzeit ersetzt.

• blocked (Gesperrt / Keine Rechte): Das Item, das angezeigt wird, wenn die Belohnung eine Permission erfordert, die der Spieler nicht besitzt.

---

Konfigurations-Beispiel

Hier ist ein komplettes Beispiel für zwei Belohnungs-Typen in der config.yml:

rewards:
  # -------------------------------------------------------------
  # 1. Standard-Belohnung (für alle Spieler)
  # -------------------------------------------------------------
  '10':
    permission: ''                # Keine Permission nötig
    cooldown: 86400               # 24 Stunden Cooldown
    cmds:
      - 'eco give %player% 1000'  # Gibt dem Spieler 1.000 Coins
    claimable:
      material: OAK_LOG
      amount: 1
      name: '&aTägliche Holzfäller-Belohnung'
      lore:
        - '&7Belohnung: &b1000 Coins'
        - '&aKlicke zum Abholen!'
    claimed:
      material: BOWL
      amount: 1
      name: '&7Belohnung bereits abgeholt'
      lore:
        - '&cBereits abgeholt!'
        - '&7Nächste Abholung in: &e%hour%h %min%m %sec%s'

  # -------------------------------------------------------------
  # 2. Premium-Belohnung (nur mit Permission)
  # -------------------------------------------------------------
  '13':
    permission: 'dailyrewards.premium' # Benötigt Berechtigung
    cooldown: 86400
    cmds:
      - 'eco give %player% 2500'
      - 'give %player% diamond 5'
    claimable:
      material: DIAMOND_BLOCK
      amount: 1
      name: '&6&lPremium Belohnung'
      lore:
        - '&7Belohnung: &b2500 Coins & &b5 Diamanten'
        - '&aKlicke zum Abholen!'
    claimed:
      material: COAL_BLOCK
      amount: 1
      name: '&7Premium Belohnung abgeholt'
      lore:
        - '&cBereits abgeholt!'
        - '&7Nächste Abholung in: &e%hour%h %min%m %sec%s'
    blocked:
      material: BARRIER
      amount: 1
      name: '&c&lPremium Belohnung'
      lore:
        - '&cNur für VIP-Spieler!'
        - '&7Kaufe VIP, um diese Belohnung freizuschalten.'

---

Schritt-für-Schritt-Anleitung: Neue VIP-Belohnung anlegen

Hier siehst du, wie du eine neue exklusive Belohnung erstellst.

1

Slot & Permission wählen

Bestimme einen freien Slot im Menü (z. B. Slot 16) und wähle eine Permission (z. B. dailyrewards.vip).

2

Belohnungs-Befehle definieren

Welche Befehle sollen ausgeführt werden? Zum Beispiel: give %player% iron_ingot 10

3

Item-Icons & Texte entwerfen

• Für claimable nehmen wir einen IRON_BLOCK mit grünem Text.

• Für claimed nehmen wir einen IRON_ORE mit der verbleibenden Cooldown-Zeit.

• Für blocked nehmen wir eine BARRIER mit rotem Hinweis.

4

YAML in config.yml eintragen

Trage die Sektion unter rewards in der config.yml ein und führe danach /dailyrewards reload aus.