!Main Banner

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.

!Dependencies Required

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

Optional

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

!Features

• 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).

!Placeholders 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).

!Permissions

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

!Commamds

Anyone

Command	Description
/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

Command	Description
/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 <message> / /cc <message>	Sends a message to private clan chat.

Clan Co-Leaders

Command	Description
/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 the clan.
/clan rdeny <player>	Deny a player’s request to join the clan.
/clan requests	View pending join requests.
/clan upgrade	Upgrade the clan player slot.

Clan Leaders

Command	Description
/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 clan leadership to another player.
/clan togglejoin	Toggle whether the clan accepts join requests.
/clan sethome	Set the clan’s home location.
/clan change <new_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

Command	Description
/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 older version to the latest version.

!Leaderboards 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.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.

!Functionality 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.

!Languages 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)

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

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