Clan plugin for Paper SMP

What is InfiniteClans?

InfiniteClans is a plugin built for SMP servers that lets your players create clans. They manage their roles and their members' permissions through a clean GUI menu — and every part of it is fully customizable.

Looking for a fully customizable plugin with just the essential, simple commands for your players? You've come to the right place.

Paper 1.19 – 1.26.x Java 17+ Storage SQLite / YAML PlaceholderAPI 70+ values
// Highlights

Everything a clan system needs

Ranks, levels, homes, alliances and live stats — wired together and controlled from one menu.

Storage

Save everything to SQLite or a flat-file (YAML) backend — switch with a single config line.

Languages

Ships with English and French, and is fully translatable — every message lives in editable lang files.

Support

Fast, friendly help on Discord. Questions, setup, custom tweaks — we answer.

GUI driven

Players run the whole clan — invites, ranks, homes, relations — from an intuitive in-game menu.

Stats & Top

Clan K/D, kills, deaths and a full leaderboard system — stats that follow each player across clans.

Performance

Highly optimized: async-safe stat handling, derived totals, and batched saves keep your TPS happy.

// Commands

Simple by design

Two entry points: a menu for players, an admin command for staff. Everything else is a subcommand.

Core commands
/clanOpen the clan GUI menu (also /c, /clans). infiniteclan.use
/clan helpShow the full command list. infiniteclan.use
/clan create <name>Found a new clan. infiniteclan.create
/clanadminAdmin & operator commands (also /ca, /ica). infiniteclan.admin
Player subcommands /clan <…>
create <name> disband confirm invite <player> accept <clan> deny <clan> leave kick <player> promote <player> demote <player> setrank <player> <rank> transfer <player> confirm info [clan] list top ally <clan> enemy <clan> neutral <clan> sethome [name] home [name] delhome <name> chat [message] setdesc <text> settag <tag> ff [on|off] gui
Admin subcommands /clanadmin <…>
reload delete <clan> setlevel <clan> <n> setpoints <clan> <n> addpoints <clan> <n> forcejoin <clan> <player> forcekick <player> forceremove <player> info <clan> logs clanban <name> unclanban <name>
// Permissions

Two layers of control

Server permissions decide who can use the plugin. In-clan role permissions decide what each rank can do.

Server permissions plugin.yml
infiniteclan.useeveryoneUse the basic clan commands (info, list, top, join, chat, home…). Without it the player can't use the plugin.
infiniteclan.createeveryoneAllows creating a clan with /clan create. Remove it to restrict who can found clans.
infiniteclan.adminopFull access to every /clanadmin command (reload, delete, setlevel, forcejoin, clanban…) and all bypasses.
infiniteclan.admin.logsopReceive in-game admin log notifications (clan creation, disband, important actions).
infiniteclan.limit.bypassopBypass the clan creation cooldown and the clan name limits. Handy for staff.
everyone = granted to all players by default · op = granted to server operators only.
Clan role permissions 15 · per rank
INVITEInvite a player to the clan (/clan invite).
KICKKick a member from the clan (command or members menu).
PROMOTEPromote a member to a higher rank (/clan promote).
DEMOTEDemote a member to a lower rank (/clan demote).
SET_HOMECreate or set a clan home (/clan sethome).
DEL_HOMEDelete a clan home (/clan delhome).
USE_HOMETeleport to a clan home (/clan home).
MANAGE_ALLIESDeclare allies, accept ally requests and return to neutral.
MANAGE_ENEMIESDeclare enemies and return to neutral.
SET_DESCRIPTIONEdit the clan description (/clan setdesc).
SET_TAGEdit the clan tag (/clan settag).
TOGGLE_FRIENDLY_FIRETurn the clan's friendly fire on or off (/clan ff).
RANKUPLevel the clan up by spending points and items (Upgrade button).
MANAGE_RANKSChange a member's rank (/clan setrank) and open the roles editor to toggle each rank's permissions.
DISBANDDisband the clan (/clan disband confirm).
Assigned per rank in config.yml ("*" grants all). Each clan can override its own ranks in the in-game roles menu. Leaving is open to any member; transferring ownership is owner-only.
// PlaceholderAPI

70+ placeholders

Use them in scoreboards, tab lists, chat and any PAPI-compatible plugin. Click any placeholder to copy it.

Clan identity 12
%infiniteclan_name%Clan name.
%infiniteclan_tag%Clan tag, raw as stored.
%infiniteclan_tag_color%Tag with color codes applied.
%infiniteclan_tag_nocolor%Tag stripped of colors. alias: tag_raw
%infiniteclan_desc%Clan description. alias: description
%infiniteclan_desc_nocolor%Description without colors.
%infiniteclan_clanid%Clan unique id (UUID). alias: id
%infiniteclan_leader%Clan owner's name. alias: owner
%infiniteclan_creation_date%Formatted creation date.
%infiniteclan_creation_timestamp%Creation time in milliseconds.
%infiniteclan_hasclan%true/false — player is in a clan. aliases: in_clan, has_clan
%infiniteclan_count_clans%Total number of clans on the server.
Level & points 7
%infiniteclan_level%Current clan level.
%infiniteclan_next_level%Next level, or MAX.
%infiniteclan_max_level%true/false — clan is at max level. alias: is_max_level
%infiniteclan_max_level_value%Highest possible level.
%infiniteclan_points%Current clan points.
%infiniteclan_points_to_next%Points still needed for the next level.
%infiniteclan_next_level_cost%Point cost of the next level (0 if max).
Members & slots 7
%infiniteclan_members%Member count. alias: count_members
%infiniteclan_maxmembers%Member capacity at the current level. aliases: max_members, slots
%infiniteclan_slots_used%Used slots (= member count).
%infiniteclan_slots_free%Remaining free slots.
%infiniteclan_online_members%Members currently online. alias: count_onlinemembers
%infiniteclan_members_list%Comma-separated member names. alias: member_names
%infiniteclan_member_<n>%Name of the n-th member (1 = first).
Combat 3
%infiniteclan_kdr%Clan K/D (sum of current members).
%infiniteclan_kills%Clan total kills. alias: clan_kills
%infiniteclan_deaths%Clan total deaths. alias: clan_deaths
Homes 4
%infiniteclan_homes%Number of clan homes.
%infiniteclan_maxhomes%Allowed homes at the current level. aliases: max_homes, limit_home
%infiniteclan_home_names%Comma-separated home names.
%infiniteclan_home:<name>:<field>%Home info; field = world, x, y, z, coords.
Relations 9
%infiniteclan_allies%Ally count. alias: count_ally
%infiniteclan_enemies%Enemy count. alias: count_rival
%infiniteclan_maxallies%Max allies at the current level. aliases: max_allies, limit_ally
%infiniteclan_maxenemies%Max enemies at the current level. aliases: max_enemies, limit_rival
%infiniteclan_ally_names%Names of allied clans. alias: ally_list
%infiniteclan_enemy_names%Names of enemy clans. aliases: rival_names, enemy_list
%infiniteclan_relation_<clan>%Relation label toward the named clan.
%infiniteclan_relation_colored_<clan>%Relation label, color-prefixed.
%infiniteclan_relation_color_<clan>%Just the relation color code.
Friendly fire 2
%infiniteclan_ff%Clan friendly fire state: ON / OFF. aliases: friendlyfire, friendly_fire
%infiniteclan_ff_raw%Raw state: true / false. alias: is_ff
Colors 2
%infiniteclan_color%Own-clan color code, ready to use. alias: relcolor
%infiniteclan_colored_name%Clan name prefixed with the own-clan color.
Player 9
%infiniteclan_player_name%Player name. alias: player
%infiniteclan_rank%Player rank, formatted/colored. alias: player_role_formated
%infiniteclan_rank_id%Rank id. alias: player_role_name
%infiniteclan_rank_weight%Rank weight (priority).
%infiniteclan_player_kills%Player's personal kills (follows them across clans).
%infiniteclan_player_deaths%Player's personal deaths.
%infiniteclan_player_kdr%Player's personal K/D.
%infiniteclan_player_joindate%When the player joined the clan (formatted).
%infiniteclan_player_jointimestamp%Join time in milliseconds.
Leaderboards / Top 13
<n> is the rank (1, 2, 3…). Add _name for the clan name, omit it for the value. Metrics: kdr, kills, deaths, points, level, members.
%infiniteclan_top_name_<n>%Name of the n-th clan in the K/D ranking.
%infiniteclan_top_kdr_<n>%K/D of the n-th clan (ranked by K/D).
%infiniteclan_top_kdr_name_<n>%Name of the n-th clan (ranked by K/D).
%infiniteclan_top_kills_<n>%Kills of the n-th clan (ranked by kills).
%infiniteclan_top_kills_name_<n>%Name (ranked by kills).
%infiniteclan_top_deaths_<n>%Deaths of the n-th clan (ranked by deaths).
%infiniteclan_top_deaths_name_<n>%Name (ranked by deaths).
%infiniteclan_top_points_<n>%Points of the n-th clan (ranked by points).
%infiniteclan_top_points_name_<n>%Name (ranked by points).
%infiniteclan_top_level_<n>%Level of the n-th clan (ranked by level).
%infiniteclan_top_level_name_<n>%Name (ranked by level).
%infiniteclan_top_members_<n>%Member count of the n-th clan (ranked by members).
%infiniteclan_top_members_name_<n>%Name (ranked by members).
Relational 3 · viewer-based
These compare the viewer to the shown player — use them with a plugin that supports relational placeholders (e.g. TAB) for chat/tab/nameplate coloring.
%rel_infiniteclan_relcolor%Color of the shown player's clan as seen by the viewer (own / ally / enemy / neutral). alias: relation_color
%rel_infiniteclan_reltext%Relation label. alias: relation_text
%rel_infiniteclan_reltext_colored%Relation label with its color. alias: reltext_coloured
No placeholder matches your search.