118 lines
4.2 KiB
Markdown
118 lines
4.2 KiB
Markdown
<div align="center">
|
||
|
||
# ❄️ Minecraft Adventskalender ❄️
|
||
|
||
*Bringe festliche Stimmung auf deinen Server mit einem hochgradig anpassbaren System*
|
||
|
||
|
||
|
||
|
||
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
## Über Minecraft Adventskalender
|
||
|
||
Das **Minecraft Adventskalender Plugin** ist die ultimative Lösung für deinen Server im Dezember! Es bietet volle Kontrolle über Belohnungen, Sprache und Funktionen. Dank des neuen klickbaren Update-Checkers und dem erweiterten Admin-Test-System war die Verwaltung eines Events noch nie so einfach. Perfekt für Community-Events, um die Spielerbindung in der Weihnachtszeit zu stärken!
|
||
|
||
---
|
||
|
||
## ✨ Exklusive Features
|
||
|
||
- **Vollständig Anpassbare Belohnungen:** Definiere für jeden Tag individuelle Items mit Menge, Name, Lore und Verzauberungen.
|
||
- **Smart Update-Checker:** Erhalte beim Joinen als Admin eine dezente, **klickbare Benachrichtigung**, falls eine neue Version verfügbar ist (erscheint verzögert nach 2 Sek.).
|
||
- **Simulations Modus (Admin-Test):** Teste alle Türchen vorab durch Datums-Simulation, ohne deine Systemzeit zu ändern. Inklusive einfachem Reset auf das Echtzeit-Datum.
|
||
- **Präzises Reset-System:** Setze einzelne Tage oder komplette Fortschritte zurück – wahlweise für einzelne Spieler oder global für den ganzen Server.
|
||
- **Immersive Effekte:** Festliche Sound- und Partikeleffekte beim Öffnen eines Türchens.
|
||
- **Optimierte Tab-Completion:** Intelligente Befehlsvorschläge mit korrekter numerischer Sortierung (1, 2, 3... statt 1, 10, 11...).
|
||
|
||
---
|
||
|
||
## 🎄 Adventskalender GUI
|
||
|
||
<div align="center">
|
||
|
||
<img src="https://git.viper.ipv64.net/M_Viper/Advenskalender/raw/branch/main/img/03.png" width="400" alt="Kalender GUI 1">
|
||
<img src="https://git.viper.ipv64.net/M_Viper/Advenskalender/raw/branch/main/img/04.png" width="400" alt="Kalender GUI 2">
|
||
|
||
*Die intuitive Kalender-Oberfläche mit allen 24 Türchen*
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
## ⚙️ Befehle & Permissions
|
||
|
||
### ▶ Spieler-Befehle
|
||
|
||
**`/adventskalender`** (Aliase: `/ak`, `/advent`, `/kalender`)
|
||
- **Beschreibung:** Öffnet die Kalender-Oberfläche.
|
||
- **Berechtigung:** `adventskalender.use`
|
||
|
||
### ▶ Admin-Befehle
|
||
|
||
**`/ak admin test <1-24 | reset>`**
|
||
- **Beschreibung:** Simuliert einen bestimmten Tag für Belohnungstests. Nutze `reset`, um zum echten Datum zurückzukehren.
|
||
- **Berechtigung:** `adventskalender.admin`
|
||
|
||
**`/ak admin resetday <global | Spieler> <1-24>`**
|
||
- **Beschreibung:** Setzt den Status eines spezifischen Tages für einen Spieler oder den gesamten Server zurück.
|
||
- **Berechtigung:** `adventskalender.admin`
|
||
|
||
**`/ak admin reset <global | Spieler>`**
|
||
- **Beschreibung:** Löscht den kompletten Fortschritt (alle Tage) für einen Spieler oder global.
|
||
- **Berechtigung:** `adventskalender.admin`
|
||
|
||
**`/ak admin reload`**
|
||
- **Beschreibung:** Lädt Config, Sprachdateien und Datenbank-Verbindung im laufenden Betrieb neu.
|
||
- **Berechtigung:** `adventskalender.admin`
|
||
|
||
---
|
||
|
||
## 📊 PlaceholderAPI (PAPI)
|
||
|
||
- **`%ak_c%`** - Anzahl bereits geöffneter Türchen.
|
||
- **`%ak_n%`** - Nummer des nächsten verfügbaren Türchens.
|
||
- **`%ak_d%`** - Verbleibende Tage bis zum 25. Dezember.
|
||
|
||
### Placeholder auf einem Schild
|
||
|
||
<div align="center">
|
||
|
||
<img src="https://git.viper.ipv64.net/M_Viper/Advenskalender/raw/branch/main/img/02.png" alt="Placeholder Beispiel">
|
||
|
||
*Ein Schild, das die Placeholder des Plugins anzeigt.*
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
## 💬 Support & Community
|
||
|
||
Du hast Fragen oder Feedback? Tritt unserem Discord bei!
|
||
|
||
<div align="center">
|
||
|
||
[](https://discord.com/invite/FdRs4BRd8D)
|
||
|
||
*Klicke auf den Button für direkten Support durch die Community!*
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
## 🔧 Technische Details
|
||
|
||
- **Kompatibilität:** Paper, Spigot, Purpur (1.18.x - 1.21.x)
|
||
- **Smart Caching:** Minimale Serverlast durch asynchrone Datenbankaufrufe.
|
||
- **Join-Delay:** Update-Meldungen erscheinen erst nach 2 Sekunden, um den Chat-Spam beim Joinen zu umgehen.
|
||
|
||
---
|
||
|
||
<div align="center">
|
||
|
||
*Viper Plugins © 2026 - Effizienz und Magie für deinen Server*
|
||
|
||
</div> |