• Creation with tag and optional modtag
• Invitations with async expiration
• Accept, deny and cancel
• Voluntary leave (leader protected)
• Hierarchical kick by rank
• Disband with safe confirmation
• Public join — Open clans via /clan join <clan>

• Multiple homes per clan (limit scalable by level)
• Configurable warmup with real-time cancellation (ignores camera rotations)
• Cooldown with bypass permission (zmclans.clan.bypass.cooldown)
• Shared visibility with allies based on settings
• Dedicated GUI + direct commands

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

Native Adventure MiniMessage support:

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

Legacy hex support:

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

Guaranteed safety — Blocks click, hover and command injections. Only allows visual styles.

• Reciprocal requests with configurable expiration
• Per-level ally/rival limits
• Interactions between allies:
  • Share homes
  • Ally chat
  • Configurable ally PvP
• Friendly Fire for members:
  • Blocks melee damage
  • Blocks projectiles (arrows, tridents, etc.)
• Toggleable via /clan ff or GUI

• Integrated with Paper's modern API (AsyncChatEvent) — no deprecations
• Toggle mode (/clan chat) or direct send (/clan chat <msg>)
• Configurable format with tag, rank and prefix

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

Configurable points for:

• Clan creation
• Member join
• Kills / Deaths
• Rank changes

Customizable formula:

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

Paginated leaderboard with filters:

• Members
• Points
• Kills
• Deaths
• KDR

Each event has independent control over:

• Title / Subtitle (with fade-in/out)
• ActionBar
• Sound (volume and pitch)

Included events:

Data-driven architecture — zero Java code needed to customize.

Supported actions:

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

• HikariCP for efficient pooling
• Periodic async saving
• Single writer to preserve operation order
• Additive migrations (no data loss)
• Final save before shutdown

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

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

All calls must be executed on the main thread.

• USE_HOME — Use /clan home
• USE_CHAT — Clan chat
• INVITE — Invite players
• KICK — Kick lower-ranked members
• PROMOTE — Change ranks of lower members
• SET_HOME — Modify clan home
• EDIT_DESCRIPTION — Edit description
• EDIT_SETTINGS — Manage settings (alliances, shared homes, FF...)
• TRANSFER_LEADER — Transfer leadership
• DISBAND — Disband clan
• MODTAG — Modify tag with colors

Identification

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

Tags

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

Members

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

Ranking (Top)

%zmclans_points% · %zmclans_top% · %zmclans_top:<N>% · %zmclans_top_points:<N>% · %zmclans_top_kdr:<N>%

States

%zmclans_is_ff% · %zmclans_isopen% · %zmclans_chat_active%

Home and Dates

%zmclans_hashome% · %zmclans_home% · %zmclans_creation_date%

Player Statistics

%zmclans_player_role% · %zmclans_player_kills% · %zmclans_player_kdr%

Relational

%rel_zmclans_relation_relboolean_member% · %rel_zmclans_relation_relcolor% · %rel_zmclans_relation_reltype%