#

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:
/clanadmin migrate <plugin> confirm.
*
Lightweight Library Loader
Caffeine 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.