ClansForPlus

A full-featured clan plugin for Paper 26.2. Create clans, customize colored tags, manage ranks and permissions, form alliances and rivalries, share a bank and storage, complete quests, and manage everything through configurable menus. All settings live in YAML files, so you can adjust the plugin without touching the code.

Features

• Clans: create, invite, accept, leave, kick, disband, set and teleport to a clan home, view clan info and a server-wide clan list.
• Colored tags: the tag text always matches the clan name. Players change only the color, using & codes, hex (&#RRGGBB), or RGB (<rgb:R,G,B>). Per-letter gradients are supported.
• Ranks and permissions: Leader, Officer, and Member by default. Leaders can create and delete their own ranks, edit permissions, and assign ranks.
• Diplomacy: allies cannot be attacked, rivals can. Friendly fire is blocked by default and can be enabled in the config.
• Levels and points: clans earn points from kills and quests. Levels raise the member limit and unlock storage rows.
• Stats: kills, deaths, and K/D for every member, with assist credit for recent damage.
• Bank and storage: deposit and withdraw money through Vault, plus a shared item storage unlocked by level.
• Quests: 16 built-in quests for mining, PvP, walking, banking, and points, all defined in quests.yml.
• Menus: the full clan menu is described in menus.yml. Set slot, material, name, lore, glow, and click actions. Owners can get separate buttons.
• PlaceholderAPI: clan data for your tab list, scoreboards, holograms, and chat, plus a top-clans placeholder such as %clans_top_1_name%.
• WorldGuard support: clan homes cannot be set in regions where the player cannot build.
• Safe saving: asynchronous saves with atomic writes and rotating backups.

Requirements

• Paper 26.2
• Vault (optional): bank and paid clan creation
• PlaceholderAPI (optional): placeholders
• WorldGuard (optional): home protection

Commands

• /clan or /clan menu: clan menu
• /clan help: full command list
• /c <message>: clan chat
• /clanforplus reload: reload configs (operators)

Configuration

Everything is configurable in plugins/ClansForPlus/:

• config.yml: creation cost, chat format, tags, home, announcements, friendly fire, invites, names, points, levels, quests, diplomacy, top, saving
• messages.yml: all plugin messages
• menus.yml: all menus
• quests.yml: quest list
• ranks.yml: default rank template

Placeholders

Player clan: %clans_name%, %clans_modtag%, %clans_role%, %clans_level%, %clans_points%, %clans_bank%, %clans_members%, %clans_kd%, and more.

Top clans: %clans_top_<place>_<field>%. Fields: name, tag, modtag, level, points, bank, members, kills, deaths, kd.

Known limitations

• Leadership transfer is not implemented yet.
• Bank and storage transaction logs are not kept yet.
• Admin commands for viewing clans and resetting stats are planned.
• Data is stored in YAML, which may be slow with a very large number of clans.