README.md aktualisiert
This commit is contained in:
186
README.md
186
README.md
@@ -1,132 +1,118 @@
|
|||||||
# 🎄 Minecraft Adventskalender Plugin
|
<div align="center">
|
||||||
|
|
||||||
Ein hochgradig konfigurierbares Adventskalender-Plugin für **Spigot/Paper-Server**, das dir die volle Kontrolle über Belohnungen, Sprache und Funktionen gibt.
|
# ❄️ Minecraft Adventskalender 2.0 ❄️
|
||||||
Perfekt, um die Weihnachtszeit auf deinem Server zu versüßen!
|
|
||||||
|
*Bringe festliche Stimmung auf deinen Server mit einem hochgradig anpassbaren System*
|
||||||
|
|
||||||
|

|
||||||
|

|
||||||
|

|
||||||
|

|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🖥️ Adventskalender GUI
|
## Ü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!
|
||||||

|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## ✨ Features
|
## ✨ Exklusive Features
|
||||||
|
|
||||||
- **Anpassbare Belohnungen**
|
- **Vollständig Anpassbare Belohnungen:** Definiere für jeden Tag individuelle Items mit Menge, Name, Lore und Verzauberungen.
|
||||||
Definiere in der `config.yml` für jeden Tag ein eigenes Item, inklusive:
|
- **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.).
|
||||||
- Menge
|
- **Simulations Modus (Admin-Test):** Teste alle Türchen vorab durch Datums-Simulation, ohne deine Systemzeit zu ändern. Inklusive einfachem Reset auf das Echtzeit-Datum.
|
||||||
- Name
|
- **Präzises Reset-System:** Setze einzelne Tage oder komplette Fortschritte zurück – wahlweise für einzelne Spieler oder global für den ganzen Server.
|
||||||
- Lore
|
- **Immersive Effekte:** Festliche Sound- und Partikeleffekte beim Öffnen eines Türchens.
|
||||||
- Verzauberungen
|
- **Optimierte Tab-Completion:** Intelligente Befehlsvorschläge mit korrekter numerischer Sortierung (1, 2, 3... statt 1, 10, 11...).
|
||||||
|
|
||||||
- **Globaler oder individueller Kalender**
|
|
||||||
Entscheide, ob:
|
|
||||||
- jeder Spieler seinen eigenen Fortschritt hat oder
|
|
||||||
- ein Türchen serverweit nur einmal geöffnet werden kann
|
|
||||||
|
|
||||||
- **Sound & Partikel**
|
|
||||||
Angenehme Sound- und Partikeleffekte beim Öffnen eines Türchens.
|
|
||||||
|
|
||||||
- **Mehrsprachig**
|
|
||||||
Unterstützt **Deutsch** und **Englisch**.
|
|
||||||
Weitere Sprachen können einfach hinzugefügt werden.
|
|
||||||
|
|
||||||
- **Admin-Befehle**
|
|
||||||
Konfigurationen neu laden oder Türchen gezielt für Spieler öffnen.
|
|
||||||
|
|
||||||
- **Permissions-System**
|
|
||||||
Feingranulare Kontrolle über Spieler- und Admin-Rechte.
|
|
||||||
|
|
||||||
- **PlaceholderAPI-Unterstützung**
|
|
||||||
Zeige Statistiken:
|
|
||||||
- auf Schildern
|
|
||||||
- in der Tab-Liste
|
|
||||||
- mit Hologramm-Plugins
|
|
||||||
- Scoreboard
|
|
||||||
und vieles mehr.
|
|
||||||
|
|
||||||
- **Datenpersistenz**
|
|
||||||
Spielerfortschritt bleibt auch nach Server-Neustarts erhalten.
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 📸 Screenshots
|
## 🎄 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
|
### Placeholder auf einem Schild
|
||||||
|
|
||||||
Ein Schild, das die Placeholder des Plugins anzeigt.
|
<div align="center">
|
||||||
|
|
||||||
<img src="https://git.viper.ipv64.net/M_Viper/Advenskalender/raw/branch/main/img/02.png" width="450" alt="Adventskalender Placeholder">
|
<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>
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🚀 Installation
|
## 💬 Support & Community
|
||||||
|
|
||||||
1. Lade die neueste Version des Plugins als **`.jar`-Datei** herunter.
|
Du hast Fragen oder Feedback? Tritt unserem Discord bei!
|
||||||
2. Platziere die Datei im Ordner:
|
|
||||||
|
|
||||||
/plugins
|
<div align="center">
|
||||||
|
|
||||||
3. Stelle sicher, dass **PlaceholderAPI** installiert ist (Pflichtabhängigkeit).
|
[](https://discord.com/invite/FdRs4BRd8D)
|
||||||
4. Starte oder starte den Server neu.
|
|
||||||
5. Passe die Konfigurationsdateien an: /plugins/Adventskalender/
|
*Klicke auf den Button für direkten Support durch die Community!*
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## ⚙️ Konfiguration
|
## 🔧 Technische Details
|
||||||
|
|
||||||
Das Plugin verwendet drei Hauptdateien:
|
- **Kompatibilität:** Paper, Spigot, Purpur (1.18.x - 1.21.x)
|
||||||
|
- **Smart Caching:** Minimale Serverlast durch asynchrone Datenbankaufrufe.
|
||||||
- **`config.yml`**
|
- **Join-Delay:** Update-Meldungen erscheinen erst nach 2 Sekunden, um den Chat-Spam beim Joinen zu umgehen.
|
||||||
- Sprache
|
|
||||||
- Kalender-Typ (global / individuell)
|
|
||||||
- Belohnungen für alle 24 Tage
|
|
||||||
|
|
||||||
- **`messages_de.yml` / `messages_en.yml`**
|
|
||||||
- GUI-Titel
|
|
||||||
- Chat-Nachrichten
|
|
||||||
- Systemmeldungen
|
|
||||||
Diese Dateien können frei angepasst oder übersetzt werden.
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 📋 Befehle & Berechtigungen
|
<div align="center">
|
||||||
|
|
||||||
### Befehle
|
*Viper Plugins © 2026 - Effizienz und Magie für deinen Server*
|
||||||
|
|
||||||
| Befehl | Alias | Beschreibung | Berechtigung |
|
</div>
|
||||||
|------|------|-------------|--------------|
|
|
||||||
| `/adventskalender` | `/advent`, `/kalender`, `/ak` | Öffnet den Adventskalender | `adventskalender.use` |
|
|
||||||
| `/adventskalender admin reload` | `/ak admin reload` | Lädt Konfigurations- & Sprachdateien neu | `adventskalender.admin` |
|
|
||||||
| `/adventskalender admin open <spieler> <tag>` | `/ak admin open ...` | Öffnet ein Türchen für einen Spieler | `adventskalender.admin` |
|
|
||||||
|
|
||||||
### Berechtigungen
|
|
||||||
|
|
||||||
| Berechtigung | Standard | Beschreibung |
|
|
||||||
|-------------|----------|--------------|
|
|
||||||
| `adventskalender.use` | `true` | Erlaubt das Öffnen des Kalenders |
|
|
||||||
| `adventskalender.admin` | `op` | Erlaubt alle Admin-Befehle |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🔗 Placeholders
|
|
||||||
|
|
||||||
Alle Placeholder sind **PlaceholderAPI-kompatibel** und kurz gehalten.
|
|
||||||
|
|
||||||
| Placeholder | Beschreibung |
|
|
||||||
|------------|--------------|
|
|
||||||
| `%ak_c%` | Anzahl geöffneter Türchen |
|
|
||||||
| `%ak_n%` | Nächstes verfügbares Türchen |
|
|
||||||
| `%ak_d%` | Verbleibende Tage bis 25. Dezember |
|
|
||||||
|
|
||||||
### Beispiel für ein Schild
|
|
||||||
|
|
||||||
|
|
||||||
Dein Fortschritt:
|
|
||||||
%ak_c%/24 Türchen
|
|
||||||
|
|
||||||
|
|
||||||
---
|
|
||||||
Reference in New Issue
Block a user