For the complete documentation index, see llms.txt. This page is also available as Markdown.

🎄Beschreibung

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

Features

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

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.

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.


Setup-Anleitung

1

Installation

Lade die .jar-Datei in das /plugins/ Verzeichnis deines Servers hoch.

2

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.

3

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!


Commands & Permissions

Befehl
Beschreibung
Permission

/adventskalender

Öffnet das Kalender-Menü (nur wenn allowcmd: true).

-

/adventskalender reload

Lädt die Config und das GUI-Layout neu.

adventskalender.admin

/adventskalender setentity

Spawnt den Schneemann-NPC an deiner aktuellen Position.

adventskalender.admin

/adventskalender ban <Spieler>

Schließt einen Spieler von der Teilnahme am Adventskalender aus.

adventskalender.admin

/adventskalender unban <Spieler>

Erlaubt einem gebannten Spieler wieder die Teilnahme.

adventskalender.admin

/adventmsg <Spieler> <Nachricht>

Sendet eine direkte, farbige Nachricht an einen Spieler (ideal für Reward-Befehle).

adventskalender.adventmsg

-

Umgeht die tägliche Mindestspielzeit zum Öffnen von Türchen.

adventskalender.noplaytime


Zuletzt aktualisiert