Clans

Clans

Unite. Dominate. Conquer.

The Clans Plugin is the ultimate tool for fostering teamwork and competition on your Minecraft server. With a rich set of features, players can create, manage, and grow their clans while competing for dominance. Whether you're building a community or running a competitive server, this plugin is designed to enhance the multiplayer experience.

Required

• Vault – economy & permissions API
• Any Economy Plugin – needed for Vault to handle money

Optional

• PlaceholderAPI (PAPI) – adds placeholders support
• Fcore – extra features integration

• Clan Creation: Players can create clans with unique names and prefixes.
• Clan Management:
  • Invite, promote, demote, or kick members.
  • Transfer leadership to other members.
• Clan Chat: Communicate privately with your clan using /cc or /clan chat.
• Clan Chest: A virtual clan chest shared amongst clan members that can be upgraded (9–54 slots).
• Clan Home:
  • Set a home location for your clan.
  • Teleport to the clan home anytime.
• Clan Banner: Set a clan banner to assert land dominance.
• PvP Management: Leaders can enable or disable PvP among clan members (own and allied clans).
• Clan Enemies/Allies: Declare enemies or form alliances with other clans.
• Clan KDR: Track clan KDR based on members’ kills and deaths.
• Clan Upgrades: Expand your clan’s player slots with upgrades.
• Join Requests:
  • Send requests to join clans.
  • Accept or deny requests as a leader.
  • Toggle clan join status.
• Economy Integration: Requires Vault to manage clan creation costs and upgrades.
• PlaceholderAPI Support: Display clan-related placeholders anywhere on your server.
• Highly Configurable: Customize settings like clan creation costs, max members, and more.
• Multi-Language Support: Supports up to 6 languages: en, fr, dt, ru, tr, cn.
• Hex Colored Clan Names: Clan names support custom 6-digit hex color codes (e.g., #178ad6).

These placeholders are available when using PlaceholderAPI:

• %clans_name% → Shows the player's clan name.
• %clans_name_cm% → Shows the player's clan name (for ChatManager only).
• %clans_name_plain% → Shows the player's clan name stripped from color codes.
• %clans_badge% → Shows the player's clan badge.
• %clans_list_<#>_name% → Shows the name of the clan at that position in the leaderboard.
• %clans_list_<#>_leader% → Shows the leader of the clan at that position.
• %clans_list_<#>_balance% → Shows the balance of the clan at that position.
• %clans_list_<#>_kdr% → Shows the KDR of the clan at that position.

Note: Replace <#> with the rank number in the leaderboard (e.g., %clans_list_1_name% for the top clan).

• clans.admin
  • Allows Non-Op players to use the plugins op commands.

Anyone

Clan Members

Clan Co-Leaders

Clan Leaders

Server Admins

The clan leaderboard is calculated based on three factors:

• Number of Members – 40% weight
• Bank Balance – 20% weight
• Clan KDR (Kills/Deaths) – 40% weight

Example Calculation

Suppose we have two clans:

Step 1: Normalize each factor

• Members: Alpha 10 / Max 10 → 1.0, Beta 8 / 10 → 0.8
• Bank: Alpha 5,000 / Max 10,000 → 0.5, Beta 10,000 / 10,000 → 1.0
• KDR: Alpha 2.0 / Max 2.0 → 1.0, Beta 1.5 / 2.0 → 0.75

Step 2: Apply weights

• Alpha Score = (1.0 × 0.4) + (0.5 × 0.2) + (1.0 × 0.4) = 0.4 + 0.1 + 0.4 = 0.9
• Beta Score = (0.8 × 0.4) + (1.0 × 0.2) + (0.75 × 0.4) = 0.32 + 0.2 + 0.3 = 0.82

Step 3: Rank

• 1️⃣ Alpha (0.9)
• 2️⃣ Beta (0.82)

This shows that even though Beta has more money, Alpha ranks higher because of more members and a higher KDR.

Creating a clan requires by default 50,000 money. A clan can not be disbanded only transferred to a clan member only, clan ranking is based on most members, by default max member limit is 50, it can be upgraded by 1 player slot for 10,000 Money, these figures are editable in config.yml. Same goes for clan chests but they're upgrade able by 9 slots at a time, and can be disabled in config.yml as well.

In the config.yml file, you can define a list of words that should be prohibited as clan's prefix. This also applied to clan renaming.

The plugin now supports six languages that can be modified in the config.yml file, once the language has been changes the command /clan reload must be used for the new selected language to be active.

Supported Languages

• English (en) [Default]
• French (fr)
• Dutch (de)
• Chinese (cn)
• Russian (ru)
• Turkish (tr)

The plugin functions fully without Fcore, with one exception: Offline Player Kicking requires Fcore, as it is responsible for tracking offline player stats.

The plugin stats can be found on Bstats

Your review about the plugin will be appreciated and will help us improve it in future.