![KopfSystem [1.21.1+ - 26.3] | MySQL & YAML | Multi-Language | Rank-Based Cooldowns](https://www.spigotmc.org/data/resource_icons/134/134685.jpg?1777546322){kind=icon}
ModsJava
KopfSystem [1.21.1+ - 26.3] | MySQL & YAML | Multi-Language | Rank-Based Cooldowns
Java mod listed for Minecraft 1.21–26.x. Downloads from the MC Java Mods app on Android.
⬇ Download on Spigot
Code (Text):
_ __ _ _____ _
| |/ / | |/ ____| | |
| ' / ___ _ __ | | (___ _ _ ___| |_ ___ _ __ ___
| < / _ \| '_ \ | |\___ \| | | / __| __/ _ \ '_ ` _ \
| . \ (_) | |_) || |____) | |_| \__ \ || __/ | | | | |
|_|\_\___/| .__/ |_|_____/ \__, |___/\__\___|_| |_| |_|
| | __/ |
|_| |___/ By BlackCyper
_______________________________________________________
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!
⚙️ Configuration (config.yml)
Spoiler: Click to view the config.yml
# ==========================================================
# KOPFSYSTEM - CONFIGURATION
#
# Supported Languages in Comments: [DEUTSCH / ENGLISH]
# ==========================================================
# Das Prefix für alle Chat-Nachrichten
# The prefix for all chat messages
prefix : "&8[&bKopfSystem&8] &f"
storage :
# Speichermethode wählen: "YAML", "SQLITE" oder "MYSQL"
# Choose storage method: "YAML", "SQLITE" or "MYSQL"
method : "YAML"
mysql:
host : "localhost"
port : 3306
database : "minecraft"
user : "root"
password : ""
useSSL : false
autoReconnect : true
settings :
# Das Rang-System (Permissions) aktivieren oder deaktivieren.
# true = Cooldowns basierend auf Rängen (LuckPerms benötigt).
# false = "Free-Mode": Jeder Spieler kann jederzeit Köpfe ziehen.
#
# Enable or disable the rank system (permissions).
# true = Cooldowns based on ranks (LuckPerms required).
# false = "Free-Mode": Every player can get heads at any time.
use-permissions : true
# Wähle zwischen "de" oder "en"
# Choose between "de" or "en"
language : "de"
# ----------------------------------------------------------------------
# LIMITS / WARTEZEITEN (COOLDOWNS)
# ----------------------------------------------------------------------
# DE: HIER KANNST DU EIGENE RÄNGE FREI HINZUFÜGEN ODER ENTFERNEN!
# Wartezeit pro Rang in MINUTEN. Ein Permissions-Plugin (wie LuckPerms) wird benötigt.
# Wenn du hier einen neuen Rang einträgst, lautet die Permission automatisch:
# --> kopfsystem.limit.<name_des_rangs> (Beispiel: kopfsystem.limit.ultimate)
#
# Wenn ein Spieler KEINE dieser Berechtigungen hat, gilt er als Standardspieler
# und erhält automatisch die maximale Sperre von 43200 Minuten (30 Tage).
#
# EN: YOU CAN FREELY ADD OR REMOVE YOUR OWN RANKS HERE!
# Cooldown time per group/rank in MINUTES. A permission plugin (like LuckPerms) is required.
# If you add a new rank here, the permission will automatically be:
# --> kopfsystem.limit.<rank_name> (Example: kopfsystem.limit.ultimate)
#
# If a player has NONE of these permissions, they are treated as default players
# and will automatically receive the maximum cooldown of 43200 minutes (30 days).
# ----------------------------------------------------------------------
limits:
ultimate : 1440 # 24 Stunden / 24 Hours (Permission: kopfsystem.limit.ultimate)
king : 10080 # 7 Tage / 7 Days (Permission: kopfsystem.limit.king)
elite : 20160 # 14 Tage / 14 Days (Permission: kopfsystem.limit.elite)
premium : 43200 # 30 Tage / 30 Days (Permission: kopfsystem.limit.premium)
vip : 43200 # 30 Tage / 30 Days (Permission: kopfsystem.limit.vip)
Code (YAML):
# ==========================================================
# KOPFSYSTEM - CONFIGURATION
#
# Supported Languages in Comments: [DEUTSCH / ENGLISH]
# ==========================================================
# Das Prefix für alle Chat-Nachrichten
# The prefix for all chat messages
prefix : "&8[&bKopfSystem&8] &f"
storage :
# Speichermethode wählen: "YAML", "SQLITE" oder "MYSQL"
# Choose storage method: "YAML", "SQLITE" or "MYSQL"
method : "YAML"
mysql:
host : "localhost"
port : 3306
database : "minecraft"
user : "root"
password : ""
useSSL : false
autoReconnect : true
settings :
# Das Rang-System (Permissions) aktivieren oder deaktivieren.
# true = Cooldowns basierend auf Rängen (LuckPerms benötigt).
# false = "Free-Mode": Jeder Spieler kann jederzeit Köpfe ziehen.
#
# Enable or disable the rank system (permissions).
# true = Cooldowns based on ranks (LuckPerms required).
# false = "Free-Mode": Every player can get heads at any time.
use-permissions : true
# Wähle zwischen "de" oder "en"
# Choose between "de" or "en"
language : "de"
# ----------------------------------------------------------------------
# LIMITS / WARTEZEITEN (COOLDOWNS)
# ----------------------------------------------------------------------
# DE: HIER KANNST DU EIGENE RÄNGE FREI HINZUFÜGEN ODER ENTFERNEN!
# Wartezeit pro Rang in MINUTEN. Ein Permissions-Plugin (wie LuckPerms) wird benötigt.
# Wenn du hier einen neuen Rang einträgst, lautet die Permission automatisch:
# --> kopfsystem.limit.<name_des_rangs> (Beispiel: kopfsystem.limit.ultimate)
#
# Wenn ein Spieler KEINE dieser Berechtigungen hat, gilt er als Standardspieler
# und erhält automatisch die maximale Sperre von 43200 Minuten (30 Tage).
#
# EN: YOU CAN FREELY ADD OR REMOVE YOUR OWN RANKS HERE!
# Cooldown time per group/rank in MINUTES. A permission plugin (like LuckPerms) is required.
# If you add a new rank here, the permission will automatically be:
# --> kopfsystem.limit.<rank_name> (Example: kopfsystem.limit.ultimate)
#
# If a player has NONE of these permissions, they are treated as default players
# and will automatically receive the maximum cooldown of 43200 minutes (30 days).
# ----------------------------------------------------------------------
limits:
ultimate : 1440 # 24 Stunden / 24 Hours (Permission: kopfsystem.limit.ultimate)
king : 10080 # 7 Tage / 7 Days (Permission: kopfsystem.limit.king)
elite : 20160 # 14 Tage / 14 Days (Permission: kopfsystem.limit.elite)
premium : 43200 # 30 Tage / 30 Days (Permission: kopfsystem.limit.premium)
vip : 43200 # 30 Tage / 30 Days (Permission: kopfsystem.limit.vip)
If you like this plugin, please leave a ⭐⭐⭐⭐⭐ rating!
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21, 26.1, 26.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
KopfSystem [1.21.1+ - 26.3] | MySQL & YAML | Multi-Language | Rank-Based Cooldowns is a free Minecraft Java mod. Compatible with Minecraft 1.21, 26.1, 26.2, 26.3. Downloaded 41 times (via Spigot). Download it and open it directly in the game.