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

# Konfiguration

Passe das GUI-Design, die täglichen Spielzeitanforderungen, die MySQL-Anbindung und die Belohnungen für jedes Türchen flexibel in der `config.yml` an.

***

## Dateiübersicht

Das Plugin erstellt nach dem ersten Serverstart folgende Datei:

* **`plugins/Adventskalender/config.yml`**: Steuert alle Einstellungen, die Belohnungen der 24 Türchen und die finale Belohnung (Tag 25).

***

## Konfigurations-Bereiche

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

#### Globale Einstellungen

```yaml
# Der Präfix vor Systemnachrichten
prefix: '&7[&cAdvents&2Kalender&7]'

# Ermöglicht das Öffnen des Kalenders per Befehl /adventskalender
allowcmd: false

# Cooldown (in Sekunden), ab wann ein Spieler als AFK gewertet wird (Spielzeit pausiert)
afkchecksec: 300

# Gibt an, wie viele Tage verpasste Türchen rückwirkend geöffnet werden dürfen (0 = nur am selben Tag, 24 = unbegrenzt)
retroactivedays: 24

# Loggt das Öffnen von Türchen in die Serverkonsole
logtoconsoleonopenday: true
```

{% 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-Daten der Spieler in einer MySQL-Datenbank gespeichert. Dies ist ideal, falls du dieselben Daten über mehrere Server synchronisieren möchtest.
  {% endtab %}

{% tab title="☃️ GUI & NPC" %}

#### Optische Einstellungen

```yaml
# Menü-Design
gui:
  name: '&cAdvents&2Kalender'
  lenght: 3 # Reihenanzahl der GUI (1-6) - Schreibweise im Code beachten!
  
  # Optionale, statische Dekorations-Items in der GUI
  items:
    deko_links:
      material: OAK_LEAVES
      slot: 10
      name: '&aTannenzweig'
      lore:
      - '&7Ein schönes dekoratives Element'
    deko_rechts:
      material: RED_WOOL
      slot: 16
      name: '&cWeihnachtskugel'
      lore:
      - '&7Bringt festliche Stimmung'

# Texte für die Item-Zustände im Menü
lore:
  openable: '&aUngeöffnet'
  opened: '&7Bereits geöffnet'
  notnow: '&cDieser Tag kann noch nicht geöffnet werden'
  outdated: '&cAbgelaufen'
  playtime: '&7Spielzeit: &e%advent_ptdayhave% &7/ %advent_ptdayneed%'

# Kosmetische Einstellungen für den NPC-Schneemann
snowmanname: '&cAdvents&2Kalender'
achievesound: ENTITY_PLAYER_LEVELUP
```

{% endtab %}
{% endtabs %}

***

## Platzhalter im GUI definieren (`placeholder`)

Du kannst dekorative Glasscheiben im Menü platzieren, um die Türchen optisch einzurahmen.

```yaml
placeholder:
  enable: true
  RED_STAINED_GLASS_PANE;0: 0;2;4;6;8;18;26;36;38;42;44;46;48;50;52
  WHITE_STAINED_GLASS_PANE;0: 1;3;5;7;9;17;27;35;37;43;45;47;49;51;53
```

* **Format**: `MATERIAL;SHORTID: Slot-Listen (durch Semikolons getrennt)`

***

## Türchen konfigurieren (`adventskalender`)

Jedes der 24 Türchen kann einzeln konfiguriert werden.

### Konfigurations-Beispiel (Tag 1):

```yaml
adventskalender:
  '1': # Tag 1
    minplaytimeinminutes: 30 # Benötigte tägliche Onlinezeit in Minuten
    cmds: # Ausgeführte Befehle nach erfolgreichem Öffnen
    - give %player% STONE 1
    - adventmsg %player% &aDu hast erfolgreich Türchen &e#1 &ageöffnet
    item: # Darstellung des Türchens im GUI
      material: ACACIA_DOOR
      shortid: 0
      amount: 1
      slot: 0 # Slot im Menü
      name: '&aTürchen &e#1'
      lore:
      - ' '
      - '&7%status%' # Platzhalter für die definierten Lore-Zustandstexte
```

* **`cmds`**: Unterstützt den integrierten Befehl `adventmsg %player% <Nachricht>`, um farbige Nachrichten ohne standardmäßige Systempräfixe an den Spieler zu senden.

***

## Finale Belohnung (Tag 25)

Die finale Belohnung wird freigeschaltet, wenn ein Spieler alle 24 Türchen geöffnet hat.

```yaml
finalreward:
  enable: true
  day: 25
  item:
    material: GOLD_BLOCK
    name: '&aFinale Belohnung'
    lore:
    - ''
    - '&aSei jeden Tag dabei und öffne'
    - '&atäglich die Truhen, um am Ende'
    - '&ediese Extra-Tür öffnen zu können!'
    amount: 1
    slot: 26
  cmds:
  - give %player% GOLD_BLOCK 3
  - adventmsg %player% &aHerzlichen Glückwunsch! Du hast die finale Belohnung erhalten!
```

***

## Systemnachrichten

```yaml
messages:
  noperm: '&cDazu hast du keine Rechte'
  usage: '&cNutze: /adventskalender reload oder /adventskalender setentity oder /adventskalender <ban/unban> <Spieler>'
  notreachedplaytime: '&cDu hast deine Onlinezeit für diesen Tag noch nicht erreicht, aktueller Stand: %have% / %need% Minuten'
  ban:
    isban: '&c%player% ist vom Adventskalender bereits ausgeschlossen'
    notbanned: '&c%player% ist vom Adventskalender nicht ausgeschlossen'
    ban: '&a%player% ist nun vom Adventskalender ausgeschlossen'
    unban: '&a%player% kann nun wieder beim Adventskalender mitmachen'
    yourbanned:
    - '&cDu bist vom Adventskalender ausgeschlossen!'
  finalreward:
    notall: '&cDu hast (noch) nicht alle Türchen geöffnet!'
```