English Description
A lightweight, high-performance system to manage player heads with rank-based cooldowns via a MySQL database.

1. About the Plugin
KopfSystem was specifically developed for Citybuild and Survival networks. Unlike conventional systems, this plugin does not store usage data in local files, but in a MySQL database. This enables cross-server synchronization of cooldowns. The heart of the plugin is the dynamic limit system, which allows administrators to set individual waiting times for each rank.

2. Features
* MySQL Integration: Global sync for BungeeCord/Velocity networks.
* Dynamic Ranks: Create unlimited custom time limits in the config.yml. Existing ranks can be changed or new ones added at any time!
* Smart Prioritization: Players with multiple ranks automatically receive the best (shortest) cooldown.
* Smart Tab-Completion: The /kopf command suggests online players automatically.
* Zero-Lag: Asynchronous database connections to keep your TPS stable.
* 1.21.x Ready: Optimized for the latest Minecraft versions and Java 21.

3. Commands & Permissions
* /kopf <Name> | Permission: kopfsystem.limit.<ID>
* /kopf reload | Permission: kopfsystem.admin
Note: Replace <ID> with the rank name from your config (e.g., kopfsystem.limit.premium).
⚠️ LuckPerms: This plugin is highly recommended to be used with LuckPerms!


Deutsche Beschreibung
Ein leichtgewichtiges, hochperformantes System, um Spielerköpfe mit rangbasierten Cooldowns über eine MySQL-Datenbank zu verwalten.

1. Über das Plugin
Das KopfSystem wurde speziell für Citybuild- und Survival-Netzwerke entwickelt. Im Gegensatz zu herkömmlichen Systemen speichert dieses Plugin die Nutzungsdaten in einer MySQL-Datenbank. Dies ermöglicht eine serverübergreifend Synchronisation der Cooldowns. Das Herzstück ist das dynamische Limit-System, welches Administratoren erlaubt, für jeden Rang individuelle Wartezeiten festzulegen.

2. Hauptfeatures
* MySQL-Anbindung: Cooldowns werden global gespeichert. Perfekt für BungeeCord/Velocity Netzwerke.
* Dynamische Ränge: Erstelle unendlich viele Zeit-Limits in der config.yml. Vorhandene Ränge können jederzeit abgeändert oder neue hinzugefügt werden!
* Intelligente Priorisierung: Spieler mit mehreren Rängen erhalten automatisch den besten (kürzesten) Cooldown.
* Smart Tab-Completion: Der Befehl /kopf schlägt online befindliche Spieler automatisch vor.
* Zero-Lag: Asynchrone Datenbank-Verbindungen, um den Haupt-Serverthread niemals zu blockieren.
* 1.21.x Ready: Optimiert für die neuesten Minecraft-Versionen und Java 21.

3. Befehle & Berechtigungen
* /kopf <Name> | Permission: kopfsystem.limit.<ID>
* /kopf reload | Permission: kopfsystem.admin
Hinweis: Ersetze <ID> durch den Namen des Ranges in deiner Config (z.B. kopfsystem.limit.premium).
⚠️ LuckPerms: Es wird dringend empfohlen, dieses Plugin mit LuckPerms zu nutzen!

4. Konfiguration (Example)
"I wrote this plugin to bridge the gap between simple local head plugins and complex all-in-one systems. It's slim, fast, and extremely reliable for growing servers thanks to its MySQL structure." - BlackCyper