🏰 ClansFix — Ultimate Clan System for Minecraft
✨ A complete, feature-rich clan system for your Spigot/Paper 1.21+ server!
🔥 Core Features:
🎨 Customization
- 🏷️ Colored Clan Tags (use
&4 for red, &e for yellow, etc.)
- 🛡️ Coat of Arms — drag & drop any item as your clan emblem!
- 👕 Clan Armor — unique visual appearance for members
- 💬 Floating Holograms with clan names above players
📈 Clan Progression
- ⚔️ 5 Clan Levels — from 5 to 25 members
- 💰 Treasury System — deposits & withdrawals with tiered permissions
- 📊 Ranking System — formula:
(KDR × 100) + (Balance ÷ 100)
- 🏆 Top 3 highlighted in gold, silver, and bronze
🎮 Gameplay Features
- 🏠 Clan House — teleportation for all members
- ⚔️ PvP Toggle — enable/disable friendly fire
- 📜 Quest System — 18+ quest types for clan leveling
- 👥 5-Tier Rank System — from Novice to Elder with different permissions
🌍 Multi-Language Support
- 🇬🇧 6 Languages Included (EN, RU, DE, FR, ES, PL)
- 🎯 All text externalized to config files
🛠️ Integrations
- ✅ PlaceholderAPI — 40+ placeholders for stats display
- 💸 Vault — full economy support
- 🎭 ProtocolLib — required for holograms
🎯 Key Commands:
/clan create <name> # Create a clan perm: clansfix.create
/clan join <clan> # Join an open clan
/clan house set/tp # Set/teleport to clan house
/clan treasury # Treasury management
/clan top # Clan rankings
/clan coat # Edit coat of arms
/clan upgrade # Clan upgrades
📌 Short aliases available: /c, /cl, /clans
⚙️ Requirements:
- Java 21+
- Spigot/Paper 1.21+
- ProtocolLib (required)
- Vault (required)
- PlaceholderAPI (recommended)
📊 Rank System:
| Rank |
Color |
Key Permissions |
| Novice |
⚪ Gray |
House teleport, view members |
| Member |
⚪ White |
Access upgrades, view quests |
| Trusted |
🔵 Cyan |
Full storage access |
| Veteran |
🟡 Gold |
Treasury withdrawals |
| Elder |
🟣 Purple |
All permissions (except kicking other Elders) |
🚀 Quick Start:
- 📥 Install ProtocolLib and Vault
- 🎯 Place ClansFix.jar in
plugins folder
- 🔄 Restart your server
- ⚙️ Configure quests and language in
config.yml
- 🎮 Play and build powerful clans!
💡 Pro Tip: Use /clan reload to apply config changes without server restart!
👑 Build Your Legendary Clan Today!
Crafted with ❤️ for the Minecraft Community- Quests are required for leveling up
- Progress tracking for all quest types
- Visual quest menu with completion status
Coat of Arms (Drag & Drop)
- Customizable clan emblems using drag and drop
- Open the coat of arms menu with
/clan coat or from clan settings
- Drag any item into the slot to set it as your clan's emblem
- Visual representation of your clan in rankings and menus
- Only leaders and Elders can edit
Clan House System
- Set a clan house location at your current position
- Teleport to the clan house
- Only leaders and Elders can set/remove the house
- All members can teleport to the house
- Visual indicators in the management menu
Treasury Management
- Deposit and withdraw money from clan treasury
- Balance tracking
- Permission-based access:
- All members can deposit
- Only Veterans and above can withdraw
- Visual treasury menu with balance display
- Integration with Vault economy
Upgrade System
- Access upgrade menu to view clan level
- View available quests for next level
- Cost-based upgrades (configured per level)
- Visual upgrade menu showing current level and requirements
- Max level 5
Ranking System
The ranking system uses a composite score based on KDR and balance:
Formula: Score = (KDR × 100) + (Balance ÷ 100)
- KDR (Kill/Death Ratio) has higher weight (multiplied by 100)
- Balance also affects ranking (every 100$ adds 1 point)
- Rankings update automatically every 5 minutes
- Top clans are displayed with special colors:
- #1: Gold
- #2: Silver
- #3: Bronze
- Pagination support for large rankings
Clan Armor System
- Visual armor display for clan members
- Customizable armor sets per clan
- Only leaders can manage clan armor
- Armor is visible to all players
Hologram System
- Floating holograms above clan members showing clan name
- Toggle on/off in clan settings
- Colored clan names based on tag
- Automatic removal when leaving/deleting clan
PvP System
- Toggle PvP between clan members
- Can be enabled/disabled in clan settings
- Only leaders can change PvP settings
- Prevents friendly fire when disabled
Localization System
- Multi-language support with 6 languages:
- English (en) - Default
- Russian (ru)
- German (de)
- French (fr)
- Spanish (es)
- Polish (pl)
- All plugin texts are externalized to language files
- Easy to add new languages
- Language files located in
plugins/ClansFix/languages/
- Change language in
config.yml: language: en
PlaceholderAPI Integration
Full PlaceholderAPI support for all clan statistics:
Player Placeholders
%clans_player_clan% - Player's clan name%clans_player_tag% - Player's clan tag%clans_player_level% - Player's clan level%clans_player_kills% - Player's clan kills%clans_player_deaths% - Player's clan deaths%clans_player_kdr% - Player's clan KDR%clans_player_balance% - Player's clan balance%clans_player_members% - Total members in player's clan%clans_player_online% - Online members in player's clan%clans_player_rank% - Player's clan rank%clans_player_score% - Player's clan composite score
Top Clan Placeholders (1-10)
%clans_topX_name% - Clan name at position X%clans_topX_tag% - Clan tag at position X%clans_topX_balance% - Clan balance at position X%clans_topX_kdr% - Clan KDR at position X%clans_topX_kills% - Clan kills at position X%clans_topX_deaths% - Clan deaths at position X%clans_topX_level% - Clan level at position X%clans_topX_members% - Total members at position X%clans_topX_online% - Online members at position X%clans_topX_leader% - Leader name at position X%clans_topX_score% - Composite score at position X
Replace X with position number (1-10).
Author
TG:@fixsirt
Enjoy your advanced clan system!
