Clan Master

---

Why ClanMaster?

No clunky commands to memorize, no bloat. Everything runs through a clean, fully clickable interface - while power users still get the full command set. Fast async storage, real rule enforcement, and four built-in languages out of the box.

Fully configurable · MySQL-ready · PlaceholderAPI · TAB-friendly

---

!Features

Features at a glance

Clans & Roster

• One-command clan creation with name validation & optional cost
• Three ranks - Leader · Officer · Member - with clear permissions
• Invite / kick / promote / demote / transfer leadership
• Clickable accept / deny invite buttons in chat

Progression

• Clan levels & XP earned through kills and wars
• Configurable per-level coin bonuses (now actually rewarded!)
• Level-up broadcasts with sound effects
• Live leaderboards by level and by war points

War System

• Declare war on rival clans and track kills in real time
• War points, win/loss records and a dedicated war leaderboard
• Automatic winner detection & rewards on peace
• Configurable max simultaneous wars

Diplomacy

• Alliances with two-way confirmation and shared ally chat
• Enemy declarations & peace treaties
• Clan-to-clan relationship tracking

Real Protection (new in 7.0)

• Friendly fire toggle is now enforced - clanmates are protected unless you allow it
• Clan chest locks are now enforced - only your members can open them (clan.bypass overrides)

Communication

• Toggleable clan chat & ally chat
• Staff spy mode to monitor clan channels
• Clan MOTD shown on login

Customization

• Custom colored prefix (hex, gradients & MiniMessage-style tags)
• Clan emoji picker (GUI or command)
• Clan banner - wear it, display it, or set it as your clan icon
• Clan home: set, delete & teleport

Achievements

• Built-in milestones: First Blood, Warrior, Veteran, Legend, War Winner
• XP rewards and server-wide unlock announcements
• Daily kill tracking

---

!Commands

Commands

/clan                     Open the main clan GUI
/clan create <name>       Create a clan
/clan invite <player>     Invite a player
/clan join | deny         Accept or decline an invite
/clan kick <player>       Remove a member
/clan promote|demote <p>  Change a member's rank
/clan transfer <player>   Hand over leadership
/clan leave | disband     Leave or disband your clan

/clan info [clan]         Clan info      /clan stats     Detailed stats
/clan top   | wartop      Leaderboards   /clan list      All clans
/clan war <clan>          Declare war    /clan peace <c> End a war
/clan ally <...> <clan>   Manage allies  /clan enemy <..> Manage enemies

/clan prefix <text>       Colored prefix /clan emoji [gui] Set emoji
/clan sethome|home        Clan home      /clan motd <t>  Set MOTD
/clan bank|deposit|withdraw   Clan bank / points
/clanchat · /allychat · /clanchatspy · /clanchest

Admin: /clanadmin save · reload · disband · info · givexp · setlevel · setwarpoints · addachievement · list

Aliases: /clans, /c, /cl · chat: /cc, /ac, /spy

---

Integrations

Plugin	What it adds
Vault	Creation cost & bank economy
PlaceholderAPI	40+ %clanmaster_...% placeholders
TAB / TabList	Clan tags in tablist & nametags

Popular placeholders: %clanmaster_name% · %clanmaster_level% · %clanmaster_members% · %clanmaster_rank% · %clanmaster_prefix% · %clanmaster_war_points% · %clanmaster_kd% · %clanmaster_top_name% · %clanmaster_online_members%

---

Storage

Choose your backend in config.yml:

• JSON - zero setup, perfect for small servers
• SQLite - single-file database
• MySQL - networked, powered by HikariCP connection pooling

All writes are debounced and off the main thread with a race-free snapshot - no lag spikes, no corrupted saves.

---

Languages

Ships with English, Українська, Deutsch & Français - just set language: in the config. Every message lives in an editable lang/*.yml file.

---

!Settings

Highly configurable

• Toggle any feature on/off in enabled-features
• Rename every menu title & button via menu-text
• Tune XP curves, bonuses, limits, costs and tag format
• Reload live with /clan reload

---