Clan Master

---

Why ClanMaster

Players can do almost everything from a clickable menu, so they don't have to memorize commands. The full command set is still there for anyone who prefers typing. Saves run asynchronously, friendly fire and chest locks are actually enforced, and the plugin comes with nine languages.

Everything is configurable, MySQL is supported, and it works with PlaceholderAPI and TAB.

---

Features

Clans and roster

• One command clan creation with name validation and an optional cost
• Three ranks (Leader, Officer, Member) with clear permissions
• Invite, kick, promote, demote and transfer leadership
• Clickable accept and deny invite buttons in chat

Progression

• Clan levels and XP earned through kills and wars
• Configurable coin bonuses per level, paid out to members
• 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 and loss records, and a dedicated war leaderboard
• Automatic winner detection and rewards when peace is made
• Configurable maximum of simultaneous wars

Diplomacy

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

Protection

• Clanmates can't hurt each other unless the leader turns on clan PvP
• Only members can open a locked clan chest (clan.bypass overrides this)

Communication

• Toggleable clan chat and ally chat
• Staff spy mode to monitor clan channels
• Clan message of the day shown on login

Customization

• Custom colored prefix with hex, gradients and MiniMessage style tags
• Clan emoji picker in the GUI or by command
• Clan banner that you can wear, display or set as the clan icon
• Clan home: set, delete and teleport

Achievements

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

---

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 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 the message of the day
/clan bank | deposit | withdraw   Clan bank and 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

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 for zero setup, ideal for small servers
• SQLite as a single file database
• MySQL over the network, powered by HikariCP connection pooling

Writes are batched and run off the main thread from a snapshot of the data, so saving doesn't cause lag spikes or half written files.

---

Languages

Ships with English, Ukrainian, German, French, Spanish, Portuguese (Brazil), Italian, Dutch and Polish. Pick one in config.yml and edit any message in the lang files. If you set a language that has no bundled file, the plugin falls back to English, so you can add your own.

---

Configuration

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

---