> For the complete documentation index, see [llms.txt](https://wiki.dyroxplays.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.dyroxplays.de/dailyrewards/konfiguration/eigene-belohnungen.md).

# 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`:

```yaml
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.

{% stepper %}
{% step %}

#### Slot & Permission wählen

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

{% step %}

#### Belohnungs-Befehle definieren

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

{% step %}

#### 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.
  {% endstep %}

{% step %}

#### YAML in config.yml eintragen

Trage die Sektion unter `rewards` in der `config.yml` ein und führe danach `/dailyrewards reload` aus.
{% endstep %}
{% endstepper %}