ClansFix

ClansFix

> Advanced clan management plugin for Paper 1.21.6

ClansFix is a full-featured clan system for Minecraft servers, designed for Paper 1.21.7 with a modern GUI-driven interface, multi-language support, and deep customization.

---

Features

⚔️ Clan Management

- Create / delete clans with configurable naming rules and economy costs - Invite players, accept join requests, or open clans for anyone to join - Kick members, promote/demote ranks, transfer ownership

📈 Level & Upgrade System

- 5 clan levels with quest-based progression - 18 quest types: kill mobs, mine blocks, collect items, catch fish, enchant, brew, trade, and more - Upgrade cost from clan treasury, per-level requirements

🏦 Treasury

- Deposit / withdraw money via Vault economy - Role-based permission: who can withdraw and who can deposit - Balance displayed in clan info and GUI

📦 Clan Storage

- Shared item vault accessible by trusted members - GUI-powered storage with permission gates

🏠 Clan House

- Set, teleport to, and delete your clan's home - Toggle via permissions

👥 Member Permissions

- 20 granular permissions assignable per member via GUI - Cover treasury, house, storage, raids, invites, armor, PvP, holograms, and more - Priority system prevents lower-rank members from overriding higher-rank permissions

🏆 Rankings

- Global clan ranking with composite score (KDR, balance, members, level, raid points) - Dedicated raid ranking leaderboard

💬 Clan Chat

- Private chat channel for clan members - Toggle on/off with `/clan chat`

🛡️ Raid System

- Wave-based PvE raids (7 waves, boss on wave 7) - Clan level and online member requirements - Point system with configurable scoring - Mob level scaling, particle effects, boss bars, custom AI - Reward commands for top participants and clans - Auto-generated raid zones with chunk loading protection - Cooldown between raids, max concurrent raids

🎨 Clan Armor & Coat of Arms

- Equip clan-wide visual armor set - Set a coat of arms (item icon) displayed above players

🔮 Holograms

- TextDisplay showing clan name above each member's head - ItemDisplay showing coat of arms - Fully configurable: offset, scale, billboard, background, opacity, rotation

🛠️ Admin Tools

- Clan list GUI — view and manage all clans - Teleport all clan members to you - Clear member inventories - Reload plugin config & languages at runtime

🌐 Multi-Language

- English, Russian, German, French, Spanish, Polish - Configurable via `config.yml`

---

Permissions

| Permission | Description | |---|---| | `clansfix.*` | All permissions | | `clansfix.admin` | Admin access | | `clansfix.create` | Create a clan | | `clansfix.join` | Join a clan | | `clansfix.leave` | Leave a clan | | `clansfix.invite` | Invite players | | `clansfix.kick` | Kick members | | `clansfix.house` | Manage clan house | | `clansfix.treasury` | Access treasury | | `clansfix.upgrade` | Upgrade clan | | `clansfix.rank` | Manage ranks | | `clansfix.reload` | Reload plugin |

---

Dependencies

- ProtocolLib 1.21.7 (API) - ProtocolLib — economy integration - ProtocolLib — placeholders (`%clan_name%`, `%clan_rank%`, etc.) - ProtocolLib — packet utilities

---

Commands

Basic commands:

| Command | Description | |---|---| | `/clan create <name>` | Create a clan | | `/clan join <clan>` | Join an open clan | | `/clan leave` | Leave your clan | | `/clan invite <player>` | Invite a player | | `/clan accept <clan>` | Accept invitation | | `/clan decline <clan>` | Decline invitation | | `/clan kick <player>` | Kick a member | | `/clan deposit <amount>` | Deposit to treasury | | `/clan house set/tp` | Manage clan home | | `/clan top` | View rankings | | `/clan info` | Clan info | | `/clan admin` | Admin panel | | `/clan reload` | Reload plugin |

Type `/clan help` in-game for the full list.

---