PowerClans

# ⚔️ 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 ` | View clan information | | `/clan list` | List all clans | | `/clan top` | View top clans | | `/clan chat ` | 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 (https://www.spigotmc.org/resources/placeholderapi.6245/) | Placeholder | Output | |---|---| | `%powerclan_has_clan%` | `true` / `false` | | `%powerclan_clan_name%` | Clan name | | `%powerclan_clan_tag%` | Clan tag | | `%powerclan_clan_tag_formatted%` | `` 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