⚔️ PowerClans

A complete clan management system for your Minecraft server. Lightweight, easy to configure, and packed with features your players will love.

---

✨ Features

• Clan Creation — Create clans with a unique name and tag
• Role System — Leader, Officer, and Member ranks with permission hierarchy
• Interactive GUI — Full inventory menu for managing everything visually
• Clan Chat — Private messaging channel for clanmates with toggle support
• Clan Bank — Players deposit money, leaders spend it on upgrades
• Leveling System — Level up your clan to unlock more member slots
• Friendly Fire Protection — Toggle PvP between clanmates on or off
• Kill/Death Tracking — Automatic K/D statistics per clan
• Top & List — View all clans or browse the leaderboard
• Invite System — Invite players with configurable timeout
• PlaceholderAPI Support — 15+ placeholders for scoreboards, tab, chat, and more
• Vault Support — Optional economy integration for clan creation costs and bank deposits
• Fully Configurable Messages — Every single message lives in messages.yml

---

📋 Commands

Command	Description
/clan	Open the GUI menu
/clan create <name> <tag>	Create a new clan
/clan disband	Disband your clan
/clan invite <player>	Invite a player
/clan accept / deny	Accept or decline an invitation
/clan leave	Leave your clan
/clan kick <player>	Kick a member
/clan promote <player>	Promote to Officer
/clan demote <player>	Demote to Member
/clan setleader <player>	Transfer leadership
/clan info [clan]	View clan information
/clan list	List all clans
/clan top	View top clans
/clan chat [message]	Toggle or send clan chat
/clan desc <text>	Set clan description
/clan pvp	Toggle friendly fire
/clan deposit <amount>	Deposit into clan bank
/clan levelup	Level up the clan

Aliases: /clans, /c

---

🏷️ Placeholders

Requires PlaceholderAPI

Placeholder	Output
%powerclan_has_clan%	true / false
%powerclan_clan_name%	Clan name
%powerclan_clan_tag%	Clan tag
%powerclan_clan_tag_formatted%	[TAG] with colors
%powerclan_clan_level%	Clan level
%powerclan_clan_members%	Current member count
%powerclan_clan_max_members%	Max member slots
%powerclan_clan_kills%	Total clan kills
%powerclan_clan_deaths%	Total clan deaths
%powerclan_clan_kdr%	Kill/Death ratio
%powerclan_clan_bank%	Bank balance
%powerclan_clan_leader%	Leader name
%powerclan_clan_role%	Player's role
%powerclan_clan_description%	Clan description
%powerclan_clan_friendly_fire%	on / off

---

⚙️ Configuration

config.yml — Clan settings, name/tag length limits, creation cost, max level, level-up costs, member slots per level

messages.yml — Every message, GUI title, button label, and hint is fully customizable

---

📦 Soft Dependencies

• Vault — Economy support for creation costs and bank deposits
• PlaceholderAPI — Placeholder integration

Neither is required. The plugin works standalone.

---

📌 Requirements

• Minecraft 1.21+
• Java 21+

---

🖼️ GUI Preview

Open /clan to access a full interactive menu:

• View clan stats at a glance
• Browse members with role indicators
• Toggle clan chat, friendly PvP
• Level up, deposit, invite — all from the menu
• Top clans leaderboard view

---

💡 Why PowerClans?

• Zero bloat — No unnecessary features, no lag
• Single file storage — Simple YAML data, no database required
• Drop-in ready — Install, configure messages if you want, done
• Open architecture — Clean codebase, easy to understand and extend