A powerful clan management plugin for Paper 1.21. Create, manage, and grow your clans with claims, power systems, alliances, and an integrated web panel.
ClanAscend-3.2.jarplugins/ folderconfig.yml to your needs/clan create YourName TAG to startCreate, disband, invite, accept, kick, and leave clans. Full permission hierarchy: Leader, Co-Leader, Officer, Moderator, Member. Configurable max members (5-50). LuckPerms integration for creation restrictions.
Claim chunks to protect your land. Prevent block break, place, PvP, explosions, fire spread, and mob spawning. Configurable allowed blocks. Ally building support. Claim cost in power, refundable on unclaim.
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). Disable PvP between allies. Allow building in ally claims (configurable). Request/accept/deny system with officer notifications. Auto-accept if mutual request exists.
Toggleable clan chat with configurable prefix (!). Global chat formatting with clan tag display. Customizable format strings. Works with MiniMessage for rich colors.
Set a clan home with teleport delay (configurable, 3s default) and cooldown (5s default). Teleport cooldown bypass permission available. Only officers can set home.
Shared inventory for all clan members. Optional power cost to open. Items stored as Base64 in clan settings. Viewable via web panel.
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). Particles and sounds on claim, power gain/loss, level up.
Full GUI system for clan management: main menu, members list, claims view, settings, leaderboard. Configurable via gui.yml (materials, slots, sizes). Update interval configurable.
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.
10 built-in languages: English, Spanish, French, German, Italian, Polish, Portuguese (BR), Russian, Turkish, Ukrainian. Fallback language support. Customizable via lang/ folder.
Full API with events (ClanCreateEvent, ClanDisbandEvent, PlayerJoinClanEvent, etc.) and ClanAscendAPI interface. Maven dependency available. PlaceholderAPI expansion included.
Top clans by power and level. Top players by kills and K/D ratio. Synchronized to local database for querying. Display in-game with /clan top.
All commands use the /clan base (alias /cl).
| Command | Description | Permission |
|---|---|---|
/clan create <name> [tag] | Create a new clan (cost: 1000 in config) | — |
/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 leave | Leave your current clan (leader cannot) | — |
/clan kick <player> | Kick a member from the clan | Officer+ |
/clan claim | Claim the chunk you are standing in | Officer+ |
/clan unclaim | Unclaim the current chunk | Officer+ |
/clan sethome | Set clan home at your location | Officer+ |
/clan home | Teleport to clan home (cooldown applies) | — |
/clan list | Open clan list GUI | — |
/clan info [clan] | View detailed clan information | — |
/clan top | View clan leaderboard | — |
/clan chat | Toggle clan chat mode | — |
/clan gui | Open the main clan GUI | — |
/clan members | Open members GUI | — |
/clan settings | Open settings GUI (description, tag, max) | Officer+ |
/clan ally add <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 chest | Open clan chest (if enabled) | — |
/clan reload | Reload clans from storage | clanascend.admin.reload |
Base command /clanadmin (alias /ca). Requires clanascend.admin.
| Command | Description | Permission |
|---|---|---|
/clanadmin help | Show admin help | clanascend.admin |
/clanadmin reload | Reload config, lang, and clans | clanascend.reload |
/clanadmin weblogin | Get a one-time login link for web panel | 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 setlevel <clan> <level> | Set clan level (1-100) | clanascend.admin |
/clanadmin disband <clan> | Force disband a clan | clanascend.disband.others |
/clanadmin addmember <clan> <player> | Add a player to a clan | clanascend.admin |
/clanadmin info <clan> | View detailed info (members, power, etc.) | clanascend.admin |
/clanadmin forceunclaim | Force unclaim the chunk you are in | clanascend.admin |
| Permission Node | Description | Default |
|---|---|---|
clanascend.admin | Access all admin commands | op |
clanascend.reload | Reload configuration | op |
clanascend.disband.others | Force disband any clan | op |
clanascend.bypass.claims | Bypass claim protection (build anywhere) | op |
clanascend.update | Receive update notifications on join | op |
In-clan permissions are managed by the role system: Leader, Co-Leader, Officer (can invite, kick, claim, manage settings), Moderator, Member.
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.creation-restriction — LuckPerms groupsclaims.enabled — trueclaims.claim-cost — 10 powerclaims.claim-refund — 5 powerclaims.prevent-* — break, place, pvpclaims.allowed-blocks — grass, flowerspower.per-kill — 5power.per-death — 2 (loss)power.per-minute-online — 0.1power.events.clan-war-win — 50chat.enabled — falsechat.format — customizablechat.clan-chat-prefix — !database.enabled — falsedatabase.type — sqlite / mysqlweb-server.port — 8080web-server.hostname — localhostCustomize every GUI: size, materials, slot positions, filler items. Located in plugins/ClanAscend/gui.yml.
main:
size: 54
filler:
enabled: true
material: BLACK_STAINED_GLASS_PANE
members:
size: 54
claims:
size: 36
settings:
size: 27
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_tag% | Player's clan tag |
%clanascend_power% | Clan power |
%clanascend_maxpower% | Max clan power |
%clanascend_level% | Clan level |
%clanascend_members% | Member count |
%clanascend_maxmembers% | Max members |
%clanascend_leader% | Leader name |
%clanascend_claims% | Claim count |
%clanascend_isonline% | Online status (true/false) |
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/kickedClanPointsAddEvent — Fired when points are addedClanPowerAddEvent — Fired when power is addedAdd ClanAscend as a dependency in your plugin.yml (depend: [ClanAscend]) and use the API:
// Get API instance
ClanAscendAPI api = ClanAscend.getAPI();
// Get a clan by name
Clan clan = api.getClan("MyClan");
// Get player's clan
Clan playerClan = api.getPlayerClan(player);
// Get clan power
int power = clan.getPower();
// Add power to clan
api.addClanPower(clan, 50);
// Get all clans
Map<String, Clan> allClans = api.getAllClans();
Add this to your pom.xml to use the API:
<dependency>
<groupId>org.pablito</groupId>
<artifactId>clanascend</artifactId>
<version>3.2</version>
<scope>provided</scope>
</dependency>
<repository>
<id>papermc</id>
<url>https://repo.papermc.io/repository/maven-public/</url>
</repository>
ClanAscend v3.2 — A clan management plugin for Paper 1.21.
Developed by pablito.