Set up Clans on your Minecraft server

Clans is a small clan plugin by Phloxz. Players create a clan with a name, invite friends, set a clan base to teleport to, and earn a clan colour from kills. It runs only on the server, so players install nothing.

Checked against Clans 0.4.5, the version listed on SpigotMC for Minecraft 1.7 to 1.16, October 2026.

What you need

• A Paper or Purpur server, which shows a Plugins tab under Content in the panel menu.
• Nothing else. The plugin supports Vault and PlaceholderAPI but does not need them. Clans stores its data in files only, and the plugin's page says it has no MySQL support.

Clans is published on SpigotMC, which the Plugins tab does not search, so you add the jar by hand.

Install Clans

1. Create a backup in the Backups tab.
2. Download the .jar from the plugin's SpigotMC page on your computer.
3. Open File Manager, go into the plugins folder and click Upload. Pick the jar.
4. Open Console and click Restart. Plugins load only at startup.
5. Watch the Console while it starts and look for errors that name Clans.

Settings

Clans keeps its settings in plugins/Clans/Settings/config.yml and its messages in a messages.yml beside it. Open the file in File Manager, change a value, click Save, then run /clan reload in game. The options that matter most:

• ClanNameLength caps how long a clan name can be, and ClanNameMatcher limits which characters it may use. The default allows letters and numbers only.
• ClanLimitEnabled and ClanLimit cap a clan's size. An invite fails once the limit is reached.
• BaseTeleportEnabled, BaseTeleportCooldown and SetBaseEnabled control the clan base.
• PermissionEnabled switches the permission checks on or off.
• ChatFormatEnabled, CustomChatFormatEnabled and ChatFormat are the chat settings. ChatFormat defaults to %clan% &8* %player%&7: &f%message%.
• VaultSupport.Enabled and VaultSupport.ClanCreatePrice charge money to create a clan, which needs Vault.

Clan colours depend on kills, through the ClanColors list. The plugin's page gives this default: grey from 0 to 99 kills, green from 100 to 299, and red at 500 or more.

Commands and permissions

Every command starts with /clan and has its own permission:

• /clan create [name], permission clans.create.
• /clan invite [player] and /clan accept [player], permissions clans.invite and clans.accept. The player to name when accepting is the one who invited you.
• /clan kick [player], /clan leave and /clan delete.
• /clan list lists the clan's members, and /clan stats [name] shows a clan's stats. /clan stats on its own shows the global top 10, with permission clans.topstats.
• /clan base teleports to the clan base, and /clan setbase sets it.
• /clan reload, permission clans.reload.

Each permission follows the pattern clans.<command>. /clan is for players, and the plugin refuses it from the console.

Common problems

• A clan name is refused. It is too long, uses characters ClanNameMatcher does not allow, or is on BlacklistedClanNames.
• An invite fails. The target player is offline, is already in a clan, or the clan reached its limit.
• Base teleport waits. The plugin tells the player not to move until a short delay has passed. The base settings in config.yml control it.