ClansPvP — Modern Clan Plugin
ClansPvP is a modern, all-in-one clans & land-claim plugin for Paper/Spigot servers.
It combines clans, chunk claiming, protection, power, raids, vaults, warps, alliances, and a clean in-game UI into one lightweight solution — fully configurable and permission-driven.
Feature Overview
| Category | Highlights |
|---|---|
| Core Clans | Create/disband, roles (Leader, Officer, Member, Recruit), invites & join requests, promote/demote |
| Alliances | /clan ally <clan> ↔ accept/deny; optional mutual trust toggle (build/break rules) |
| Land Claiming | Chunk-based claims, per-member limits, optional overclaiming, interactive /clanmap viewer |
| Land Protection | Block break/place, buckets, containers, item frames/paintings, redstone interactions (configurable) |
| Power System | Kill rewards, death penalties, automatic regeneration, overclaim vulnerability warnings |
| Raids | Controlled raids with `/clan raid start |
| Shared Vault | GUI vault, optional bonus slots via permissions |
| Warps | /clan setwarp <name> & /clan warp <name> with limits + cooldowns |
| Ally-Warps | Shared warps for allies with separate limits/cooldowns |
| Territory Alerts | Actionbar enter/leave notifications for own/ally/enemy/wilderness land |
| Combat Protection | Friendly-fire blocking for clans and allies, projectile & splash potion support |
| GitHub Issue Reporter | /clan issue <player> <title> <info> opens an issue on your repo (optional) |
| Live Scoreboard | Sidebar shows power, members, claims, allies, and more |
| Friendly-Fire Toggle | Leaders set `/clan friendlyfire on |
| K/D Requirement | Optional minimum K/D requirement to create a clan |
| Donor Perks | Extra power or vault slots via Vault permission groups |
| Modern Chat UI | Hex colors (&#RRGGBB), clickable messages, Unicode symbols, progress bars |
Command Cheat-Sheet
/clan create <name> [tag] – Create a clan
/clan info – Show clan details (+ scoreboard)
/clan vault – Open shared vault
/clan invite <player> – Invite player
/clan join <clan> / cancel – Request / cancel join
/clan accept|deny [player] – Handle invites or join requests
/clan leave – Leave clan
/clan promote|demote <player> – Rank management
/clan disband / confirm – Disband clan
/clan claim|unclaim – Claim / unclaim chunk
/clan raid start|stop|check – Raid controls
/clan setwarp <name> – Set clan warp
/clan warp <name> – Teleport to clan warp
/clan ally <clan> – Send alliance request
/clan ally accept|deny – Handle alliance requests
/clan ally <clan> trust on|off – Allow allies to build/break
/clan ally setwarp <name> – Set ally-warp (shared)
/clan ally warp <name> – Teleport to ally-warp
/clan friendlyfire on|off – Toggle intra-clan PvP
/clan issue <player> <title> <info> – Create GitHub issue (optional)
/clanmap – Interactive land map
/clan reload – Reload plugin (admin)
Installation
- Drop ClansPvP.jar into your server’s /plugins folder
- Restart the server (default configs will generate)
- Configure settings in config.yml (power, claims, warps, messages, permissions, etc.)
Configuration (examples)
YAML:
# ─────────────────────────────────────────────
# ClansPvP Configuration File
# Version 2.0.0 (Improved Edition)
# ─────────────────────────────────────────────
enable-plugin: true
debug-mode: false
# ─── GitHub-integratie voor /clan issue ──────
github:
repository: "xxxxxx/xxxxxx"
token: "github_pat_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
default-labels: ["bug"]
cooldown-seconds: 60
# ─── Power System ─────────────────────────────
enable-power: true
start-power-per-player: 5
max-power-per-player: 5
power-per-kill: 1
power-loss-per-death: 2
power-regen:
enabled: true
interval-minutes: 10
amount-per-interval: 1
# ─── Donor Bonuses ───────────────────────────
donor-bonus-power:
enabled: true
default-bonus: 0
groups:
donor1: 5
donor2: 10
vip: 10
donor-bonus-vault:
enabled: true
default-bonus: 0
groups:
silver: 5
gold: 10
platinum: 15
# ─── Land Claim Settings ─────────────────────
claiming:
enabled: true
use-whole-chunk: true
chunk-includes-full-height: true
allow-overclaiming: true
max-chunks-per-clan-member: 1
overclaim-penalty: true
overclaim-warning: "&c⚠ Your clan is vulnerable to overclaiming!"
overclaim-safe: "&a✔ Your clan is no longer overclaimable."
unclaim-on-disband: true
# ─── Clan Creation Settings ──────────────────
clan-creation:
enabled: true
require-permission: false
tag-prefix-enabled: true
max-tag-length: 5
min-kdr-to-create: 0
allow-friendly-fire: false
max-members-per-clan: 15
# ─── Global Settings ─────────────────────────
settings:
allow-friendly-fire-between-allies: false
# ─── Ally-Trust Defaults ─────────────────────
ally-trust:
default-enabled: false
require-mutual: true
# ─── Clan Vault Settings ─────────────────────
vault:
enabled: true
base-slots: 20
allow-item-limit: true
# ─── Warp System ─────────────────────────────
warp:
enabled: true
max-warps-per-clan: 5
cooldown-seconds: 30
setwarp-permission: false
# ─── Ally-Warp System ────────────────────────
warp-ally:
enabled: true
max-warps-per-clan: 2
cooldown-seconds: 60
# ─── Role Permissions ───────────────────────
roles:
LEADER:
can-invite: true
can-promote: true
can-demote: true
can-claim: true
can-unclaim: true
can-setwarp: true
can-raid: true
OFFICER:
can-invite: true
can-promote: false
can-demote: false
can-claim: true
can-unclaim: false
can-setwarp: true
can-raid: true
MEMBER:
can-invite: false
can-promote: false
can-demote: false
can-claim: false
can-unclaim: false
can-setwarp: false
can-raid: false
# ─── Raid Settings ───────────────────────────
raid:
enabled: true
allow-only-leaders: true
allowed-roles:
- LEADER
- OFFICER
messages:
raid-started: "&a✔ &7Raid started at &fX: &b%x% &fY: &b%y% &fZ: &b%z%"
raid-location: "&b📍 &7Current raid location: &fX: &3%x% &fY: &3%y% &fZ: &3%z%"
raid-stopped: "&e✔ &7Raid has been &cstopped&7."
no-permission: "&c✘ &7You don't have permission to do that."
no-raid-active: "&c✘ &7No raid location is currently set."
# ─── Messages (Styled UI) ─────────────────────
messages:
# Notifications
notify-clan-login: true
notify-clan-logout: true
clanmate-joined: "&a✦ &f%player% &7has come online."
clanmate-left: "&c✦ &f%player% &7has gone offline."
pending-ally-login: "&e✦ You have a pending ally request from &f%clan%&e. Use &a/clan ally accept &eor &c/clan ally deny&e."
pending-invite-login: "&e✦ You have a pending invite from &f%clan%&e. Use &a/clan accept &eor &c/clan deny&e."
# General
already-has-request: "&c✘ &7You already have a pending join request."
already-in-clan: "&c✘ &7You are already in a clan."
unknown-command: "&c✘ &7Unknown subcommand. Use &f/clan help"
no-permission: "&c✘ &7You do not have permission to do this."
not-in-clan: "&c✘ &7You are not in a clan."
player-not-online: "&c✘ &7That player is not online."
# Ally messages
already-allies: "&e✘ &7Your clan is already allied with &f%clan%&7."
ally-request-denied: "&c✘ &7You denied the ally request from &f%clan%&7."
ally-request-accepted: "&a✔ &7You accepted the ally request from &f%clan%&7."
ally-accepted: "&a✔ &7Your clan is now allied with &f%clan%&7."
ally-request-already-sent: "&e✘ &7You already sent an ally request to &f%clan%&7."
ally-request-sent: "&a✔ &7Ally request sent to &f%clan%&7. Waiting for confirmation."
ally-request-received: "&e✦ &7You received an ally request from &f%clan%&7. Type &a/clan ally accept &7or &c/clan ally deny."
no-pending-ally-request: "&c✘ &7You have no pending ally requests."
only-leader-can-ally: "&c✘ &7Only the clan leader can perform this action."
# Trust messages
trust-enabled: "&a✔ &7Build trust enabled with &e%clan%&7."
trust-disabled: "&e✓ &7Build trust disabled with &e%clan%&7."
# Roles
cannot-change-role: "&c✘ &7Cannot %action% this player further."
promoted: "&a✔ &f%player% &7has been promoted."
demoted: "&e✦ &f%player% &7has been demoted."
you-were-promoted: "&a✔ &7You have been promoted to &e%role%"
you-were-demoted: "&e✦ &7You have been demoted to &e%role%"
# Claiming
claim-limit-reached: "&c✘ &7You cannot claim more land. &8(Max chunks reached)"
clan-claim-already: "&c✘ &7This land is already claimed."
clan-claim-fail: "&c✘ &7Failed to claim the land."
clan-claim-success: "&a✔ &7You successfully claimed this land for your clan!"
clan-unclaim-fail: "&c✘ &7Failed to unclaim the land."
clan-unclaim-not-claimed: "&c✘ &7This land is not claimed."
clan-unclaim-not-owned: "&c✘ &7You can only unclaim your own clan's land."
clan-unclaim-success: "&a✔ &7Land has been unclaimed."
# Protection
protection-denied: "&c✘ You cannot %action% in land claimed by &f%clan%&c."
# Clan creation/management
clan-created: "&a✔ &7Clan &8[&e%tag%&8] &b%name% &7was successfully created!"
clan-disband-confirm: "&a✔ &7Are you sure you want to disband your clan? Type &e/clan confirm &7within 30 seconds."
clan-disband-success: "&a✔ &7Clan disbanded successfully."
clan-disbanded: "&c✘ &7Clan &e%name% &7has been disbanded. All land unclaimed."
clan-disbanded-notify: "&c✘ &7Your clan has been disbanded."
clan-exists: "&c✘ &7A clan with that name already exists."
clan-header: "&8─[ &6Clan Info &8]─"
clan-not-exist: "&c✘ &7That clan does not exist."
clan-not-found: "&c✘ &7Clan &f%name% &7was not found."
clan-tag-too-long: "&c✘ &7Clan tag is too long. Max: &e%max% &7characters."
# Friendly fire
friendlyfire-enabled: "&a✔ &7Friendly fire is now &cenabled &7for your clan."
friendlyfire-disabled: "&a✔ &7Friendly fire is now &adisabled &7for your clan."
friendly-fire-blocked: "&c✘ Friendly fire is disabled in your clan."
ally-friendly-fire-blocked: "&c✘ You cannot attack members of allied clan &f%clan%&c."
only-leader-friendlyfire: "&c✘ &7Only the clan leader can change friendly fire settings."
# Invites
invite-instruction: "&7Type &a/clan accept &7to join."
invite-received: "&eYou have been invited to join clan &6%clan%&e!"
invite-sent: "&a✔ &7Invitation sent to &f%player%"
no-pending-invite: "&c✘ &7You have no pending invites."
# Join
join-accepted: "&a✔ &7You have joined clan &e%clan%&7!"
join-accepted-by: "&a✔ &7You accepted &e%player% &7into your clan."
join-denied: "&a✔ &7You denied the join request from &e%player%."
join-request-cancelled: "&a✔ &7Join request cancelled."
join-request-denied: "&c✘ &7Your join request to &e%clan% &7was denied."
join-request-sent: "&a✔ &7Join request sent to clan &e%clan%&7. Wait for approval."
no-pending-request: "&c✘ &7You have no pending join request."
# Leave
left-clan: "&a✔ &7You left your clan."
only-leader-disband: "&c✘ &7Only the clan leader can disband the clan."
only-leader-leave: "&c✘ &7As leader, use &e/clan disband &7to disband your clan."
only-leader-or-officer: "&c✘ &7Only clan leaders or officers can perform this action."
only-leader-cannot-demote: "&c✘ &7You are the only leader. You cannot demote yourself."
# Power messages
power-gained-kill: "&a✓ You gained &f%.1f &apower! Current: &f%.1f&a/&f%.1f"
power-lost-death: "&c✘ You lost &f%.1f &cpower on death. Current: &f%.1f"
power-at-max: "&e✦ You are at maximum power (&f%.1f&e)."
no-power-clanmate-kill: "&e✦ Kill recorded, but no power awarded for killing a clanmate."
# Overclaim
overclaimed-land: "&c⚠ &7An enemy has overclaimed part of your land!"
# Players
player-already-in-clan: "&c✘ &7That player is already in a clan."
player-invited: "&a✔ &7You invited &f%player% &7to your clan."
player-joined-clan: "&a✔ &f%player% &7joined your clan!"
player-left-clan: "&e✦ &f%player% &7has left your clan."
player-not-in-clan: "&c✘ &7You are not a member of any clan."
player-not-in-your-clan: "&c✘ &7That player is not in your clan."
player-not-requested-join: "&c✘ &7That player has not requested to join your clan."
# Raid
raid-location: "&7Location: &fX: %x% Y: %y% Z: %z%"
raid-not-allowed: "&c✘ &7Only clan leaders or officers can %action% raids."
raid-started: "&a✔ &7Raid started at your current location!"
raid-stopped: "&c✘ &7Raid has been stopped by &f%player%&7."
# Territory messages
territory-enter-own: "&a⬤ Entering &7your clan territory &8[&a%clan%&8]"
territory-leave-own: "&c⬤ Leaving &7your clan territory &8[&a%clan%&8]"
territory-enter-ally: "&d⬤ Entering &7allied territory &8[&d%clan%&8]"
territory-leave-ally: "&7⬤ Leaving &7allied territory &8[&d%clan%&8]"
territory-enter-enemy: "&c⚠ Entering &7enemy territory &8[&c%clan%&8]"
territory-leave-enemy: "&a✓ Leaving &7enemy territory &8[&c%clan%&8]"
territory-enter-neutral: "&e⬤ Entering &7claimed territory &8[&e%clan%&8]"
territory-leave-neutral: "&7⬤ Leaving &7claimed territory &8[&e%clan%&8]"
# KDR
not-enough-kdr: "&c✘ &7Your K/D ratio is too low. Required: &e%kdr%"
# Usage messages
usage-clan-demote: "&c✘ &7Usage: &f/clan demote <player>"
usage-clan-invite: "&c✘ &7Usage: &f/clan invite <player>"
usage-clan-join: "&c✘ &7Usage: &f/clan join <clan>"
usage-clan-promote: "&c✘ &7Usage: &f/clan promote <player>"
usage-clan-raid: "&c✘ &7Usage: &f/clan raid <start|stop|check>"
usage-clan-ally: "&c✘ &7Usage: &f/clan ally <name|accept|deny>"
usage-clan-friendlyfire: "&c✘ &7Usage: &f/clan friendlyfire <on|off>"
# Vault
vault-full: "&c✘ &7Clan vault is full!"
vault-header: "&8─[ &bClan Vault &8]─"
vault-item-added: "&a✔ &7Item added to vault."
vault-opened: "&a✔ &7Clan vault opened."
# Warps
warp-not-found: "&c✘ &7Warp &f%warp% &7does not exist."
warp-set: "&a✔ &7Warp &f%warp% &7has been set."
warp-teleport: "&b✦ &7Teleporting to warp &f%warp%..."
# ─── UI Settings ──────────────────────────────
ui:
modern-chat-style: true
show-headers: true
symbols:
check: "✔"
cross: "✘"
arrow: "»"
bullet: "•"
warning: "⚠"
headers:
clan-info: "&8────[ &6Clan Info &8]────"
vault: "&8────[ &bClan Vault &8]────"
colors:
clan-name: "gold"
member-list: "green"
land-info: "aqua"
Permissions (common)
| Node | Default | Purpose |
|---|---|---|
| clanspvp.create | Create a clan | |
| clanspvp.claim | Claim chunks | |
| clanspvp.unclaim | Unclaim chunks | |
| clanspvp.vault | Open clan vault | |
| clanspvp.vault.bonus | Extra vault slots | |
| clanspvp.raid.start | Start raids | |
| clanspvp.raid.stop | Stop raids | |
| clanspvp.raid.check | Check raid location | |
| clanspvp.warp.set | Set warps | |
| clanspvp.warp.use | Use warps | |
| clanspvp.warp.ally.set | Set ally warps | |
| clanspvp.warp.ally.use | Use ally warps | |
| clanspvp.protection.bypass | OP | Bypass land protection |
| clanspvp.reload | OP | Reload configuration |
| clanspvp.admin | OP | Admin features |
(Full list is included in plugin.yml.)
Works best with LuckPerms + Vault.
Requirements
| Requirement | Version |
|---|---|
| Java | 17+ |
| Server | Paper/Spigot 1.20 – 1.21 |
| Vault | Required (permissions bridge) |
| LuckPerms | Optional (recommended) |
| EssentialsX | Optional |
Interactive /clanmap
─────────────── ✦ Clan Map (N) ─────────────────
▲ N
░░░░░░░░░░░░░░
░░░░░░░█░░░░░░░
░░░░░░█◆█░░░░░░
░░░░░░░█░░░░░░░
░░░░░░░░░░░░░░
Legend: ◆ You █ Own █ Ally █ Enemy ░ Free
────────────────────────────────────────────────
Territory Notifications
Players get actionbar alerts when entering/leaving territory:
| Entering | Message (example) |
|---|---|
| Own territory | |
| Allied territory | |
| Enemy territory | |
| Wilderness |
All messages are configurable in config.yml.
Power System
| Action | Power Change |
|---|---|
| Kill enemy player | +X (configurable) |
| Death | -X (configurable) |
| Regen interval | +X (configurable) |
| Kill clanmate | No reward (anti-boost) |
Overclaiming: if a clan’s total power drops below what it needs to hold claims, enemies can overclaim those chunks.
Protection System
Protected actions in claimed land:
Block breaking & placing
Bucket usage (water/lava)
Container access (chests, hoppers, furnaces, etc.)
Item frames & paintings
Redstone interactions (buttons/levers)
- Own clan land: full access
- Allied land with mutual trust: full access
- Admin bypass permission: full access
Author
Wolfsketch AKA Jason — Minecraft plugin developer
Have feedback or bug reports? Use GitHub issues (or /clan issue in-game if enabled).
License
ClansPvP is closed-source.
Redistribution, modification, or resale is prohibited without permission.
