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

# Beschreibung

Bringe festliche Stimmung auf deinen Server und belohne deine Spieler zur Weihnachtszeit mit einem interaktiven Adventskalender-System, täglichen Belohnungen und Spielzeitanforderungen.

{% hint style="success" %}
🎁 **Steigere die Spielerbindung im Dezember durch tägliche Geschenke und festliche Belohnungen!**
{% endhint %}

## Features

{% tabs %}
{% tab title="🎄 Adventskalender" %}

#### Kalender-System

* **Festliche GUI:** Übersichtliches Menü mit Türchen von Tag 1 bis 24 (Stufenweise Freischaltung pro Tag im Dezember).
* **Finale Belohnung (Tag 25):** Eine konfigurierbare Bonus-Belohnung für Spieler, die fleißig alle 24 Türchen geöffnet haben.
* **Rückwirkendes Öffnen:** Lege fest, wie viele Tage verpasste Türchen rückwirkend geöffnet werden dürfen (z. B. `0` = nur am jeweiligen Tag, `24` = unbegrenzt).
  {% endtab %}

{% tab title="⏱️ Spielzeit & AFK" %}

#### Aktivitätsprüfung

* **Spielzeitanforderung:** Türchen können an eine tägliche Mindestspielzeit in Minuten gekoppelt werden.
* **AFK-Check:** Ein integrierter AFK-Schutz sorgt dafür, dass nur aktive Spielzeit gezählt wird (Zeit einstellbar).
* **Bypass-Option:** Admins oder VIPs können per Permission von der Spielzeitpflicht befreit werden.
  {% endtab %}

{% tab title="☃️ Schneemann NPC" %}

#### Interaktives NPC-System

* **Clickable NPC:** Spawne einen Schneemann NPC am Spawn, über den Spieler den Kalender öffnen.
* **AI- & Schadenschutz:** Der NPC besitzt keine KI, ist lautlos (silent) und unverwundbar.
* **Entfernen:** Admins können den Schneemann mit Sneaken + Linksklick abbauen.
  {% endtab %}
  {% endtabs %}

***

## Setup-Anleitung

{% stepper %}
{% step %}

#### Installation

Lade die `.jar`-Datei in das `/plugins/` Verzeichnis deines Servers hoch.
{% endstep %}

{% step %}

#### Datenbank & Config einrichten

1. Starte den Server einmal, damit die Standard-Dateien generiert werden.
2. Konfiguriere optional deine MySQL-Datenbankverbindung in `/plugins/Adventskalender/config.yml`.
3. Passe Belohnungen (Commands) und Spielzeiten für jedes Türchen einzeln an.
   {% endstep %}

{% step %}

#### Schneemann NPC platzieren

1. Gehe im Spiel an die Position, an der der Kalender-NPC stehen soll.
2. Führe den Befehl `/adventskalender setentity` aus (erfordert `adventskalender.admin`).
3. Der Schneemann wird erstellt und ist sofort betriebsbereit!
   {% endstep %}
   {% endstepper %}

***

## Commands & Permissions

<table><thead><tr><th width="250">Befehl</th><th>Beschreibung</th><th width="250">Permission</th></tr></thead><tbody><tr><td><code>/adventskalender</code></td><td>Öffnet das Kalender-Menü (nur wenn <code>allowcmd: true</code>).</td><td>-</td></tr><tr><td><code>/adventskalender reload</code></td><td>Lädt die Config und das GUI-Layout neu.</td><td><code>adventskalender.admin</code></td></tr><tr><td><code>/adventskalender setentity</code></td><td>Spawnt den Schneemann-NPC an deiner aktuellen Position.</td><td><code>adventskalender.admin</code></td></tr><tr><td><code>/adventskalender ban &#x3C;Spieler></code></td><td>Schließt einen Spieler von der Teilnahme am Adventskalender aus.</td><td><code>adventskalender.admin</code></td></tr><tr><td><code>/adventskalender unban &#x3C;Spieler></code></td><td>Erlaubt einem gebannten Spieler wieder die Teilnahme.</td><td><code>adventskalender.admin</code></td></tr><tr><td><code>/adventmsg &#x3C;Spieler> &#x3C;Nachricht></code></td><td>Sendet eine direkte, farbige Nachricht an einen Spieler (ideal für Reward-Befehle).</td><td><code>adventskalender.adventmsg</code></td></tr><tr><td>-</td><td>Umgeht die tägliche Mindestspielzeit zum Öffnen von Türchen.</td><td><code>adventskalender.noplaytime</code></td></tr></tbody></table>

## Support & Links

* 🌐 **Plugin-Website**: [https://dyroxplays.de](https://dyroxplays.de/)
* 💬 **Discord**: Dyroxplays
* 🔌 **Weitere Plugins**: <https://dyroxplays.de/shop>

***

{% hint style="success" %}
**Coded by Dyroxplays**

© 2024-2026 Dyroxplays. Alle Rechte vorbehalten.
{% endhint %}