> 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.md).

# Konfiguration

Passe die GUI-Größen, Soundeffekte, MySQL-Anbindungen und deine täglichen Belohnungen (inkl. Premium-Ränge-Berechtigungen) flexibel in der Konfigurationsdatei an.

***

## Dateiübersicht

Das Plugin erstellt nach dem ersten Serverstart folgende Datei:

* **`plugins/DailyRewards/config.yml`**: Steuert alle globalen Einstellungen, Nachrichten und die genauen Belohnungs-Items.

***

## Konfigurations-Bereiche

{% tabs %}
{% tab title="⚙️ Basis-Einstellungen" %}

#### Allgemeine Optionen

```yaml
# Der Präfix vor Systemmeldungen im Chat
prefix: '&7[&9Daily&6Rewards&7]'

# Ermöglicht das Öffnen des Menüs per Befehl
dailyrewardscmd: true

# Cooldown (in Sekunden) gegen GUI-Klick-Spam
clickslotcooldownsec: 300
```

{% endtab %}

{% tab title="🗄️ MySQL" %}

#### Datenbank-Optionen

```yaml
MySQL:
  enable: false
  host: localhost
  port: '3306'
  username: user
  database: db
  password: password123
```

* **`enable`**: Bei `true` werden die Beanspruchungs-Zeiten der Spieler in der MySQL-Datenbank gespeichert. Perfekt für Netzwerke mit mehreren Unterservern.
  {% endtab %}

{% tab title="🎨 GUI & Sound" %}

#### Kosmetische Optionen

```yaml
# Menü-Design
gui:
  name: '&7Tägliche Belohnung'
  lenght: 3 # Reihenanzahl (1-6)

# Name des Villager-NPCs
villagername: '&6Tägliche Belohnung'

# Sound beim Beanspruchen einer Belohnung
buysound: ENTITY_PLAYER_LEVELUP
```

{% endtab %}
{% endtabs %}

***

## Belohnungen konfigurieren (`rewards`)

Unter dem Key `rewards` definierst du die einzelnen Belohnungs-Slots. Jeder Slot-Eintrag kann drei Zustände haben:

1. **`claimable`**: Das Item, wenn die Belohnung bereit zum Abholen ist.
2. **`claimed`**: Das Item, wenn sich die Belohnung im Cooldown befindet.
3. **`blocked`** *(Optional)*: Das Item, wenn der Spieler nicht die nötige Permission besitzt.

### Konfigurations-Beispiele:

{% tabs %}
{% tab title="Standard-Belohnung" %}

```yaml
rewards:
  '10': # Slot 10 (Zweite Reihe, zweites Feld)
    permission: '' # Keine Berechtigung nötig
    cooldown: 86400 # 24 Stunden Cooldown in Sekunden
    cmds: # Ausgeführte Befehle
    - eco give %player% 1000
    claimed:
      material: OAK_LOG
      shortid: 0
      amount: 1
      name: '&7Coin-Belohnung'
      lore:
      - '&cGesperrt'
      - '&7Bereit in: &e%hour%h %min%m %sec%s'
    claimable:
      material: OAK_LOG
      shortid: 0
      amount: 1
      name: '&7Coin-Belohnung'
      lore:
      - '&b1000 Coins'
      - '&aKlicke zum Abholen!'
```

{% endtab %}

{% tab title="Premium-Belohnung (mit Permission)" %}

```yaml
  '13': # Slot 13
    permission: dailyrewards.premium # Erforderliche Permission
    cooldown: 86400
    cmds:
    - eco give %player% 2500
    blocked: # Anzeige, wenn Spieler KEINE Permission hat
      material: BARRIER
      shortid: 0
      amount: 1
      name: '&6Premium-Belohnung'
      lore:
      - '&cNur für Premium-Spieler!'
    claimed:
      material: OAK_LOG
      shortid: 0
      amount: 1
      name: '&6Premium-Belohnung'
      lore:
      - '&cGesperrt'
      - '&7Bereit in: &e%hour%h %min%m %sec%s'
    claimable:
      material: OAK_LOG
      shortid: 0
      amount: 1
      name: '&6Premium-Belohnung'
      lore:
      - '&b2500 Coins'
      - '&aKlicke zum Abholen!'
```

{% endtab %}
{% endtabs %}

***

## Systemnachrichten

Am Ende der Datei können die Ausgaben angepasst werden:

```yaml
messages:
  noperm: '&cDazu hast du keine Rechte'
```