🏰 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!

ClansFix