(GIF COMING SOON)
# 
CLANS — Ultimate Clan Management & Progression System
### Compatible with 1.20 - 1.21+ | Native Folia support | Bedrock (Geyser/Floodgate) Friendly | Advanced API
Clans is a highly optimized, feature-rich, and premium clan management plugin designed for modern Spigot, Paper, and Folia servers. Built with visual excellence and peak server performance in mind, Clans offers customizable matrix-based GUIs, an interactive banner editor, automated regional ticks, anti-alt abuse prevention, and a comprehensive developer API.
##
Key Features
*
Interactive Flag & Banner Maker
Create, edit, and preview custom clan flags in a beautiful GUI. Supports dye coloring, pattern application, undo/redo states, and live resets. Perfect for cosmetic progression.
*
Native Folia Multi-Threading
Engineered from the ground up to support regionized servers. Runs connection queries, leaderboard recalculations, and database transactions fully asynchronously, keeping ticks at a constant 20.0 TPS.
*
Integrated Clan Bank & Vault Hook
Let members deposit and withdraw funds to scale their clan. Fully hooks into Vault economy with custom deposit/withdraw slot matrices.
*
Anti-Alt Score Farming Protection
Stop players from farming points by killing their alt accounts. Monitors IP matches, tracks cross-kills, alerts staff, logs transactions, and punishes abusers automatically.
*
Dynamic Scoring & Leaderboards
A complete progression system. Earn points for kills (+10), mining diamonds (+1), and smelting scrap (+2), while losing points on deaths (-5). Leaderboards update asynchronously.
*
High-Performance HikariCP Pool
Supports both SQLite (WAL mode) and MySQL. Databases update periodically using an optimized database worker thread to prevent main-thread locks.
*
Premium Developer API & Event Hooks
11 custom cancelable Bukkit events allow developers to hook into every single command, rename, home teleport, chest open, role change, and alliance invite.
*
Zero-Dependency Atomic Migrators
Moving from another plugin? Instantly import all user data, stats, items, and allies from ZelTeams, BetterTeams, SimpleClans, or UltimateClans with a single command:
*
Lightweight Library Loader
Caffeine and HikariCP download automatically at runtime on startup. The download footprint is under 180 KB!
##
Commands & Permissions
### Player Commands (Permission:
### Admin Commands (Permission:
CLANS — Ultimate Clan Management & Progression System### Compatible with 1.20 - 1.21+ | Native Folia support | Bedrock (Geyser/Floodgate) Friendly | Advanced API
Clans is a highly optimized, feature-rich, and premium clan management plugin designed for modern Spigot, Paper, and Folia servers. Built with visual excellence and peak server performance in mind, Clans offers customizable matrix-based GUIs, an interactive banner editor, automated regional ticks, anti-alt abuse prevention, and a comprehensive developer API.
##
Key Features*
Interactive Flag & Banner MakerCreate, edit, and preview custom clan flags in a beautiful GUI. Supports dye coloring, pattern application, undo/redo states, and live resets. Perfect for cosmetic progression.
*
Native Folia Multi-ThreadingEngineered from the ground up to support regionized servers. Runs connection queries, leaderboard recalculations, and database transactions fully asynchronously, keeping ticks at a constant 20.0 TPS.
*
Integrated Clan Bank & Vault HookLet members deposit and withdraw funds to scale their clan. Fully hooks into Vault economy with custom deposit/withdraw slot matrices.
*
Anti-Alt Score Farming ProtectionStop players from farming points by killing their alt accounts. Monitors IP matches, tracks cross-kills, alerts staff, logs transactions, and punishes abusers automatically.
*
Dynamic Scoring & LeaderboardsA complete progression system. Earn points for kills (+10), mining diamonds (+1), and smelting scrap (+2), while losing points on deaths (-5). Leaderboards update asynchronously.
*
High-Performance HikariCP PoolSupports both SQLite (WAL mode) and MySQL. Databases update periodically using an optimized database worker thread to prevent main-thread locks.
*
Premium Developer API & Event Hooks11 custom cancelable Bukkit events allow developers to hook into every single command, rename, home teleport, chest open, role change, and alliance invite.
*
Zero-Dependency Atomic MigratorsMoving from another plugin? Instantly import all user data, stats, items, and allies from ZelTeams, BetterTeams, SimpleClans, or UltimateClans with a single command:
/clanadmin migrate <plugin> confirm.*
Lightweight Library LoaderCaffeine and HikariCP download automatically at runtime on startup. The download footprint is under 180 KB!
##
Commands & Permissions### Player Commands (Permission:
clans.use)/clan➟ Opens the main Clan Detail GUI (or Clan List if player is clanless)./clan create <tag>➟ Register a new clan./clan rename <name>➟ Change the clan display name./clan home➟ Teleport to the clan home (respects combat & movement delay)./clan sethome➟ Set the clan home location./clan delhome➟ Delete the clan home location./clan chest➟ Opens the shared clan storage inventory./clan chat➟ Toggle clan-only chat mode (/cc <msg>also supported)./clan ally➟ Manage alliances./clan stats➟ View clan-wide statistics and member leaderboards./clan top➟ View server-wide clan ranking leaderboard.
### Admin Commands (Permission:
clans.admin)/clanadmin forcedisband <tag>➟ Wipe a clan from the server./clanadmin inspect <tag>➟ Pull up full details on a clan and its members./clanadmin spy➟ Toggle chat spy to monitor private clan chats./clanadmin reload➟ Hot-reload configs, messages, and menus without server restart./clanadmin resetstats <player>➟ Wipe a player's statistics./clanadmin setowner <player> <tag>➟ Force transfer ownership./clanadmin migrate <plugin> confirm➟ Run atomic database migrations.
