How do I install zMClans | Custom Clan System [1.20+ - 26.3+ ]?

Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. Download the .jar. Put it in the .minecraft/mods folder and launch that loader profile. Opens on Spigot — not every file is mirrored on our own servers.

What Minecraft version does zMClans | Custom Clan System [1.20+ - 26.3+ ] work with?

The listing gives Minecraft 1.20, 1.20.6, 1.21, among others. This is the version stated by the author or source site, not something we verified ourselves.

Home›Java›Mods›zMClans | Custom Clan System [1.20+ - 26.3+ ]

ModsJava

zMClans | Custom Clan System [1.20+ - 26.3+ ]

Java mod listed for Minecraft 1.20–26.x. Downloads from the MC Java Mods app on Android.

zMClans Advanced Clan System for Spigot, Paper, Purpur & Pufferfish A modern clan experience, built for performance. No unnecessary dependencies. No…

⬇ Download on Spigot

Open in MC Java Mods Get it on Google Play →

zMClans
Advanced Clan System for Spigot, Paper, Purpur & Pufferfish
A modern clan experience, built for performance.
[IMG]

No unnecessary dependencies. No hardcoded GUIs. No compromises.
A lightweight, fully customizable clan system featuring advanced progression, alliances, rivalries, private chat, named homes and a developer-friendly API.
JOIN OUR DISCORD

WHY zMCLANS?
✔ BUILT FOR PERFORMANCE

Asynchronous database operations and periodic saving.
HikariCP connection pooling for SQLite and MySQL.
Ordered writes to help preserve data consistency.
Safe shutdown saving and additive database migrations.

✔ BUILT FOR CUSTOMIZATION

Fully configurable YAML GUIs inspired by the simplicity of menu-based plugins.
Custom ranks, priorities and permissions.
Gradient and hexadecimal modtags with MiniMessage support.
Configurable progression, level limits, notifications and economy.
Multiple language and interface customization options.

✔ BUILT FOR DEVELOPERS

Public Java API and Bukkit events.
PlaceholderAPI integration.
Modern Paper chat integration.
Optional Vault economy support.

✘ WITHOUT THE UNNECESSARY COMPLEXITY

No mandatory Vault or PlaceholderAPI installation.
No need to modify Java code to customize supported GUI elements.
No deprecated chat event integration.
No unrestricted click, hover or command injection through formatted modtags.

FEATURES

Spoiler: Clan Management

Create clans with a name, tag and optional formatted modtag.
Send invitations with configurable asynchronous expiration.
Accept, deny and cancel invitations.
Leave clans voluntarily, with leadership protection.
Kick members according to rank hierarchy.
Disband clans with safe confirmation.
Allow public clans to be joined using /clan join <clan>.
Manage members through interactive GUIs.

Spoiler: Named Homes & Teleportation

Multiple named homes per clan.
Home limits configurable by clan level.
Configurable teleport warmup and cooldown.
Cancel teleportation when the player moves, without cancelling for camera rotation.
Cooldown bypass permission: zmclans.clan.bypass.cooldown.
Optional home sharing with allies.
Dedicated GUI and direct commands.

Code (Text):

home:
max-homes: 3
teleport-cooldown: 30
teleport-warmup: 5
cancel-on-move: true

Spoiler: Gradient & Hex ModTags

Use modern Adventure MiniMessage formatting or legacy hexadecimal color sequences.
MiniMessage example

Code (Text):

<bold><gradient:#9A23FF:#7C09DE:#9A23FF>ZEPHY</gradient></bold>

Legacy hex example

Code (Text):

&#9A23FF&lZ&#8B16EF&lE&#7C09DE&lP&#8B16EF&lH&#9A23FF&lY

Formatting safety
Formatted modtags are designed to support visual styling while blocking click, hover and command injection.

Click to expand...

Spoiler: Alliances, Rivalries & Friendly Fire

Reciprocal alliance and rivalry requests.
Configurable request expiration.
Alliance and rivalry limits based on clan level.
Share homes with allies when enabled.
Communicate through ally chat.
Configure PvP interactions between allies.
Toggle friendly fire using /clan ff or the GUI.
Friendly fire protection covers melee attacks and projectiles, including arrows and tridents.

Spoiler: Private Clan Chat

Integrated with Paper's modern AsyncChatEvent API.
Toggle chat mode with /clan chat.
Send a single message with /clan chat <message>.
Configure the tag, rank prefix, player name and message format.

Example format

Code (Text):

format: "{tag} &7| {rank_prefix}{player} &8» &f{message}"

Spoiler: Points, Levels & Leaderboards

Award configurable points for clan creation, member joins, kills, deaths and rank changes.
Example progression configuration

Code (Text):

progression:
base-points: 100
exponent: 1.5
start-level: 1
max-level: 50
level-limits:
1:
members: 10
homes: 1
allies: 2
rivals: 3
10:
members: 30
homes: 5
allies: 8
rivals: 10

Leaderboard filters

Members
Points
Kills
Deaths
Kill/Death Ratio (KDR)

Paginated ranking interface with configurable progression and level-based limits.

Spoiler: Notification System

Configure notifications independently for each supported event.
Available notification channels

Title and subtitle, including fade-in and fade-out.
ActionBar messages.
Sounds with configurable volume and pitch.

Included event groups

Progression: clan-points-earned, clan-levelup, clan-create, clan-disband
Members: member-promote, member-demote, member-kick, member-join, member-leave, member-joined, member-left, member-kicked, transfer-leader
Invitations: invite-sent, invite-received, invite-accepted
Homes & alliances: home-teleport, home-set, ally-accepted

Spoiler: Fully Configurable YAML GUIs

Customize supported menus without modifying Java source code.
GUI files

general.yml - Main menu and entry interface.
members.yml - Paginated member list.
member_manage.yml - Individual member management.
clanlist.yml - Clan browser and ranking.
invite.yml - Player invitation menu.
invites.yml - Received invitations.
settings.yml - Clan settings.
clan_info.yml - Clan information and statistics.
homes.yml - Home management.
confirm.yml - Confirmation menus.

Supported actions

Code (Text):

CLOSE
CANCEL
PAGE_NEXT
PAGE_PREV
OPEN_GUI:<name>
CREATE_CLAN
SHOW_HELP
TOGGLE_CHAT
CLAN_HOME_OR_SETHOME
TOGGLE_SETTING:<key>
MEMBER_PROMOTE
MEMBER_DEMOTE
MEMBER_KICK
MEMBER_TRANSFER_LEADER
CMD_PLAYER:<cmd>
CMD_CONSOLE:<cmd>

Spoiler: SQLite & MySQL Storage

SQLite and MySQL support.
HikariCP connection pooling.
Periodic asynchronous saving.
Single-writer execution to preserve operation order.
Additive database migrations.
Final save during plugin shutdown.

Example configuration

Code (Text):

storage:
type: "MYSQL" # or SQLITE
auto-save-interval: 5
mysql:
host: "localhost"
port: 3306
database: "zmclans"
pool-size: 10
useSSL: false

Spoiler: Public API & Bukkit Events

Access the plugin through its public Java API.

Code (Text):

Plugin candidate = Bukkit.getPluginManager()
.getPlugin("zMClans");
if (candidate instanceof zMClans clans
&& clans.isEnabled()) {
ZMClansAPI api = clans.getAPI();
api.getClanByPlayer(player.getUniqueId())
.ifPresent(clan -> player.sendMessage(
clan.name()
+ " | level " + clan.level()
+ " | KDR " + clan.kdr()
));
}

Available events

ClanCreatedEvent
ClanMemberJoinEvent
ClanMemberLeaveEvent
ClanPointsChangeEvent
ClanLevelChangeEvent

API calls must be executed on the main server thread.

Click to expand...

COMMANDS
PLAYER COMMANDS
Aliases: /clan, /c, /clans

Spoiler: Complete Player Command List

/clan - Opens the main interactive menu.
/clan create <name> [tag] - Creates a clan.
/clan info [clan] - Displays clan information.
/clan list - Opens the leaderboard.
/clan invite <player> - Invites a player.
/clan invites - Opens received invitations.
/clan accept [clan] - Accepts an invitation.
/clan deny [clan] - Denies an invitation.
/clan join <clan> - Joins a public clan.
/clan members - Opens the members GUI.
/clan setrank <player> <rank> - Changes a member's rank.
/clan kick <player> - Removes a member.
/clan leave - Leaves the clan.
/clan disband [confirm] - Disbands the clan.
/clan home [name] - Opens homes or teleports.
/clan homes - Opens home management.
/clan sethome [name] - Creates or updates a home.
/clan delhome <name> - Deletes a home.
/clan chat [message] - Uses clan chat.
/clan ff - Toggles friendly fire.
/clan desc <text> - Changes the clan description.
/clan modtag <tag> - Changes the formatted modtag.
/clan settings - Opens clan settings.
/clan ally add|accept|deny|cancel|remove <clan> - Manages alliances.
/clan rival add|remove <clan> - Manages rivalries.
/clan relation remove <clan> - Removes a relationship.
/clan stats - Displays consolidated statistics.
/clan help - Displays help.

ADMINISTRATOR COMMANDS
Aliases: /zmclan, /zmclans, /clanadmin

/zmclan help - List admin commands. (zmclans.admin.help)
/zmclan reload - Reload configuration. (zmclans.admin.reload)
/zmclan list [page] - List clans. (zmclans.admin.list)
/zmclan members <clan> - View members. (zmclans.admin.members)
/zmclan info <clan> - View clan details. (zmclans.admin.info)
/zmclan disband <clan> - Disband a clan administratively. (zmclans.admin.disband)
/zmclan setleader <clan> <player> - Transfer leadership. (zmclans.admin.setleader)
/zmclan points <add|set|remove> <clan> <n> - Adjust clan points. (zmclans.admin.points)

PERMISSIONS & RANKS
Special permissions

zmclans.clan.bypass.cooldown - Bypass home teleport cooldown.
zmclans.clan.bypass.cost - Bypass clan creation cost.

All zmclan.player.* permission nodes are denied by default. Grant individual permissions or use zmclan.player as the parent node.

Click to expand...

Default ranks (ranks.yml)

member (Priority 1) - USE_HOME, USE_CHAT
officer (Priority 2) - Member permissions + INVITE
admin (Priority 3) - + KICK, PROMOTE, SET_HOME, EDIT_DESCRIPTION, MODTAG
leader (Priority 4) - All permissions; protected using is-leader: true

Spoiler: Complete Rank Permission List

USE_HOME - Use /clan home.
USE_CHAT - Access clan chat.
INVITE - Invite players.
KICK - Kick lower-ranked members.
PROMOTE - Change ranks of lower-ranked members.
SET_HOME - Modify clan homes.
EDIT_DESCRIPTION - Edit the clan description.
EDIT_SETTINGS - Manage clan settings, alliances, shared homes and friendly fire.
TRANSFER_LEADER - Transfer leadership.
DISBAND - Disband the clan.
MODTAG - Modify formatted modtags.

PLACEHOLDERS
Requires PlaceholderAPI. Placeholder availability may depend on context.

Spoiler: Complete Placeholder List

Identification

Code (Text):

%zmclans_hasclan%
%zmclans_hasclan_formated%
%zmclans_hasclan_formated_nocolor%
%zmclans_clan%
%zmclans_name%
%zmclans_clanid%

Tags

Code (Text):

%zmclans_modtag%
%zmclans_tag%
%zmclans_tag_formated%
%zmclans_tag_nocolor%

Members

Code (Text):

%zmclans_leader%
%zmclans_is_leader%
%zmclans_members%
%zmclans_onlinemembers%
%zmclans_slots%

Code (Text):

%zmclans_top_points_1_name%
%zmclans_top_points_1_tag%
%zmclans_top_points_1_value%
%zmclans_top_kills_3_name%
%zmclans_top_kdr_1_value%
%zmclans_top_members_2_value%

States

Code (Text):

%zmclans_is_ff%
%zmclans_isopen%
%zmclans_chat_active%

Homes & Dates

Code (Text):

%zmclans_hashome%
%zmclans_home%
%zmclans_creation_date%

Player Statistics

Code (Text):

%zmclans_player_role%
%zmclans_player_kills%
%zmclans_player_kdr%

Relational Placeholders

Code (Text):

%rel_zmclans_relation_relboolean_member%
%rel_zmclans_relation_relcolor%
%rel_zmclans_relation_reltype%

INSTALLATION

Download zMClans-1.0.0.jar.
Place the JAR file in your server's plugins directory.
Restart the server.
Configure config.yml, ranks.yml, the guis/ directory and language files.
Apply configuration changes using /zmclan reload.

Requirements

Server: Paper or Purpur 1.20+
Java: 21+
Vault: Optional; economy integration.
PlaceholderAPI: Optional; placeholder integration.

Clan creation economy

VAULT - Vault and a compatible economy provider.
CUSTOM - PlaceholderAPI balance placeholder and a withdrawal command.
NONE - No creation charge.

Code (Text):

economy:
enabled: true
mode: "VAULT"
allow-cost-bypass: true

When the required economy integration is unavailable, the balance is insufficient or withdrawal fails, clan creation is rejected. A clan must not be created without successful payment.

Click to expand...

COMPATIBILITY & NOTES

The leader cannot leave their clan without transferring leadership or disbanding it.
Additive database migrations are designed to preserve existing data.
Reducing configured limits does not delete existing data; it prevents additions beyond the new limits.
/clan stats retains compatibility with the consolidated clan information view.
Automatic update checks require a valid resource ID.

SUPPORT & COMMUNITY
Need help, found a bug or have a suggestion? Get in touch.

Built for servers that take their clans seriously.
zMClans 1.0.0 | Paper / Purpur 1.20+ | Java 21+

STATISTICS
zMClans collects anonymous usage metrics through bStats. View live server and player counts below.

[IMG]

Signature chart rendered by bStats. Metrics can be disabled at any time in plugins/bStats/config.yml.

Commands

/clan — Main clan command
/clan [subcommand]
/zmclan — Admin clan command
/zmclan [subcommand]

Plugin details

Built for Minecraft 1.20+
Plugin version 1.1.0
Author zMarkitos_
Works with Vault, PlaceholderAPI

Read from the plugin's own plugin.yml.

Quick facts

Edition: Minecraft Java
File type: .jar
Minecraft versions listed: 1.20, 1.20.6, 1.21
How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
Where to get it: Opens on Spigot — not every file is mirrored on our own servers.

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

zMClans | Custom Clan System [1.20+ - 26.3+ ] is a free Minecraft Java mod. Compatible with Minecraft 1.20, 1.20.6, 1.21, 26.1 and newer. Downloaded 36 times (via Spigot). Download it and open it directly in the game.

Explore more

All Mods for Java All Minecraft Java mods Java mods for 1.20 Java mods for 1.21 Java mods for 26