Simple 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

- Hex Colored Clan Names: Players can create clans with unique names and prefixes. - Hex Colored Clan Names: - Invite, promote, demote, or kick members. - Transfer leadership to other members. - Hex Colored Clan Names: Communicate privately with your clan using `/cc` or `/clan chat`. - Hex Colored Clan Names: A virtual clan chest shared amongst clan members that can be upgraded (9–54 slots). - Hex Colored Clan Names: - Set a home location for your clan. - Teleport to the clan home anytime. - Hex Colored Clan Names: Set a clan banner to assert land dominance. - Hex Colored Clan Names: Leaders can enable or disable PvP among clan members (own and allied clans). - Hex Colored Clan Names: Declare enemies or form alliances with other clans. - Hex Colored Clan Names: Track clan KDR based on members’ kills and deaths. - Hex Colored Clan Names: Expand your clan’s player slots with upgrades. - Hex Colored Clan Names: - Send requests to join clans. - Accept or deny requests as a leader. - Toggle clan join status. - Hex Colored Clan Names: Requires Vault to manage clan creation costs and upgrades. - Hex Colored Clan Names: Display clan-related placeholders anywhere on your server. - Hex Colored Clan Names: Customize settings like clan creation costs, max members, and more. - Hex Colored Clan Names: 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

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

The clan leaderboard is calculated based on three factors:

- Clan KDR (Kills/Deaths) – 40% weight - Clan KDR (Kills/Deaths) – 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

0.82 - Alpha Score = (1.0 × 0.4) + (0.5 × 0.2) + (1.0 × 0.4) = 0.4 + 0.1 + 0.4 = 0.82 - 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 Offline Player Kicking, 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._