A powerful clan management plugin for Paper 1.20.1. Create, manage, and grow your clans with claims, power systems, alliances, cosmetics, and an integrated web panel.
ClanAscend-5.8.2.jarplugins/ folderconfig.yml to your needs/clan create YourName to startCreate, disband, invite, accept, join, decline, kick, promote, demote, and leave clans. Full permission hierarchy with 5 roles: Leader, Co-Leader, Officer, Moderator, Member. Configurable max members (5-50). LuckPerms integration for creation restrictions.
Claim chunks to protect your land. Prevents block break/place, PvP, explosions, fire spread, and mob spawning. Also blocks pistons pushing blocks across claims, liquid flow (water/lava) into claims, bucket usage, tree growth into claims, moss spread, and all block spread types. Configurable allowed blocks. Ally building support. Claim cost in power, refundable on unclaim. Config values read live — no restart needed after changing claim-cost or claim-refund.
Earn power through kills (+5), deaths lose power (-2), online time (+0.1/min). Bonus power from war/raid wins. Level up clan (1-100) for potion effects. Max power configurable. Visual effects on gain/loss (particles, titles).
Form alliances with other clans (max 5). PvP between allies is disabled by default but can be enabled in the config. Internal clan PvP can be always-on, with a command to temporarily disable it. Optional ally building in claims.
Toggleable clan chat with configurable prefix (!). Global chat formatting with clan tag display. Clan chat and global format both use the formatted clan tag (color + format codes applied). Customizable format strings. Legacy & color codes supported. Intercepts clan chat at low priority and cancels the event, making it compatible with third-party chat plugins (StarChat, ChatControl, etc.). Stealth mode can queue clan messages for later delivery.
Set multiple named clan homes (up to 3). Teleport delay (configurable, 3s default) and cooldown (5s default). Teleport cooldown bypass permission. Cost to set/teleport. Only officers can manage homes.
Shared inventory for all clan members. Optional power cost to open. Items stored as Base64 in clan settings.
Automatic potion effects applied to all online members based on clan level. Configure by level thresholds (e.g., Speed I at level 5, Haste I at level 10). Configurable apply interval.
Full GUI system for clan management: main menu, members list, member management, claims view, settings, cosmetics, homes, clan list, leaderboard. Fully configurable via gui.yml (materials, slots, sizes).
Built-in HTTP server (NanoHTTPD) for browser-based administration. Login with tokens generated by /clanadmin weblogin. Manage clans, members, roles, settings. API endpoints for custom integrations.
Supports SQLite (default) and MySQL. Automatic table creation. Async operations for performance. Player UUID sync on join. Automatic migration from file-based storage. Manual backup command.
10 built-in languages: English, Spanish, French, German, Italian, Polish, Portuguese (BR), Russian, Turkish, Ukrainian. Fallback language support. Customizable via lang/ folder.
Customize your clan tag with 16 color options (plus custom hex colors), 5 format styles combinable (bold, italic, underline, strikethrough, obfuscated), 5 glow effects (red, blue, green, yellow, purple), and animated tag styles: cycling colors and rainbow, plus 16 gradient presets. The clan glow effect works: teammates with an active glow effect are visible through walls with a colored outline matching the selected color. The formatted tag auto-appends a format reset (&r) to prevent color bleed into surrounding text.
Full API with events (ClanCreateEvent, ClanDisbandEvent, PlayerJoinClanEvent, PlayerLeaveClanEvent, ClanPointsAddEvent, ClanPowerAddEvent) and ClanAscendAPI interface. Maven dependency available. PlaceholderAPI expansion included.
Top clans by power, level, members, kills, and KOTH captures. Display in-game with /clan top. Member count included from the database for accurate ranking. PlaceholderAPI placeholders for use in holograms and menus.
Reward or subtract clan points for inviting or kicking members. Fully configurable. API events for custom integrations with other plugins like KOTH.
Automatic per-viewer nametag coloring: same clan in green, allies in purple, enemies in red. Configurable colors. Compatible with TAB plugin via bukkit-bridge. PlaceholderAPI expansion for custom setups.
Server-wide glowing engine with configurable refresh interval. Automatically hides glows when sneaking or invisible, during clan chat, and can hide nearby allies/enemies within a configurable radius. Non-members glow inside your claims (optional). Powers the cosmetic clan glows and claim highlighting.
Per-clan stealth toggle (/clan stealth, Officer+) for secret bases. While active, clan chat messages are queued (up to a configurable cap) instead of delivered live, and members are revealed when interacting with the world: levers, buttons, pressure plates, doors/trapdoors, block breaking. Fully configurable per trigger with alerts and cooldowns.
claim-cost, claim-refund, min-tag-length, and max-tag-length are read directly from config at runtime. Running /clanadmin reload applies changes immediately — no server restart required.
All commands use the /clan base (alias /cl).
| Command | Description | Permission |
|---|---|---|
/clan create <name> [tag] | Create a new clan with optional tag | clanascend.create |
/clan help | Show clan help | — |
/clan info [clan] | View detailed clan information (members, power, level, claims, allies) | — |
/clan gui | Open the main clan GUI | — |
/clan rename <name> | Rename your clan | Leader/Co-Leader |
/clan disband | Disband your clan (leader only) | — |
/clan invite <player> | Invite a player to your clan | Officer+ |
/clan accept <clan> | Accept a pending invitation | — |
/clan decline <clan> | Decline a pending invitation | — |
/clan join <clan> | Join an open clan | — |
/clan leave | Leave your current clan (leader cannot) | — |
/clan kick <player> | Kick a member from the clan | Officer+ |
/clan promote <player> | Promote a member | Leader/Co-Leader |
/clan demote <player> | Demote a member | Leader/Co-Leader |
/clan claim | Claim the chunk you are standing in | Officer+ |
/clan unclaim | Unclaim the current chunk | Officer+ |
/clan sethome [name] | Set a clan home at your location | Officer+ |
/clan home [name] | Teleport to clan home (cooldown applies) | — |
/clan homes | Open homes GUI | — |
/clan delhome <name> | Delete a clan home | Officer+ |
/clan ally <clan> | Send alliance request | Officer+ |
/clan ally accept <clan> | Accept alliance request | Officer+ |
/clan ally deny <clan> | Deny alliance request | Officer+ |
/clan ally remove <clan> | Remove an alliance | Officer+ |
/clan allies | List current allies | — |
/clan chat | Toggle clan chat mode | — |
/clan stealth [on|off] | Toggle per-clan stealth mode (queues clan chat, reveals interacting members) | Officer+ |
/clan pvp off | Temporarily disable internal clan PvP | Officer+ |
/clan list | Open clan list GUI | — |
/clan members | Open members GUI | — |
/clan settings | Open settings GUI | Officer+ |
/clan chest | Open clan chest | — |
/clan top <type> | View leaderboard (power/level/members/kills/koth) | — |
/clan reload | Reload clans from storage | clanascend.admin.reload |
Base command /clanadmin (alias /ca). Most subcommands require clanascend.admin.
| Command | Description | Permission |
|---|---|---|
/clanadmin help | Show admin help | clanascend.admin |
/clanadmin reload | Reload config, lang, and clans | clanascend.reload |
/clanadmin weblogin | Get one-time login link for web panel | clanascend.admin |
/clanadmin info <clan> | View detailed clan info | clanascend.admin |
/clanadmin setpower <clan> <value> | Set exact power for a clan | clanascend.admin |
/clanadmin addpower <clan> <amount> | Add or subtract power | clanascend.admin |
/clanadmin resetpower | Reset all clans power to 0 | clanascend.admin |
/clanadmin setlevel <clan> <level> | Set clan level (1-100) | clanascend.admin |
/clanadmin setall <attr> <value> | Set attribute on all clans (max_members/max_power) | clanascend.admin |
/clanadmin disband <clan> | Force disband a clan | clanascend.disband.others |
/clanadmin addmember <clan> <player> | Force-add a player to a clan | clanascend.admin |
/clanadmin forceunclaim | Force unclaim the chunk you are in | clanascend.admin |
/clanadmin setpointsinvite <clan> <points> | Set points for inviting members | clanascend.admin |
/clanadmin setpointskick <clan> <points> | Set points for kicking members | clanascend.admin |
/clanadmin backup | Create manual data backup | clanascend.admin |
| Permission Node | Description | Default |
|---|---|---|
clanascend.admin | Access all admin commands | op |
clanascend.create | Create a clan | true |
clanascend.reload | Reload configuration | op |
clanascend.admin.reload | Reload clans from storage (/clan reload) | op |
clanascend.disband.others | Force disband any clan | op |
clanascend.admin.bypassclaims | Bypass claim protection (runtime) | op |
clanascend.cooldown.bypass | Bypass home teleport cooldown | op |
In-clan permissions are managed by the role system: Leader > Co-Leader > Officer > Moderator > Member. Officers can invite, kick, claim, manage homes and settings; Leaders/Co-Leaders can promote, demote and rename. Admins with clanascend.admin.bypassclaims bypass all claim protection.
Main configuration file located in plugins/ClanAscend/config.yml. Auto-generated on first run.
clan.creation-cost — 1000clan.default-max-members — 20clan.default-power — 100clan.max-power — 1000clan.description-max-length — 64clan.min-tag-length — 2 liveclan.max-tag-length — 4 liveclan.points-on-invite — 0clan.points-on-kick — 0clan.moderators-can-invite — trueclan.creation-restriction.enabled — falseclan.creation-restriction.allowed-groups — vip, staffclaims.enabled — trueclaims.claim-cost — 10 power liveclaims.claim-refund — 5 power liveclaims.prevent-block-break — trueclaims.prevent-block-place — trueclaims.prevent-pvp — trueclaims.prevent-mob-spawning — falseclaims.glow-non-members — trueclaims.allowed-blocks — GRASS, TALL_GRASS, etc.power.per-kill — 5power.per-death — 2 (loss)power.per-minute-online — 0.1chat.format-enabled — truechat.clan-chat-enabled — truechat.format — customizablechat.clan-chat-prefix — !clan.pvp.internal-pvp-always-on — falseclan.pvp.disable-duration-seconds — 300clan.pvp.disable-cooldown-seconds — 600alliances.max-allies — 5alliances.pvp-enabled — falsealliances.allow-build-in-ally-claims — falseclan-home.enabled — trueclan-home.teleport-delay-seconds — 3clan-home.teleport-cooldown-seconds — 5clan-home.set-home-cost — 100clan-home.teleport-cost — 10clan-home.max-homes — 3database.enabled — falsedatabase.type — sqlite / mysqldatabase.host — localhostdatabase.port — 3306database.database — clanascenddatabase.username — rootdatabase.password — ""web-server.enabled — trueweb-server.bind-address — 0.0.0.0web-server.port — 8080web-server.hostname — localhostclan-chest.enabled — trueclan-chest.open-cost-power — 0clan-effects.enabled — falseclan-effects.apply-interval-seconds — 10clan-effects.effects-by-level — level thresholdscosmetics.enabled — truesecurity.enabled — truesecurity.reveal-on.levers / buttons / pressure-plates / doors-trapdoors / block-break — truesecurity.only-in-own-claim — truesecurity.notify-members — truesecurity.reveal-pending — truesecurity.alert-cooldown-seconds — 10security.max-queued-messages — 50glow-system.enabled — trueglow-system.refresh-interval-ticks — 20glow-system.hide-when-sneaking — trueglow-system.hide-when-invisible — trueglow-system.hide-during-clan-chat — trueglow-system.hide-near.enabled — trueglow-system.hide-near.radius — 16glow-system.hide-near.allies / enemies — truebroadcast.clan-creation — true (+ custom message)broadcast.clan-disband — true (+ custom message)nametag.enabled — truenametag.same-clan-color — GREENnametag.ally-color — LIGHT_PURPLEnametag.other-color — REDCustomize every GUI: size, materials, slot positions, filler items. Located in plugins/ClanAscend/gui.yml. Sections: main, members, member_manage, claims, settings, confirm_disband, clan_list, clan_members_view, cosmetics (tag_color, tag_format, glow_effect, tag_style), homes, chest.
Cosmetics tip: Add custom hex colors by including a color_code field in any cosmetics.items.tag_color.<key> entry (e.g., color_code: "#FF4500"). Animated tag styles (cycling, rainbow) and 16 gradients ship under cosmetics.items.tag_style.*.
main:
size: 54
filler:
enabled: true
material: GRAY_STAINED_GLASS_PANE
members:
size: 54
member_manage:
size: 36
claims:
size: 54
settings:
size: 27
chest:
# Size is fixed at 54 in code
items:
back:
material: ARROW
slot: 53
cosmetics:
size: 54
homes:
size: 54
Located in plugins/ClanAscend/lang/. Set language via language key in config.yml. Fallback to English if missing keys.
ClanAscend provides placeholders for PlaceholderAPI. Use them in scoreboards, chat, signs, etc. Requires PlaceholderAPI installed.
| Placeholder | Description |
|---|---|
%clanascend_clan% | Player's clan name |
%clanascend_name% | Player's clan name (alias) |
%clanascend_tag% | Player's clan tag with color/format codes |
%clanascend_tag_legacy% | Clan tag with Bukkit legacy hex format (&x&R&R&G&G&B&B) |
%clanascend_clan_formatted% | Formatted tag + name |
%clanascend_in_clan% | In clan? (yes/no) |
%clanascend_power% | Clan power |
%clanascend_max_power% | Max clan power |
%clanascend_level% | Clan level |
%clanascend_exp% | Clan experience |
%clanascend_members% | Member count |
%clanascend_online_members% | Online members count |
%clanascend_max_members% | Max members |
%clanascend_leader% | Leader name |
%clanascend_claims% | Claim count |
%clanascend_max_claims% | Max claims |
%clanascend_desc% | Clan description |
%clanascend_created% | Creation date |
%clanascend_allies% | Number of allies |
%clanascend_is_open% | Is open? (yes/no) |
%clanascend_role% | Role (leader/officer/member) |
%clanascend_role_formatted% | Role formatted (Leader/Officer/Member) |
%clanascend_total_kills% | Total clan kills |
%clanascend_kothcaptures% | KOTH captures count |
%clanascend_nametag_color% | Clan tag color code (for TAB config) |
Use %clanascend_top_<type>_<rank>_<stat>% pattern.
type: power, level, members, kills, kothrank: position number (1, 2, 3...)stat: name, tag, power, level, members, kills, kothcapturesExample: %clanascend_top_power_1_name% returns the #1 clan by power.
§ section-sign color codes for maximum compatibility. This means they work out of the box in chat, scoreboards, TAB, and any other plugin without requiring MiniMessage parsing. Test with /papi parse.
Customize your clan tag appearance via the cosmetics GUI (/clan gui → Cosmetics button) or directly with tag color, tag format, and glow commands.
color_code in gui.yml&l)&o)&n)&m)&k)&l&o)cosmetics.items.tag_style.* in gui.yml; cycling color changes every 1.5s.Hex Color Support: You can add custom hex colors to the cosmetics GUI by adding a color_code field to gui.yml. Supported formats: #RRGGBB, &#RRGGBB, &x&R&R&G&G&B&B, <#RRGGBB>. The system normalizes all formats automatically.
&r to prevent color and format codes from bleeding into surrounding chat or scoreboard text. This ensures your tag always appears cleanly without affecting what comes after it.
/clanadmin weblogin in-game to get a one-time login link./logout to end it.clanascend.admin.weblogin (declared, op by default).web-server: enabled: true bind-address: "0.0.0.0" port: 8080 hostname: "localhost"
Security note: these keys may not exist in older generated configs — add them manually. The panel binds to all interfaces (0.0.0.0) by default; restrict bind-address or use a firewall/reverse proxy on production servers. Changing toggles requires a restart.
All endpoints require an authenticated session (cookie). Heavy operations run async on the main thread.
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/clans | List all clans (id, name, tag, level, experience, power, memberCount) |
| POST | /api/clans | Create a clan — body: {name, tag} |
| GET | /api/clans/{id}/full | Full clan data (description, dates, leader, open, claims…) |
| GET | /api/clans/{id}/members | List members with roles |
| POST | /api/clans/{id}/members | Add member by name — body: {playerName} |
| PUT | /api/clans/{id} | Update clan fields — body: {name, tag, experience, power, maxPower, description, isOpen, level} |
| PUT | /api/clans/{id}/members/{uuid} | Change member role — body: {role} (Leader/Co-Leader/Officer/Member) |
| DELETE | /api/clans/{id} | Disband clan |
| DELETE | /api/clans/{id}/members/{uuid} | Remove member (leader protected) |
| GET | /api/clans/{id}/chest | View clan chest contents (if enabled) |
| GET | /api/players/unassigned | Players not in any clan |
| GET | /api/languages | Available languages + current one |
| POST | /api/languages | Switch server language — body: {language} |
plugins/ClanAscend/www/ (exported from the JAR on first boot), so you can customize index.html, login.html, and style.css without rebuilding. Changes are picked up on request (no-cache).
Listen to clan actions with custom Bukkit events:
ClanCreateEvent — Fired when a clan is createdClanDisbandEvent — Fired when a clan is disbandedPlayerJoinClanEvent — Fired when a player joins a clanPlayerLeaveClanEvent — Fired when a player leaves or is kickedClanPointsAddEvent — Fired when points are addedClanPowerAddEvent — Fired when power is addedAccess via ClanAscend.getAPI(). Add depend: [ClanAscend] in your plugin.yml.
// Get API instance
ClanAscendAPI api = ClanAscend.getAPI();
// Get a clan by ID or name
Clan clan = api.getClan("MyClan");
// Get player's clan
Clan playerClan = api.getPlayerClan(player);
// Check if chunk is claimed
boolean claimed = api.isChunkClaimed(chunk);
Clan owner = api.getClanAt(chunk);
// Get clan stats
int power = clan.getPower();
int level = clan.getLevel();
int koth = clan.getKothCaptures();
// Reward clans (for KOTH, wars, etc.)
api.rewardPlayerClanPoints(player, 100, "KOTH win");
api.rewardPlayerClanPower(player, 50, "KOTH win");
api.rewardPlayerClanKoth(player, 100, 50, "KothName");
// Get all clans
Collection<Clan> allClans = api.getAllClans();
Add this to your pom.xml to use the API:
<dependency>
<groupId>org.pablito</groupId>
<artifactId>clanascend</artifactId>
<version>5.8.2</version>
<scope>provided</scope>
</dependency>
<repository>
<id>papermc</id>
<url>https://repo.papermc.io/repository/maven-public/</url>
</repository>
ClanAscend v5.8.2 — A clan management plugin for Paper 1.20.1.
Developed by pablito.