ClansFix

Advanced clan management plugin for Paper 1.21.7

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

• Paper 1.21.7 (API)
• Vault — economy integration
• PlaceholderAPI — 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.

---