[1.21] ️ClanSystem ✨ Customizable⭐

✨ Customizable⭐Clan plugin

Open in MCModsHub Get it on Google Play →

ClanSystem
Clans mit Rängen, Diplomatie und Level-System — komplett über GUI bedienbar

Paper 1.21+ · Java 21 · SQLite oder MySQL · vollständig konfigurierbar

Worum es geht

ClanSystem gibt deinen Spielern eine feste Gruppe, an die sie sich binden: mit
eigenem Namen, farbigem Tag, internen Rängen und einer Rangliste, für die sich
das Spielen lohnt.

Alles Wichtige läuft über ein Inventar-Menü — Mitglieder befördern, Verbündete
annehmen, den Tag umfärben. Wer lieber tippt, erreicht jede Funktion genauso
über Befehle. Beides ist vollständig, keins ist eine abgespeckte Variante des
anderen.

Jeder Text im Plugin steht in der messages.yml und lässt sich
ändern. Nichts ist im Code festgeschrieben.

Funktionen

Clans mit Tag und Farbe — Länge, erlaubte Zeichen und auswählbare
Farben legst du selbst fest. Gesperrte Namen lassen sich hinterlegen.
Vier Ränge — Leader, Co-Leader, Moderator, Mitglied. Welcher Rang was
darf, bestimmst du über elf einzeln zuweisbare Berechtigungen.
Diplomatie — Allianzen auf Anfrage, Feindschaften per Erklärung.
Freundbeschuss lässt sich pro Clan und für Verbündete getrennt regeln.
Level und XP — Kills bringen XP, Tode kosten welche. Höhere Level
schalten Mitgliederplätze frei; optional führt der Server dabei eigene Befehle
aus. Eine Anti-Farming-Sperre verhindert das Ausnutzen durch wiederholte Kills
am selben Spieler.
Clan-Chat — dauerhaft umschaltbar oder für eine einzelne Nachricht.
Das Format bestimmst du.
Rangliste — nach Level, XP und Kills, blätterbar.
Acht GUI-Menüs — Übersicht, Mitglieder, Statistiken, Diplomatie,
Einstellungen, Farbwahl, Einladungen und Bestätigungsdialoge.
Einladungen mit Ablaufzeit — inklusive Obergrenze für offene
Einladungen pro Spieler.
PlaceholderAPI — über 30 Platzhalter für TAB, Scoreboard und Chat.
Optional; ohne PlaceholderAPI läuft alles normal weiter.
Vollständige Tab-Vervollständigung bei jedem Befehl.
Adminwerkzeuge — Clans auflösen, Leader setzen, Spieler zwangsweise
hinzufügen oder entfernen, Level setzen, neu laden ohne Serverneustart.

Befehle

/clan (Aliase: /c, /clans)

Code (Text):

/clan menu Öffnet das Clan-Menü
/clan create <Name> <Tag> Erstellt einen Clan
/clan info [Clan] Zeigt Clan-Informationen
/clan list [Seite] Listet alle Clans auf
/clan top [Seite] Rangliste nach Level, XP und Kills
/clan members [Clan] Mitglieder mit Rang und Online-Status
/clan stats [Clan] Statistiken eines Clans

/clan invite <Spieler> Lädt einen Spieler ein
/clan invites Zeigt die eigenen Einladungen
/clan accept <Clan> Nimmt eine Einladung an
/clan deny <Clan> Lehnt eine Einladung ab
/clan kick <Spieler> Entfernt ein Mitglied
/clan promote <Spieler> Befördert ein Mitglied
/clan demote <Spieler> Degradiert ein Mitglied
/clan transfer <Spieler> confirm Überträgt die Leader-Rolle

/clan tag <Tag> Ändert den Clan-Tag
/clan color [Farbe] Ändert die Tag-Farbe
/clan rename <Name> Benennt den Clan um
/clan description <Text|clear> Setzt oder löscht die Beschreibung
/clan friendlyfire [on|off] Schaltet den Freundbeschuss um

/clan ally <request|accept|deny|remove|list> [Clan]
/clan enemy <declare|remove|list> [Clan]

/clan chat [Nachricht] Clan-Chat umschalten oder senden
/clan leave Verlässt den Clan
/clan disband confirm Löst den Clan auf

/clanchat (Alias: /cc) — schaltet zwischen Global-
und Clan-Chat um, mit Text dahinter wird eine einzelne Nachricht gesendet.

/clanadmin (Aliase: /ca, /clanadministration)

Code (Text):

/clanadmin info <Clan> Details inklusive UUIDs
/clanadmin delete <Clan> Löst einen beliebigen Clan auf
/clanadmin setleader <Clan> <Spieler> Setzt den Leader
/clanadmin add <Spieler> <Clan> [Rang] Fügt einen Spieler hinzu
/clanadmin remove <Spieler> Entfernt einen Spieler
/clanadmin setlevel <Clan> <Level> Setzt Level und passende XP
/clanadmin reload Lädt die Konfiguration neu

Berechtigungen

Code (Text):

clansystem.command.* true Alle Spielerbefehle
clansystem.command.<name> true Einzelne Spielerbefehle
clansystem.admin op Alle Administrationsrechte
clansystem.admin.<name> op Einzelne Adminrechte
clansystem.* op Alles

Wichtig zu verstehen: Die Bukkit-Berechtigung entscheidet nur, ob ein
Spieler einen Befehl benutzen darf. Ob er die Aktion in seinem Clan
ausführen darf, hängt zusätzlich an seinem Clan-Rang. So kann jeder
/clan kick eingeben, aber nur wer die Berechtigung
KICK in seinem Rang hat, wirft auch jemanden raus.

Ränge und Clan-Berechtigungen

Feste Hierarchie: Leader > Co-Leader > Moderator > Mitglied

Ein Mitglied kann immer nur Mitglieder mit echt niedrigerem Rang verwalten. Der
Leader ist unantastbar — daran ändert nur /clan transfer oder ein
Adminbefehl etwas.

Diese elf Berechtigungen verteilst du frei auf die Ränge:

Code (Text):

INVITE KICK MANAGE_RANKS
CHANGE_TAG CHANGE_COLOR CHANGE_NAME
CHANGE_DESCRIPTION TOGGLE_FRIENDLY_FIRE MANAGE_DIPLOMACY
DISBAND TRANSFER_OWNERSHIP

Code (Text):

ranks:
member: []
moderator: [INVITE, KICK]
co_leader: [INVITE, KICK, MANAGE_RANKS, CHANGE_TAG, CHANGE_COLOR,
CHANGE_DESCRIPTION, MANAGE_DIPLOMACY]
leader: ['*'] # der Leader besitzt immer alle Rechte

Level und XP

Code (Text):

Benötigte XP von Level n auf n+1 = base-xp * n ^ exponent

Kurve, Maximallevel und Belohnungen stehen in der config.yml.
Belohnungen wirken kumulativ — ein Clan auf Level 10 hat alle bis dahin
freigeschalteten Mitgliederplätze. Beim Aufstieg lassen sich zusätzlich
Konsolenbefehle ausführen, mit den Platzhaltern %clan%,
%tag%, %leader% und %level%.

PlaceholderAPI

Ist PlaceholderAPI installiert, meldet sich das Plugin von selbst unter der
Kennung clansystem an. Damit zeigen TAB, Scoreboard- oder
Chat-Plugins den Clan-Tag an, ohne dass ClanSystem in deren Formate eingreift.

Spoiler: Alle Platzhalter anzeigen

Spielerbezogen

Code (Text):

%clansystem_has_clan% true / false
%clansystem_clan% Testclan
%clansystem_clan_colored% Testclan (in Clan-Farbe)
%clansystem_tag% TST
%clansystem_tag_formatted% [TST] (in Clan-Farbe)
%clansystem_color% DARK_RED
%clansystem_rank% Leader
%clansystem_rank_raw% LEADER
%clansystem_rank_weight% 4
%clansystem_is_owner% true / false
%clansystem_member_kills% eigene Kills
%clansystem_member_deaths% eigene Tode
%clansystem_member_kd% eigene K/D
%clansystem_joined% 26.07.2026 10:10

Clanbezogen

Code (Text):

%clansystem_owner% Leader1
%clansystem_description% Ein Testclan
%clansystem_members% 2
%clansystem_online% 1
%clansystem_member_limit% 12
%clansystem_kills% 42
%clansystem_deaths% 7
%clansystem_kd% 6,00
%clansystem_level% 3
%clansystem_max_level% 25
%clansystem_xp% 1200
%clansystem_xp_next% 620
%clansystem_progress% 65%
%clansystem_allies% 1
%clansystem_enemies% 0
%clansystem_friendly_fire% true / false
%clansystem_created% 26.07.2026 10:10

Rangliste und Server

Code (Text):

%clansystem_total_clans% 2
%clansystem_top_<Platz>_<Feld>% z. B. %clansystem_top_1_tag%

Mögliche Felder: name, name_colored, tag, tag_formatted, owner,
level, xp, kills, deaths, kd, members, online

Hat ein Spieler keinen Clan, kommt der Wert aus der messages.yml
zurück — standardmäßig ein leerer Text. So bleibt in TAB kein leeres
Klammerpaar stehen.

Beispiel für TAB:

Code (Text):

tabprefix: '%clansystem_tag_formatted% '
tagprefix: '%clansystem_tag_formatted% '

Technisches

Das Plugin hält den gesamten Datenbestand im Arbeitsspeicher. Geladen wird
einmalig beim Serverstart, danach findet kein blockierender Datenbankzugriff
im Main-Thread mehr statt. Änderungen landen sofort im Cache und werden über
einen einzelnen Hintergrund-Thread geschrieben — der garantiert nebenbei die
richtige Reihenfolge, sodass ein Mitglied nie vor seinem Clan in der Datenbank
landet.

Beim Herunterfahren werden offene Menüs geschlossen, ausstehende Schreibvorgänge
bekommen bis zu zehn Sekunden Zeit, danach wird der Verbindungspool geschlossen.
Ein /stop kostet dich also keine Daten.

Datenbank: SQLite (Voreinstellung, keine Einrichtung nötig) oder
MySQL/MariaDB. Beide nutzen dasselbe Schema, ein Wechsel ist eine Zeile in der
Konfiguration.
Verbindungspool: HikariCP. Bei SQLite auf eine Verbindung begrenzt,
mit WAL-Modus — so wie SQLite es verträgt.
Namen und Tags sind über zusätzliche Kleinschreibungs-Spalten
eindeutig, unabhängig von der Collation der Datenbank.
Nachrichten im MiniMessage-Format. Nach einem Update werden fehlende
Schlüssel automatisch ergänzt, deine Anpassungen bleiben erhalten. Ein leerer
Text schaltet eine Meldung ab.

Installation

ClanSystem-1.0.0.jar in den Ordner plugins/ legen
Server starten — config.yml, messages.yml und bei
SQLite die clans.db werden angelegt
Anpassen und /clanadmin reload ausführen

Bitte beachten: Beim ersten Start lädt Paper
die Bibliotheken HikariCP, SQLite-JDBC und MySQL-Connector selbst von Maven
Central nach. Dafür braucht der Server einmalig eine Internetverbindung. Danach
liegen sie im Ordner libraries/ und werden lokal verwendet. Das
JAR bleibt dadurch klein und enthält keine mitgelieferten Fremdbibliotheken.

Voraussetzungen: Java 21, Paper oder Purpur 1.21+ (getestet gegen 1.21.11)
Optional: PlaceholderAPI

Support

Fragen, Fehler und Wünsche am liebsten über https://discord.com/invite/RPqeHdEb — dort
antworte ich am schnellsten. Fehlermeldungen bitte mit Serverversion und dem
passenden Ausschnitt aus der latest.log.

Bewertungen sind kein Support-Kanal — wenn etwas nicht läuft, schreib mich an,
dann schauen wir es uns gemeinsam an.

Entwickelt von HanneZHD

[1.21] ️ClanSystem ✨ Customizable⭐ is a free Minecraft Java mod. Compatible with Minecraft 1.21. Downloaded 20 times (via Spigot). Download it and open it directly in the game.

Explore more

All Mods for Java All Minecraft Java mods Java mods for 1.21