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 top ............... List ranking for all top clans.
/clan create <name> ..... Create a new clan with the specified name.
/clan join <name> ....... Request to join a clan.
/clan accept ............ Accept a clan invite.
/clan deny .............. Deny a clan invite.

Clan Members
/clan home .............. Teleport to the clan home.
/clan online ............ Show all online clan members.
/clan chest / /clan storage .. Open the clan chest.
/clan getbanner ......... Give the clan member the clan banner.
/clan deposit <amount> .. Deposit money to the clan’s bank balance.
/clan info .............. View information about the clan you’re in.
/clan leave ............. Leave your current clan.
/clan balance ........... View the clan’s total balance.
/clan chat <msg> / /cc <msg> ... Sends a message to private clan chat.

Clan Co-Leaders
/clan invite <player> ... Invite a player to your clan.
/clan kick <player> ..... Kick a player from your clan.
/clan withdraw <amount> . Withdraw money from the clan’s bank balance.
/clan raccept <player> .. Accept a player’s request to join.
/clan rdeny <player> .... Deny a player’s request to join.
/clan requests ......... View pending join requests.
/clan upgrade .......... Upgrade the clan player slot.

Clan Leaders
/clan promote <player> . Promote a clan member.
/clan demote <player> .. Demote a clan member.
/clan pvp ............... Toggle PvP between clan members.
/clan transfer <player> Transfer leadership to another player.
/clan togglejoin ....... Toggle whether the clan accepts join requests.
/clan sethome .......... Set the clan’s home location.
/clan change <prefix> .. Change the clan’s prefix (color coded).
/clan setbanner ........ Set the clan banner (must be holding one).
/clan upgradestorage .. Upgrade the clan storage slots.
/clan war / /clan enemy .... Declare a clan as enemy.
/clan ally ............. Declare a clan as ally.
/clan unenemy .......... Remove enemy status from a clan.
/clan unally ........... Remove ally status from a clan.

Server Admins
/clan reload ........... Reload the plugin configuration.
/clan delete ........... Delete the clan and its relevant data.
/clan updater .......... Check online for plugin updates.
/clan updateconf ....... Update the config from an old version.



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:

Clan	Members	Bank Balance	KDR
Alpha	10	$5,000	2.0
Beta	8	$10,000	1.5

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.9
- Beta Score = (0.8 × 0.4) + (1.0 × 0.2) + (0.75 × 0.4) = 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.