> 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/dailyquests/konfiguration.md).

# Konfiguration

Passe deine Quests, die Geld-Belohnungen, das GUI-Design, den Quest-Cooldown und die MySQL-Anbindung flexibel in der `config.yml` an.

***

## Dateiübersicht

Das Plugin erstellt nach dem ersten Serverstart folgende Datei:

* **`plugins/DailyQuests/config.yml`**: Verwaltet alle Einstellungen, Nachrichten und Quest-Items.

***

## Konfigurations-Bereiche

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

#### Allgemeine Optionen

```yaml
# Der Präfix vor Systemmeldungen
prefix: '&7[&9DailyQuests&7]'

# Cooldown (in Minuten), bevor Spieler neue Quests annehmen können (1440 = 24 Stunden)
cooldownmin: 1440

# Bei 'true' wird die Interaktion mit dem Villager-NPC als Quest-Abgabe gewertet
interactwithvillagerisdeliver: true
```

{% endtab %}

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

#### Datenbank-Optionen

```yaml
MySQL:
  enable: false
  host: localhost
  port: '3306'
  username: root
  database: db12
  password: password239239
```

* **`enable`**: Aktiviere MySQL, um Quest-Fortschritte und Cooldowns über mehrere Server hinweg abzugleichen.
  {% endtab %}

{% tab title="🪙 Währung" %}

#### Belohnungs-Befehle (Vault-Alternative)

```yaml
# Falls dein Economy-Plugin nur Ganzzahlen unterstützt
moneyCastToInt: false

# Befehle, die ausgeführt werden, um dem Spieler Geld zu geben/abzuziehen
AddMoneyCommand: eco give %player% %money%
RemoveMoneyCommand: eco take %player% %money%
```

{% endtab %}

{% tab title="🎨 GUI-Layout" %}

#### Menü-Design

```yaml
invname: '&9Quests'
invsize: 3 # Reihenanzahl (1-6)

# Hintergrund-Füllung
placeholder:
  material: STAINED_GLASS_PANE
  shortid: 7

# Slot-Belegung für die Quests (z. B. Slot 11)
questsslots:
- '11'
```

{% endtab %}
{% endtabs %}

***

## Menü-Gegenstände anpassen

Du kannst das Aussehen aller Menü-Gegenstände in der GUI anpassen:

```yaml
# Item, wenn die Quest erfolgreich beendet wurde
done:
  material: INK_SACK
  shortid: 10
  name: '&aAbgeschlossene Quests'
  lore:
  - '&7Diese Quests hast du bereits erfolgreich abgeschlossen'

# Item zum Abbrechen der Quest
cancel:
  name: '&cQuest abbrechen'
  lore:
  - '&cQuest abbrechen'
  slot: 15

# Item zum Anfordern einer neuen Quest
newquest:
  name: '&9Neue Quest anfordern'
  slot: 13
  lore:
  - '&7Nehme eine neue Quest an, um Belohungen zu erhalten'

# Item, wenn die Quest gesperrt ist (Cooldown aktiv)
waitquest:
  name: '&cDu musst dich noch gedulden!'
  slot: 13
  lore:
  - '&cDu kannst erst in %hour% Stunden %min% Minuten'
  - '&cund %sec% Sekunden wieder eine neue Quest annehmen'
```

***

## Quests erstellen (`quests`)

Unter dem Key `quests` definierst du deine Quests:

```yaml
quests:
  '1': # Quest ID
    material: LOG # Gefordertes Item-Material
    shortid: 0
    amount: 64 # Geforderte Item-Anzahl
    price: 100 # Geld-Belohnung (wird via AddMoneyCommand ausgezahlt)
    name: '&7Bringe 64 Eichenholz'
    lore:
    - '&aBringe mir 64 Eichenholz und erhalte 100$'
```

***

## Systemnachrichten

```yaml
messages:
  noperm: '&cDazu hast du keine Rechte.'
  fixdaily: '&a%player% hat nun eine neue Quest erhalten.'
  notonlne: '&cDer Spieler ist nicht online.'
  usage: '&cNutze: /fixdailyquest <Spieler>'
  success: '&aDu hast eine Quest erfolgreich abgeschlossen und hast %money% $ als Belohnung erhalten.'
  error: '&cDie Items sind nicht identisch.'
```
