🛡️ Ztone – All-in-One Server-System

Willkommen in der offiziellen Dokumentation für Ztone (Version 1.1.5).
Ztone ist eine hochgradig optimierte, modulare All-in-One-Lösung für Minecraft Paper-, Purpur- und Leaf-Server (kompatibel mit Java 21 & Java 25).

---

📑 Inhaltsverzeichnis

1. Übersicht & Module
2. Clan-System & Clankasse
3. Claims-System (Grundstücksverwaltung)
4. PvPManager & Combat-System
5. StoneAttack (Leaderboards, PlayerLimit, Performance)
6. DeathChest (Todeskisten)
7. ClearLag (Item-Bereinigung)
8. PlayRewards (Spielzeit & Streak-Belohnungen)
9. StoneVoice (VoiceChat-Admin-Tools)
10. Stonemute (Eigenständiges Plugin)
11. MapControl (Minimap- & Radar-Steuerung)
12. Stonelog & Hauptverwaltung
13. StoneSit (Sitzen, Hinlegen & Spielerstapeln)
14. Globale Konfiguration, Auto-Updater & Datenbank
15. PlaceholderAPI Gesamtübersicht
16. Kompilierung & Entwicklung
17. Changelog v1.1.2
18. Changelog v1.1.3
19. Changelog v1.1.5

---

🧩 Übersicht & Module

Ztone bündelt alle wichtigen Core-Features für moderne Survival- und SMP-Netzwerke in einem einzigen Plugin:

• Clansystem: Eigene Clans, Ränge mit detaillierten Rechten, Clankasse mit automatischem Steuersystem (zyklischer Einzug, Kassenstaffeln, 14 Tage Schonfrist) und Zinsen/Schulden (Schuldensperre bei Minus), Clan-Homes, Clan-Warps, Clankriege (12h Cooldown, Max. 1 Krieg, Settings-Toggle ab Level 7) und Allianzen. Einheitlicher Prefix und Small-Caps.
• Claims: Chunk-basiertes Claiming mit interaktiver Karten-GUI, automatischem Claim-Merging für aneinandergrenzende Grundstücke, WorldGuard-Flag-Integration (/rg flag claim allow/deny), granularen Schutzflags, Subclaims, Trusted- und Ban-System sowie Anti-Combat-Fluchtsperre.
• PvPManager: Umfassender Combat-Tag, Spawn-/Respawn-Schutz, Anti-CombatLog, Anti-Kill-Abuse und strenge PvP-Hierarchie (Wildnis: Dimensions- & Spielerstatus; Claims: standardmäßig deaktiviert, außer bei Clankrieg oder Admin-Override).
• StoneAttack: Holographische Leaderboards mit transparentem Display-Design, dynamisches PlayerLimit und TPS/MSPT-Serverüberwachung.
• DeathChest: Sichere Todeskisten mit Restart-Persistenz, Anti-Rollback, automatischer Hologramm-Bereinigung, Killer-Lock-Bypass und Echtzeit-Chatbenachrichtigung beim Plündern.
• ClearLag: Intelligente Boden-Item-Bereinigung mit Countdown-Warnungen und Actionbar.
• PlayRewards: Tägliche Belohnungen, Playtime-Tracking und Streak-System mit Schutzpunkten.
• StoneVoice: SimpleVoiceChat-Gruppenüberwachung für Admins (Hinweis: Stonemute wurde als eigenständiges Plugin nach C:\Stonemute ausgelagert).
• MapControl: Erzwingen von Fairplay-Regeln für Client-Minimaps (Xaero, JourneyMap, VoxelMap).
• Stonelog: Hochperformantes Discord-Audit-Logging mit automatischem Multi-Embed-Batching (bis zu 10 Embeds/Request) und parallelen URL-Queues.
• StoneSit: Hochperformantes Sit-, Lay-, LegsUp-, Spin- & PlayerSit-System (1:1 nach GSit für Paper 26.2 optimiert, mit 360° Rotations-Animation, Bett-Schlaf-Logik ohne Respawn-Punkt und Admin-Schutz vor Sneak-Abwurf vom Kopf).
• Auto-Config-Sync: Automatisches Ergänzen neuer Funktionen und Konfigurationsoptionen bei Versionsupdates direkt in bestehende .yml-Dateien.

---

1. Clan-System & Clankasse

🔹 Spieler-Befehle (/clan)

Erfordert standardmäßig die Berechtigung: clansystem.use

Befehl	Beschreibung	Benötigte Berechtigung
/clan	Öffnet das interaktive Hauptmenü des Clans (oder No-Clan-Menü)	clansystem.use
/clan create <Name>	Erstellt einen neuen Clan	clansystem.create
/clan disband	Löst den eigenen Clan auf (mit Bestätigungs-GUI)	Leader-Recht
/clan leave	Verlässt den aktuellen Clan	clansystem.leave
/clan invite <Spieler>	Lädt einen Spieler in den Clan ein	clansystem.invite
/clan accept	Nimmt eine ausstehende Clan-Einladung an	clansystem.join
/clan apply <Clan>	Sendet eine Bewerbung an einen offenen Clan	clansystem.join
/clan join <Clan>	Tritt einem öffentlich zugänglichen Clan bei	clansystem.join
/clan kick <Spieler>	Wirft ein Mitglied aus dem Clan	clansystem.kick
/clan sethome	Setzt das Clan-Home an der aktuellen Position	clansystem.home
/clan home	Teleportiert zum Clan-Home (mit Warmup/Cooldown)	clansystem.home
/clan delhome	Löscht das bestehende Clan-Home	clansystem.home
/clan warps	Öffnet die Liste aller Clan-Warps	clansystem.warp
/clan setwarp <Name>	Erstellt einen neuen Clan-Warp	clansystem.warp
/clan warp <Name>	Teleportiert zu einem Clan-Warp	clansystem.warp
/clan delwarp <Name>	Löscht einen Clan-Warp	clansystem.warp
/clan chest	Öffnet die virtuelle Clan-Truhe	clansystem.chest
/clan bank	Öffnet das Clan-Bankkonto (Einzahlen/Auszahlen/Historie)	clansystem.bank
/clan bank deposit <Betrag>	Zahlt Geld auf das Clankonto ein	clansystem.bank.deposit
/clan bank withdraw <Betrag>	Hebt Geld vom Clankonto ab	clansystem.bank.withdraw
/clan bank top	Zeigt die reichsten Clans des Servers	clansystem.bank.top
/clan taxes	Zeigt anstehende Steuern, Schonfrist und nächste Fälligkeit (Aliase: /clan bank taxes, /clan steuern)	clansystem.bank
/clan info [Clan]	Zeigt Informationen über den eigenen oder fremden Clan	clansystem.info
/clan list	Listet alle Clans des Servers sortiert nach Punkten auf	clansystem.list
/clan chat <Nachricht>	Schreibt in den privaten Clan-Chat (Präfix: #)	clansystem.chat
/clan allychat <Nachricht>	Schreibt in den Allianz-Chat (Präfix: ##)	clansystem.ally
/clan ally <Clan>	Sendet/akzeptiert eine Allianz-Anfrage	clansystem.ally
/clan enemy <Clan>	Erklärt einem Clan die Feindschaft	clansystem.enemy
/clan war <Clan>	Startet oder verwaltet einen Clankrieg	clansystem.war
/clan surrender	Kapituliert im laufenden Clankrieg	clansystem.war
/clan stats	Zeigt die Kriegs- und Kampfstatistiken des Clans	clansystem.stats
/clan rank create <Name>	Erstellt einen neuen Rang im Clan	clansystem.rank
/clan rank delete <Name>	Löscht einen Clan-Rang	clansystem.rank
/clan rank set <Spieler> <Rang>	Weist einem Mitglied einen Rang zu	clansystem.rank
/clan rank list	Listet alle Ränge des Clans auf	clansystem.rank
/clan rank permissions	Öffnet das Berechtigungsmenü für Ränge	clansystem.rank

---

🔹 Admin-Befehle (/clanadmin)

Hauptberechtigung: clansystem.admin

Befehl	Beschreibung	Berechtigung
/clanadmin reload	Lädt alle Clan-Konfigurationsdateien neu	clansystem.admin.reload
/clanadmin disband <Clan>	Löst einen beliebigen Clan zwangsweise auf	clansystem.admin.disband
/clanadmin setleader <Clan> <Spieler>	Setzt einen neuen Anführer für einen Clan	clansystem.admin.setleader
/clanadmin promote <Spieler> [Clan]	Befördert einen Spieler im Clan	clansystem.admin.promote
/clanadmin demote <Spieler> [Clan]	Degradiert einen Spieler im Clan	clansystem.admin.demote
/clanadmin addpoints <Clan> <Menge>	Fügt einem Clan Ranglisten-Punkte hinzu	clansystem.admin.points
/clanadmin removepoints <Clan> <Menge>	Zieht einem Clan Punkte ab	clansystem.admin.points
/clanadmin addmoney <Clan> <Betrag>	Zahlt Geld auf die Clankasse ein	clansystem.admin.bank
/clanadmin removemoney <Clan> <Betrag>	Hebt Geld von der Clankasse ab	clansystem.admin.bank
/clanadmin setlevel <Clan> <Level>	Setzt das Level eines Clans manuell	clansystem.admin.level
/clanadmin spy	Schaltet den Clan- und Allianz-Chat-Spion ein/aus	clansystem.admin.spy
/clanadmin reset	Bereinigt die gesamte Clan-Datenbank (Vorsicht!)	clansystem.admin.reset
/clanadmin taxes [run|info]	Verwaltet das Steuersystem (Zyklus-Status einsehen oder sofortigen Einzug auslösen)	clansystem.admin.taxes

---

🔹 Clan-Steuersystem & Kassenstaffeln

Ztone 1.1.3 führt ein vollautomatisches, konfigurierbares Steuersystem für Clans ein (clansystem/config.yml):

• Zyklischer Steuereinzug: Steuern werden in festen Abständen (Standard: alle 7 Tage) serverweit direkt aus der Clankasse abgezogen.
• Persistenter Einzugszeitpunkt: Der Zeitstempel des letzten Steuereinzugs wird in der SQLite-Datenbank (metadata-Tabelle) gespeichert. Server-Restarts oder Downtimes stören den Zyklus nicht.
• Berechnungsformel: $$\text{Gesamtsteuer} = \text{Level-Basiswert} + (\text{Clankasse} \times \text{Multiplikator}) + \text{Flat-Steuer}$$
• Staffel-Multiplikatoren (balance-brackets):
  • 0 $ bis 50.000 $: 0.00 Multiplikator (+ 0 $ Flat)
  • 50.000 $ bis 100.000 $: 0.01 (1%) Multiplikator (+ 500 $ Flat)
  • 100.000 $ bis 500.000 $: 0.02 (2%) Multiplikator (+ 1.500 $ Flat)
  • 500.000 $ bis 1.000.000 $: 0.03 (3%) Multiplikator (+ 5.000 $ Flat)
  • 1.000.000 $+: 0.05 (5%) Multiplikator (+ 10.000 $ Flat)
• 14 Tage Schonfrist: Neu gegründete Clans sind in den ersten 14 Tagen (grace-period-days: 14) von allen Steuern befreit.
• Schuldensperre bei Zahlungsunfähigkeit:
  • Reicht das Guthaben nicht aus, wird die Steuer trotzdem voll abgebucht – der Clan gerät ins Minus (Schulden).
  • Solange der Clan im Minus ist, greift die vollständige Clan-Sperre (keine Homes, Warps, Kisten, Kriege etc.), bis der Betrag per /clan deposit ausgeglichen ist.
• Transparenz & GUI:
  • Jede Steuerabbuchung wird im Transaktionsverlauf (/clan bank / Kassenbuch) mit Typ Steuern (orangefarbener Farbstoff) dokumentiert.
  • Das Clankassen-Icon (Slot 31) im Clan-Hauptmenü zeigt die nächste voraussichtliche Steuer oder verbleibende Schonfrist-Tage an.
  • Spieler können per /clan taxes (oder /clan bank taxes) eine detaillierte Kostenaufstellung und den nächsten Fälligkeitszeitpunkt abrufen.

---

🔹 Clan-Ränge & Leader-Befugnisse

• Volle Leader-Freiheit: Der Clan-Owner (Leader) unterliegt keinen Rang-Prioritätsbeschränkungen mehr. Er kann jedes Mitglied zum höchsten Unterrang (z. B. Co. Owner) befördern, degradieren oder aus dem Clan entfernen.
• Granulare Rechteverwaltung: Jeder Rang kann mit individuellen Rechten ausgestattet werden (Bauen im Claim, Clantruhe, Einladungen, Clankasse, Warps, Kriegserklärungen).

---

2. Claims-System (Grundstücksverwaltung)

🔹 Spieler-Befehle (/claim)

Erfordert standardmäßig die Berechtigung: claims.use

Befehl	Beschreibung
/claim	Öffnet die interaktive Karten-GUI zur visuellen Verwaltung von Chunks
/claim auto	Claimt den Chunk, auf dem der Spieler gerade steht
/claim unclaim	Gibt den aktuellen Chunk frei
/claim unclaimall	Gibt alle Grundstücke des Spielers frei (mit Sicherheitsabfrage)
/claim trust <Spieler>	Öffnet die Rechte-Verwaltung für einen Spieler auf diesem Claim
/claim untrust <Spieler>	Entzieht einem Spieler alle Rechte auf dem Claim
/claim ban <Spieler>	Bannt einen Spieler vom Claim (wird an die Grenze teleportiert)
/claim unban <Spieler>	Hebt den Bann für einen Spieler auf
/claim list	Listet alle eigenen Claims mit Koordinaten und Welt auf
/claim pay <Spieler> <Anzahl>	Überträgt Claim-Blöcke/Slots an einen anderen Spieler
/claim settings	Öffnet das Einstellungsmenü für Flags (PVP, Explosionen, Mobs etc.)

---

🔹 Admin-Befehle (/staffclaim)

Hauptberechtigung: claims.admin

Befehl	Beschreibung	Berechtigung
/staffclaim bypass [on|off] [Spieler]	Aktiviert den Administrator-Bypass für alle Claims	claims.admin.bypass
/staffclaim unclaim	Löscht den Claim an der aktuellen Position zwangsweise	claims.admin.unclaim
/staffclaim info	Zeigt Besitzer, Erstellungsdatum und Flags des aktuellen Chunks	claims.admin.info
/staffclaim reload	Lädt config.yml und messages.yml des Claims-Moduls neu	claims.admin.reload
/claimspvpoverride [on|off|toggle|player|list]	Schaltet PvP auf einem Claim frei (Aliase: /pvpclaimbypass, /claimpvpbypass, /pvpclaim, /pvpclaimoverride)	claims.admin.pvpbypass

---

🔹 Claim-Flags & Schutzrechte

Jeder Claim-Besitzer kann pro Spieler oder global folgende Rechte vergeben:

• BUILD: Blöcke abbauen und platzieren.
• CONTAINERS: Kisten, Fässer, Chiseled Bookshelves, Shelves (Regale), Braustände, Trichter öffnen.
• DOORS: Türen, Falltüren, Zauntore öffnen/schließen.
• REDSTONE: Knöpfe, Hebel und Druckplatten betätigen.
• VEHICLES: Boote, Loren und Flöße platzieren, fahren oder abbauen.
• ENTITY_INTERACT: Rüstungsständer, Bilderrahmen, Glow-Frames, Endkristalle nutzen/abbauen; Enderperlen & Wind Charges werfen (Selbstanwendung wie Wind Charge Boost/Jump in Claims erlaubt).
• ATTACK_MOBS: Tiere, Dorfbewohner und passive Mobs schlagen (Monster-Notwehr ist immer erlaubt).
• BUCKETS: Wasser-, Lava- und Eimer-Nutzung.
• SPAWNER: SmartSpawner GUI öffnen und Mob-Spawner modifizieren/abbauen.
• FIRE_EXPLOSIONS: Feuerzeug, TNT-Zündung und Explosionen.
• PVP: Nur relevant, wenn ein Claim durch Admins mit /claimspvpoverride freigegeben ist.

---

🔹 WorldGuard-Integration (Custom-Flag claim)

Ztone 1.1.3 ersetzt die alte pauschale Regionenblockade durch ein natives WorldGuard StateFlag:

• Offizieller WorldGuard-Flag:
  • Flag-Name: claim (Standardwert: ALLOW).
  • Erscheint bei /rg flags <region> direkt unter den Third-Party Flags (mit Klick-Optionen für Allow und Deny).
• Granulare Steuerung:
  • /rg flag <region> claim deny: Verbietet das Claimen von Chunks innerhalb dieser Region (z. B. für Spawns oder Server-Events).
  • /rg flag <region> claim allow: Erlaubt das Claimen (Standardverhalten aller Regionen).
  • /rg flag __global__ claim deny: Verbietet Claiming weltweit, sodass Claims nur in Zonen mit explizitem claim: allow gesetzt werden können.
• Hierarchien & Prioritäten:
  • Schneidet ein Chunk mehrere Regionen, bestimmt die Region mit der höchsten Priorität das Verhalten. Bei gleicher Priorität sticht DENY.

---

🔹 Combat-Sperre für Claims (Anti-Combat-Flucht)

Important

Claim-Eintrittsverbot im Kampf:
Spieler mit aktivem Combat-Tag können fremde oder geschützte Claims nicht betreten.
Jeder Versuch (Laufen, Springen, Teleportation, Enderperlen, Reittiere) wird mit einer Rollback-Aktion abgewehrt und Reittiere werden abgeworfen (Verhalten analog zum Claim-Bann).
Ausnahmen:

1. Claims, auf denen Admins PvP per /claimspvpoverride freigeschaltet haben.
2. Admins mit aktivem Bypass (claims.admin.bypass oder /pvpoverride).

---

3. PvPManager & Combat-System

🔹 PvP & Combat-Befehle

Befehl	Aliase	Beschreibung	Berechtigung
/pvp [on|off]	/togglepvp, /pvptoggle	Schaltet den eigenen PvP-Status um	pvpmanager.command.pvp
/pvpoverride [Spieler]	/pvpo	Erlaubt Admins, Spieler überall anzugreifen (Bypass)	pvpmanager.command.override
/pvpinfo [Spieler]	-	Zeigt detaillierte PvP- und Combat-Informationen an	pvpmanager.command.pvpinfo
/pvpstatus [Spieler]	-	Zeigt den aktuellen PvP-Status eines Spielers	pvpmanager.command.pvpstatus
/pvplist	/listpvp	Listet den PvP-Status aller Online-Spieler auf	pvpmanager.command.pvplist
/pvptag [Spieler] [Zeit]	/combattag, /tag	Zeigt verbleibende Tag-Zeit oder taggt manuell	pvpmanager.command.tag
/untag [Spieler|*]	-	Entfernt den Combat-Tag von einem oder allen Spielern	pvpmanager.command.untag
/teleportoverride [Spieler]	-	Erlaubt Teleportation trotz Combat-Tag	pvpmanager.command.teleportoverride
/pvpdimensiontoggle <Dim> <on|off> [--force]	-	Schaltet PvP für eine Dimension permanent ein/aus	pvpmanager.command.pvpdimensiontoggle
/announce <Nachricht>	-	Sendet einen serverweiten Broadcast	pvpmanager.command.announce
/soup	-	Füllt leere Schüsseln im Inventar mit Pilzsuppe	pvpmanager.command.soup
/testrace	-	Debug-Befehl für Entwickler	pvpmanager.command.testrace

---

🔹 Die vollständige PvP-Logik

Important

Hierarchie der Kampfbeschränkungen:

1. Unclaimed Terrain (Wildnis):
   • In nicht-forcierten Welten entscheidet der persönliche Spielerstatus (/pvp on/off). Haben beide Spieler /pvp on, können sie kämpfen.
   • Hat ein Spieler /pvp off, kann er weder andere angreifen noch von ihnen angegriffen werden.
   • Bei forcierten Dimensionen (--force) greift der globale Dimensions-Status zwingend für alle Spieler ohne Ausnahmerechte.
2. Claims:
   • PvP ist auf Claims standardmäßig vollständig deaktiviert, unabhängig vom /pvp-Status der Spieler.
   • Ausnahme A: Ein Admin hat mit /claimspvpoverride PvP auf diesem Claim aktiviert (verhält sich dann wie Wildnis).
   • Ausnahme B: Die Kontrahenten befinden sich in einem aktiven Clankrieg (/clan war).
   • Ausnahme C: Ein Admin besitzt /pvpoverride oder den individuellen Admin-Bypass.
3. Selbstinteraktion & Movement:
   • Wind Charges und Enderperlen auf sich selbst (z. B. Boost-Sprünge) triggern niemals irrtümlich eine PvP-Schadensverweigerung.

• Combat-Tag: Bei Schaden oder aggressiven Aktionen (auch feindliche Wind Charges/Enderperlen) wird der Combat-Tag aktiviert. Befehle, Fliegen, Gamemode und Elytren werden temporär blockiert.
• Anti-CombatLog: Verlässt ein Spieler den Server im Kampf, wird er getötet, sein Loot gedroppt und Blitze schlagen an seiner Position ein.
• Respawn-Schutz: Frisch respawnte Spieler erhalten temporären Schutz vor Schaden und Angriffen.

---

4. StoneAttack (Leaderboards, PlayerLimit, Performance)

🔹 Leaderboard-Befehle (/leaderboard)

Verwaltet dynamische Ranglisten-Hologramme für Bestenlisten (Spielzeit, Kills, Tode, Geld).
Design: Nutzt moderne Paper TextDisplay-Entities mit vollständig transparentem Hintergrund (Color.fromARGB(0)), gestochen scharfen Schriftfarben und Rangabzeichen (🥇, 🥈, 🥉) ohne störende dunkle Hintergrundboxen.
Berechtigung: leaderboard.admin

Befehl	Beschreibung
/leaderboard place <Typ>	Platziert ein neues Leaderboard (playtime, kills, deaths, money)
/leaderboard move <ID>	Verschiebt ein bestehendes Leaderboard an die aktuelle Position
/leaderboard height <ID> <Offset>	Passt den Zeilenabstand/Höhe der Hologramme an
/leaderboard remove <ID>	Entfernt ein Leaderboard
/leaderboard removeplayer <Spieler>	Schließt einen Spieler von allen Leaderboards aus
/leaderboard addplayer <Spieler>	Fügt einen zuvor ausgeschlossenen Spieler wieder hinzu
/leaderboard excluded	Zeigt alle ausgeschlossenen Spieler
/leaderboard list	Listet alle aktiven Leaderboards mit IDs auf

---

5. DeathChest (Todeskisten)

Schützt das Inventar verstorbener Spieler in einer gesicherten Kiste:

• Hologramm-Timer: Zeigt verbleibende Restzeit und Spielernamen über der Kiste an.
• Sicherheit: Kisten können nicht von fremden Spielern geöffnet werden, solange der Schutz aktiv ist.
• Befehl: /deathchest reload (Berechtigung: deathchest.admin).

---

6. ClearLag (Item-Bereinigung)

Intelligente Boden-Item-Bereinigung zur Erhaltung hoher TPS:

• Konfigurierbare Countdown-Intervalle mit Chat- und Actionbar-Warnungen.
• Schont gezielt markierte Items, Tiere, Rüstungsständer und Fahrzeuge.
• Befehl: /clearlag [clear|reload] (Berechtigung: clearlag.admin).

---

7. PlayRewards (Spielzeit & Streak-Belohnungen)

• Daily Rewards: Tägliche Belohnungen mit Belohnungsstufen und Schutzpunkten.
• Playtime Rewards: Belohnungen für aktive Spielstunden auf dem Server.
• Streak-Schutz: Verhindert den Verlust der täglichen Serie bei Serverabwesenheit.
• Befehl: /rewards oder /playrewards (Berechtigung: playrewards.use).

---

8. StoneVoice (VoiceChat-Admin-Tools)

Ermöglicht Moderatoren und Admins die diskrete Überwachung von Simple Voice Chat Gruppenräumen:

• /adminjoinvoice <Gruppe> (Berechtigung: adminjoinvoice.use): Tritt einem Sprachkanal bei.
• Modus-Optionen:
  • [listen]: Kann nur zuhören, Mikrofon stumm.
  • [speak]: Kann sprechen und hören.
  • [hidden]: Ist in der Gruppenliste für andere Spieler unsichtbar.
  • [FullMuted]: Weder hören noch sprechen (reines Ghosting).

---

9. Stonemute (Eigenständiges Plugin)

Note

Das Modul Stonemute wurde mit Version 1.1.5 vollständig aus dem Ztone-Kern ausgelagert und steht nun als eigenständiges Paper-Plugin unter C:\Stonemute zur Verfügung. Es verknüpft LiteBans direkt mit SimpleVoiceChat, unterstützt netzwerkweite Mutes sowie LuckPerms-Bypass und besitzt ein eigenes Konfigurations- und Reload-System.

---

10. MapControl (Minimap- & Radar-Steuerung)

Sendet standardisierte Plugin-Nachrichten an VoxelMap, Xaero's Minimap und JourneyMap, um Cheaten zu verhindern:

• Deaktiviert Höhlen-Minimaps (Höhlenansicht).
• Deaktiviert Spieler- und Entity-Radar.
• Berechtigung:
  • mapcontrol.admin: Verwaltung via /mapcontrol <reload|info|send>
  • mapcontrol.bypass: Erlaubt vertrauenswürdigen Spielern volle Minimap-Features.

---

11. Stonelog & Hauptverwaltung

🔹 Hauptbefehl (/ztone)

Berechtigung: ztone.admin

• /ztone reload: Führt einen vollständigen Reload aller Submodule und Konfigurationen durch.
• /ztone backup: Erstellt sofort ein manuelles Hot-Backup aller aktiven Datenbanken.

🔹 Logging (/stonelog)

Berechtigung: stonelog.admin

• /stonelog reload: Lädt die Audit- und Logging-Konfiguration neu.
• Hochleistungs-Discord-Dispatcher:
  • Multi-Embed-Batching: Bis zu 10 Embeds (Chat, Befehle, Tode, Joins) werden automatisch in einem einzigen HTTP-POST-Request gebündelt versendet.
  • Parallele Queues: Jeder Webhook-URL besitzt eine eigene Queue und einen eigenen Worker im 4-Thread-Pool. Ein Rate-Limit (429) auf einer Webhook-URL blockiert niemals andere Kanäle.
  • Kein Queue-Überlauf: Die 5000-Nachrichten-Queue läuft selbst bei extremem Chat- oder Befehls-Spam nicht mehr voll.

---

12. StoneSit (Sitzen, Hinlegen & Spielerstapeln)

Hochperformantes Sit-, Pose- (/lay & /legsup), Spin- (/spin) und PlayerSit-Modul (1:1 nach GSit für Paper 26.2 optimiert, mit flüssiger 360° Rotations-Animation ohne unnötigen Datenbank-Overhead).

🔹 Befehle

Befehl	Aliase	Beschreibung	Berechtigung
/sit	/gsit, /stonesit	Setzt dich auf den aktuellen Block (oder steht wieder auf)	stonesit.sit
/lay	/glay, /layback, /glayback	Legt dich auf den aktuellen Block (zählt als Schlafen im Bett, setzt aber keinen Respawn-Punkt)	stonesit.lay
/legsup	/glegsup	Legt dich mit hochgestreckten Beinen auf den aktuellen Block (zählt ebenfalls als Schlafen ohne Respawn-Punkt)	stonesit.legsup
/spin	/gspin, /stonespin	Lässt dich kontinuierlich 360° um die eigene Achse drehen (Animation)	stonesit.spin
/stonesitreload	/gsitreload, /gsitrl, /stonesitrl, /sit reload	Lädt plugins/Ztone/stonesit/config.yml im laufenden Betrieb neu	stonesit.reload

🔹 Besondere Features

• Rechtsklick-Sitzen auf Blöcken: Mit leerer Haupthand per Rechtsklick auf Treppen (#stairs), Stufen (#slabs), Teppiche (#carpets), Moosteppiche und Schnee setzen (automatisch ausgerichtet nach Treppenform).
• Schlafen im Bett ohne Respawn-Punkt (/lay & /legsup):
  • Setzt den Phantom-Timer (TIME_SINCE_REST) auf 0.
  • Zählt für das Überspringen der Nacht und von Gewittern (gemäß Gamerule playersSleepingPercentage) nach 5 Sekunden (100 Ticks) – sowohl alleine als auch kombiniert mit Spielern in echten Betten –, ohne jemals den Respawn-Punkt des Spielers zu verändern.
• 360° Rotations-Animation (/spin):
  • Vollwertiger Posen-Zustand (PoseType.SPIN), exakt wie in GSit: Der Charakter steht auf der Position und führt kontinuierlich die Dreizack-Riptide-Wirbelbewegung (Pose.SPIN_ATTACK / AutoSpinAttack) aus.
  • Startet mit authentischem Dreizack-Riptide-Sound (ITEM_TRIDENT_RIPTIDE).
  • Beendigung per Schleichen (Shift/Sneak), Schaden, Teleportation oder erneute Ausführung von /spin.
• Spieler-Stapeln (PlayerSit) & Admin-Kopfsitz-Schutz:
  • Spieler können sich per Rechtsklick mit leerer Hand auf den Kopf anderer Spieler setzen.
  • Admin-Schutz (stonesit.bypass.sneakeject): Sitzt ein Admin mit dieser Permission auf dem Kopf eines Spielers (oder weiter oben im Stapel), kann der untere Spieler ihn nicht durch Sneaken (Schleichen) vom Kopf werfen!

🔹 Alle StoneSit-Permissions im Überblick

Permission	Standard	Beschreibung
stonesit.*	op	Vollzugriff auf alle StoneSit-Funktionen, Bypasses und Admin-Rechte
stonesit.admin	op	Admin-Paket: beinhaltet stonesit.bypass.sneakeject und stonesit.reload
stonesit.sit.*	true	Beinhaltet stonesit.sit und stonesit.sitclick
stonesit.sit	true	Erlaubt den Befehl /sit (/gsit, /stonesit)
stonesit.sitclick	true	Erlaubt das Hinsetzen per Rechtsklick auf Stufen, Treppen, Teppiche etc.
stonesit.pose.*	true	Beinhaltet stonesit.lay, stonesit.legsup und stonesit.spin
stonesit.lay	true	Erlaubt den Befehl /lay (/glay, /layback, /glayback)
stonesit.legsup	true	Erlaubt den Befehl /legsup (/glegsup)
stonesit.spin	true	Erlaubt den Befehl /spin (/gspin, /stonespin)
stonesit.playersit.*	true	Beinhaltet stonesit.playersit
stonesit.playersit	true	Erlaubt das Draufsetzen auf andere Spieler per Rechtsklick (PlayerSit)
stonesit.bypass.sneakeject	op	Admin-Kopfsitz-Schutz: Verhindert, dass man durch Sneaken (Schleichen) vom Kopf eines anderen Spielers geworfen werden kann
stonesit.bypass.*	op	Beinhaltet alle Bypass-Permissions (sneakeject, command, world, region)
stonesit.bypass.command	op	Umgeht die Command-Blacklist während des Sitzens/Liegens
stonesit.bypass.world	op	Umgeht die World-Blacklist und World-Whitelist
stonesit.bypass.region	op	Umgeht Claim-/Regions-Einschränkungen (trusted-region-only)
stonesit.kick.*	op	Beinhaltet stonesit.kick.sit und stonesit.kick.pose
stonesit.kick.sit	op	Erlaubt das Verdrängen eines bereits sitzenden Spielers vom selben Block (wenn same-block-rest: false)
stonesit.kick.pose	op	Erlaubt das Verdrängen eines bereits liegenden Spielers vom selben Block (wenn same-block-rest: false)
stonesit.reload	op	Erlaubt das Neuladen der StoneSit-Konfiguration (/stonesitreload, /sit reload)

(Hinweis: Zur Abwärtskompatibilität werden auch die originalen GSit.*-Permissions wie GSit.Sit, GSit.Lay, GSit.LegsUp, GSit.PlayerSit automatisch erkannt.)

---

13. Globale Konfiguration, Auto-Updater & Datenbank

🔄 Automatischer Konfigurations-Updater (Auto-Sync)

Ztone verfügt über ein integriertes Auto-Sync-System (ConfigUtil):

• Beim Starten oder Neuladen des Plugins gleicht Ztone alle physischen .yml-Dateien auf der Festplatte mit den neuesten Standarddateien aus der JAR ab.
• Kein Verlust bestehender Werte: Bereits vorhandene Benutzereinstellungen, geänderte Texte oder Zahlen werden niemals überschrieben.
• Automatische Ergänzung: Neu hinzugekommene Optionen, Untersektionen und Standard-Kommentare werden automatisch in die Datei auf der Festplatte eingefügt.
• Gilt für alle Configs: Hauptkonfiguration (config.yml), Clan-System (clansystem/), PvPManager (pvpmanager/), Claims (claims/), DeathChest (deathchest/), ClearLag (clearlag/), StoneAttack (stoneattack/), StoneLog (stonelog/), MapControl (mapcontrol/), PlayRewards (playrewards/) und StoneSit (stonesit/).

⚙️ Modul-Aktivierung (plugins/Ztone/config.yml)

In der zentralen Konfigurationsdatei können alle Submodule einzeln de-/aktiviert werden:

modules:
  clansystem: true
  pvpmanager: true
  claims: true
  stoneattack: true
  stonelog: true
  mapcontrol: true
  stonevoice: true
  playrewards: true
  deathchest: true
  clearlag: true
  stonesit: true

database:
  type: "sqlite" # oder "mariadb"
  file: "ztone.db"
  table-prefix: "ztone_"

---

14. PlaceholderAPI Gesamtübersicht

Alle Platzhalter erfordern das installierte Plugin PlaceholderAPI.

🏰 Clan-Platzhalter (%clansystem_...% oder %ztone_...%)

Placeholder	Rückgabewert
%clansystem_clan_name%	Clan-Name mit Farbcodes
%clansystem_clan_name_raw%	Clan-Name ohne Farbcodes
%clansystem_clan_tag%	Clan-Suffix mit Farbe
%clansystem_clan_tag_raw%	Clan-Suffix als Rohtext
%clansystem_clan_rank%	Name des eigenen Clan-Rangs
%clansystem_clan_level%	Aktuelles Clan-Level
%clansystem_clan_points%	Gesamtpunkte des Clans
%clansystem_clan_balance%	Kontostand der Clankasse
%clansystem_clan_members_count%	Anzahl der Mitglieder
%clansystem_clan_members_online%	Anzahl der online Mitglieder
%clansystem_has_clan%	true oder false
%clansystem_is_leader%	true oder false

🪑 StoneSit-Platzhalter (%stonesit_...% oder %gsit_...%)

Placeholder	Rückgabewert
%stonesit_sitting% / %gsit_sitting%	true oder false (Block-Sit oder PlayerSit)
%stonesit_blocksitting% / %gsit_blocksitting%	true oder false (Sitzt auf einem Block)
%stonesit_playersitting% / %gsit_playersitting%	true oder false (Sitzt im Spieler-Stapel)
%stonesit_spinning% / %gsit_spinning%	true oder false (Dreht sich per /spin)
%stonesit_posing% / %gsit_posing%	true oder false (Liegt per /lay oder /legsup)
%stonesit_pose% / %gsit_pose%	lay, legs_up, spin oder none

---

15. Kompilierung & Entwicklung

# Kompilieren mit Gradle Shadow-Jar
./gradlew shadowJar

Die fertige Server-JAR befindet sich im Verzeichnis build/libs/Ztone-1.1.3.jar.

---

16. Changelog v1.1.2

⚙️ System & Administration

• Automatischer messages.yml-Reset beim Serverstart:
  • Veraltete messages.yml-Dateien (clansystem/messages.yml, claims/messages.yml, stoneattack/messages.yml) sowie Sprachdateien (pvpmanager/locale/messages_de.properties) werden beim Serverstart automatisch durch die neuesten Versionen aus der JAR ersetzt.
  • Bestehende Dateien werden vorab sicher als .old gesichert (z. B. messages.yml.old).
• WorldGuard-Regionssperre für Claims:
  • Chunks, die sich mit geschützten WorldGuard-Regionen überschneiden (ausgenommen __global__), können von Spielern nicht geclaimt werden.
  • Vollständig reflexionsbasiert ohne harte Compile-Time-Abhängigkeit.
• Erweiterter /clanadmin info-Befehl:
  • Zeigt nun die vollständige Mitgliederliste mit Rangbezeichnung, Rang-Priorität und Online-Status (Grün/Grau) an.
• Admin Claim-Merge (/staffclaim merge [all|<Spieler>]):
  • Ermöglicht das Zusammenführen aneinandergrenzender Claims für einzelne Spieler oder serverweit.
• Chat-Prefixe & Small-Caps-Vereinheitlichung:
  • Alle verbliebenen Legacy-Prefixe ([Clan], [Krieg]) wurden restlos entfernt.
  • Konsistente Nutzung des Prefixes &b&lᴄʟᴀɴꜱʏꜱᴛᴇᴍ &8>> &r und Small-Caps-Formatierung für alle Clan-Meldungen.

🎮 Gameplay & Clan-Features

• Automatisches Claim-Merging (/claim merge):
  • Aneinandergrenzende Claims desselben Besitzers in der gleichen Welt verschmelzen automatisch zu einem gemeinsamen Groß-Claim (beim Claimen, Übertragen und rückwirkend beim Serverstart).
  • Spieler können ihre Claims per /claim merge jederzeit manuell konsolidieren.
• PvP Combat-Flugschutz:
  • Im Kampf (Combat Tag) wird der Flugmodus (/fly) sofort forciert deaktiviert.
  • Flugversuche während des Gefechts werden mit einer Fehlermeldung unterbunden.
• Clankrieg 12h-Cooldown & Kriegslimit:
  • Nach Kriegsende (Sieg, Niederlage oder Kapitulation) gilt eine 12-stündige Abklingzeit für beide Clans.
  • Jeder Clan kann maximal 1 aktiven Clankrieg gleichzeitig austragen.
• Optionale Clankriege in Clan-Einstellungen (ab Level 7):
  • Freischaltung ab Clan-Level 7 in clansystem/level.yml (wars-toggle-unlocked: true).
  • Im Einstellungsmenü (Slot 29) de- und aktivierbar. Deaktivierte Clans können weder angegriffen werden noch Kriege erklären.
• Vollständige Clankassen-Schuldensperre:
  • Bei Minus auf dem Clankonto sind alle Clan-Interaktionen gesperrt (Homes, Warps, Kiste, Allianzen, Einstellungen, Kriege).
  • Clans mit Schulden können weder einen Krieg erklären noch kann ihnen der Krieg erklärt werden.
• DeathChest Plünder-Feedback & Schutz:
  • Entnimmt ein Spieler Items aus einer fremden Todeskiste, erhält das Opfer sofort eine Chat-Benachrichtigung mit Täter, Item und Anzahl.
  • Todeskisten despawnen bei Server-Restarts nicht mehr und behalten ihren Plünder-Status bei (kein Dupe/Rollback).
  • Verwaiste Hologramme werden beim Serverstart und Chunk-Load automatisch bereinigt.

🐛 Behobene Fehler

• Clan-Kiste Dupe-Glitch: Behebt Duplikationsmöglichkeiten beim Serverneustart bei geöffneter Kiste.
• DeathChest Loot-Rollback: Bereits entnommene Beute wird nach einem Reload/Restart nicht mehr zurückgesetzt.
• Kriegserklärungen gegen verschuldete Clans: Vollständig unterbunden.

---

17. Changelog v1.1.3

⚙️ System & Administration

• Versionierung:
  • Plugin-Version, Build-Skripte und Modulschnittstellen auf Version 1.1.3 angehoben.
• WorldGuard Custom-Flag claim (Ersatz der alten pauschalen Regionensperre):
  • Die alte Variante (pauschale Sperre jedes Chunks, der eine beliebige WorldGuard-Region berührt) wurde vollständig entfernt.
  • Neues WorldGuard StateFlag claim (Default: ALLOW) registriert – sichtbar in /rg flags <region> unter Third-Party Flags.
  • Granulare Kontrolle pro Region via /rg flag <region> claim <allow|deny> sowie über __global__.
  • Volle Unterstützung von WorldGuard-Prioritäten und Regionen-Hierarchien.
  • Startup-Lifecycle (load: STARTUP) implementiert, damit Flags vor dem Einfrieren der WorldGuard FlagRegistry in onLoad() registriert werden; Welten- und Modulstarts laufen synchron und sicher über ServerLoadEvent.
• Neues Clan-Steuersystem (ClanTaxManager):
  • Automatischer, globaler Steuereinzug in konfigurierbaren Intervallen (Standard: alle 7 Tage) direkt aus der Clankasse (balance).
  • Persistente Speicherung des letzten Einzugszeitpunkts in der zentralen SQLite-Datenbank (metadata-Tabelle) – kein Reset des Zyklus durch Server-Restarts oder Downtimes.
  • Vollständige Konfiguration in clansystem/config.yml unter taxes: (enabled, interval-days, grace-period-days, level-base, balance-brackets mit min, max, multiplier, flat-tax).
• Admin-Befehle für Steuern (/clanadmin taxes):
  • /clanadmin taxes info: Zeigt den aktuellen Status, Intervall, Schonfrist, letzten und nächsten Einzugszeitpunkt an.
  • /clanadmin taxes run: Löst einen sofortigen manuellen Steuereinzug für alle Clans aus.
  • Tab-Vervollständigung und eigene Permission clansystem.admin.taxes (bzw. clansystem.admin).

🎮 Gameplay & Clan-Features

• Transparente Steuerformel & Kassenstaffeln:
  • Formel: $\text{Gesamtsteuer} = \text{Level-Basiswert} + (\text{Clankasse} \times \text{Multiplikator}) + \text{Flat-Steuer}$.
  • Progressive Staffelung je nach Kontostand der Clankasse mit anpassbaren Multiplikatoren und Festbeträgen.
• 14 Tage Schonfrist für neue Clans:
  • Neu gegründete Clans sind in den ersten zwei Wochen (grace-period-days: 14) vollständig von Steuerabzügen ausgenommen.
• Kopplung an die Clankassen-Schuldensperre:
  • Reicht das Guthaben der Clankasse nicht aus, fällt der Clan ins Minus.
  • Sämtliche Clan-Funktionen bleiben blockiert, bis die Schulden per Einzahlung (/clan deposit) beglichen werden.
• Transaktionsverlauf & Benachrichtigungen:
  • Steuerabzüge werden im Kassenbuch (/clan bank) mit eigenem Icon (Steuern) und detaillierter Lore protokolliert.
  • Bei Fälligkeit werden alle online befindlichen Clanmitglieder mit einer Chat-Nachricht (inkl. Schuldenwarnung bei Minus) informiert.
• Steuerübersicht & GUI-Vorschau:
  • Befehl /clan taxes (und /clan bank taxes / /clan steuern) zur Anzeige der detaillierten Kostenaufstellung, Kassenstaffel, Multiplikatoren und des nächsten Fälligkeitsdatums.
  • Das Clankassen-Item in der Haupt-GUI (Slot 31) zeigt die anstehende Steuerlast oder die verbleibende Schonfrist direkt in der Lore an.
• StoneSit /spin-Befehl & 360° Rotations-Animation:
  • Befehl /spin (mit Aliasen /gspin, /stonespin) nach dem Vorbild von GSit hinzugefügt.
  • Lässt den Spieler kontinuierlich und flüssig 360° um die eigene Achse auf einem unsichtbaren Drehsitz rotieren.
  • Beendigung per Sneaken (Shift), Schaden, Teleportieren oder erneutes Ausführen des Befehls.
  • Voll integriert mit Berechtigungen (stonesit.spin), WorldGuard-/Claim-Checks und Platzhaltern (%stonesit_spinning%, %stonesit_pose%).

🐛 Behobene Fehler

• StoneSit Rüstungs-Anzeigefehler bei /lay & /legsup behoben:
  • Es wurde behoben, dass bei Verwendung von /lay oder /legsup die gesamte Rüstung und gehaltene Gegenstände für andere Spieler unsichtbar wurden.
  • Rüstungspakete werden nun bereits im Spawn-Bundle des Fake-Bett-NPCs mitgesendet und beim Aufstehen zuverlässig vor dem Bereinigen der Viewer-Referenzen wiederhergestellt.
  • Ein ungültiger Reflexionsaufruf auf NMS-Inventarmethoden wurde durch direkte Abfrage der NMS-Ausrüstungsslots ersetzt.

---

18. Changelog v1.1.5

🛠️ Admin & System

• Versionierung:
  • Plugin-Version, Build-System und alle Schnittstellen auf Version 1.1.5 angehoben.
• Modulare Auslagerung des Stonemute-Moduls:
  • Das Stonemute-Modul (LiteBans zu SimpleVoiceChat Mute-Synchronisation) wurde vollständig aus dem Ztone-Kern entfernt.
  • Stonemute steht ab sofort als eigenständiges, hochperformantes Paper-Plugin unter C:\Stonemute bereit.
  • Sämtliche Abhängigkeiten zu LiteBans (litebans:api), Soft-Depends und Permissions wurden aus Ztone entfernt.
  • Spürbare Entlastung des Hauptplugins und schlankere Jar-Dateigröße.

🐛 Behobene Fehler

• DeathChest Endlosschleife / StackOverflowError bei Parallel World Ticking:
  • Behoben: Auf Server-Cores mit aktivem Parallel World Ticking (Leaf, SparklyPaper) führte das Schließen einer Todeskiste durch Scheduler-Verzögerung (runTask) und zirkuläre closeInventory()-Aufrufe in saveActiveChests() zu einem unmittelbaren StackOverflowError und Server-Crash.
  • saveActiveChests() schließt im laufenden Serverbetrieb keine Spieler-Inventare mehr zwangsweise (saveActiveChests(false)).
  • Schließvorgänge in DeathChestManager werden nun über ein closingPlayers-Set vor zirkulären Aufrufen geschützt.
  • DeathChestListener führt das Speichern und Aufräumen von Kisten beim Schließen nun direkt synchron aus, wodurch Race-Conditions mit weltbezogenen Ticking-Threads ausgeschlossen sind.