📑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

⚙️ Basis-Optionen

Globale Einstellungen

# 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

🗄️ MySQL

Datenbank-Optionen

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.

☃️ GUI & NPC

Optische Einstellungen

# 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

---

Platzhalter im GUI definieren (placeholder)

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

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):

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.

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

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!'