Clans | Guilds, Ranks & Alliances v1.0.0

Clans
Clans gives your server a full guild system. Players form a clan, climb a rank ladder, share a bank, set a home, and ally with other clans. Two in-game menus handle the day to day, and every part of it is set in one config file.

Built for: Survival, SMP, Factions, Skyblock.



Ranks and members
Every clan starts with a leader and a rank ladder below them. The default ladder is member, officer, and co-leader, and you can rename or extend it in the config. Each rank gets its own set of permissions such as invite, kick, promote, demote, sethome, deposit, withdraw, ally, and settag. Promote and demote move a member one step up or down the ladder, and the leader can hand off leadership with /clan setleader.


The roster menu lists every member as a head. Left-click promotes, shift-left-click demotes, right-click kicks, all checked against the rank permissions above before anything happens.

Shared bank
Clans can hold a shared balance through Vault. Members with the deposit or withdraw permission can put money in or take it out, with a minimum transaction size and an optional balance cap. If Vault or an economy plugin is not installed, the bank turns itself off and the commands say so, no errors.

Homes and alliances
Each clan can set one shared home. Teleporting has a short warmup and a per-player cooldown, both configurable, and the warmup cancels if the player moves or takes damage. Clans can also ally with up to five other clans, share an ally chat channel, and optionally turn off friendly fire between allies.

Chat channels
/clan chat switches a player into clan-only chat, and /clan chat ally switches to a shared channel with allied clans. Both formats are plain config strings, so you can restyle them without touching code.



Features

• Configurable rank ladder with per-rank permissions, and a leader who always outranks everyone.
• Shared clan bank through Vault: deposit, withdraw, balance, minimum transaction, optional cap.
• Shared clan home with warmup, cooldown, and move/damage cancel.
• Alliances with a configurable cap, ally chat, and an ally friendly-fire toggle.
• Clan chat and ally chat channels with configurable formats.
• Two in-game menus: a clan overview panel and a click-to-manage member roster.
• Invites and ally requests that expire on their own after a set time.
• Clan name and tag validation: length limits, a character pattern, and a blocked-word list.
• Optional Vault cost to create a clan.
• PlaceholderAPI support for a player's clan, tag, rank, member count, bank, and ally count.
• Feedback sounds for success, error, invites, and teleports, all configurable.
• Config auto-migration and safe periodic saves, with a final save on shutdown.

Commands

• /clan create <name> [tag] - found a clan.
• /clan disband - disband your clan (leader only).
• /clan info [name] - view a clan's roster, bank, and allies.
• /clan list [page] - list every clan on the server.
• /clan invite <player>, accept <clan>, deny <clan> - manage clan invites.
• /clan leave, kick <player> - leave or remove a member.
• /clan promote <player>, demote <player>, setleader <player> - manage the rank ladder.
• /clan sethome, delhome, home - manage and use the clan home.
• /clan bank [balance|deposit <amt>|withdraw <amt>] - use the shared bank.
• /clan ally <clan>, unally <clan>, allies - manage alliances.
• /clan tag <tag>, rename <name> - change your clan's tag or name.
• /clan chat [ally] - toggle clan or ally chat.
• /clan gui - open the clan menu (also opens on plain /clan if you are in a clan).
• /clan reload - reload the config (admin).
• /clan admin disband <clan>, admin info <clan> - admin tools.

Aliases: /clans, /guild, /c

Permissions

• clans.use - create and use a clan, all player-facing features. Default: everyone.
• clans.admin - reload and the admin subcommands. Default: operators.

Placeholders

• %clans_in_clan% - whether the player is in a clan.
• %clans_name%, %clans_tag%, %clans_rank% - the player's clan name, tag, and rank.
• %clans_members%, %clans_allies% - member count and ally count.
• %clans_bank% - the clan's bank balance, formatted by your economy plugin.

Requirements

• Minecraft 1.21 to 26.1.2.
• Paper, Spigot, or Bukkit.
• Java 21.
• Vault and an economy plugin are optional, for the shared bank and create cost.
• PlaceholderAPI is optional, for placeholders.

Installation

1. Drop Clans-1.0.0.jar into your plugins folder.
2. Start the server once to generate the config.
3. Edit config.yml to taste, then run /clan reload.

Try it first
Clans is live on our test server, hosted here on BuiltByBit. Use the test server link on this page to connect and try the commands and menus yourself.

Support
Questions and bug reports are welcome. Join the No Click Studios Discord at https://discord.gg/drBwA958bn.