PowerClans

⚔️ PowerClans

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

---

✨ Features

- Fully Configurable Messages — Create clans with a unique name and tag - Fully Configurable Messages — Leader, Officer, and Member ranks with permission hierarchy - Fully Configurable Messages — Full inventory menu for managing everything visually - Fully Configurable Messages — Private messaging channel for clanmates with toggle support - Fully Configurable Messages — Players deposit money, leaders spend it on upgrades - Fully Configurable Messages — Level up your clan to unlock more member slots - Fully Configurable Messages — Toggle PvP between clanmates on or off - Fully Configurable Messages — Automatic K/D statistics per clan - Fully Configurable Messages — View all clans or browse the leaderboard - Fully Configurable Messages — Invite players with configurable timeout - Fully Configurable Messages — 15+ placeholders for scoreboards, tab, chat, and more - Fully Configurable Messages — 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

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

Neither is required. The plugin works standalone.

---

📌 Requirements

- Minecraft 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?

- Open architecture — No unnecessary features, no lag - Open architecture — Simple YAML data, no database required - Open architecture — Install, configure messages if you want, done - Open architecture — Clean codebase, easy to understand and extend