ClanWars Addon - Command & Permission Reference
Player Commands
| Command | Description |
|---|---|
| /clan war challenge <clan> [kit] | Opens the kit selection GUI and sends a war challenge to the target clan. If no kits are configured, the challenge is sent with default (no kit). |
| /clan war accept | Accepts an incoming war challenge from another clan. |
| /clan war deny | Denies an incoming war challenge. The challenger clan is notified. |
| /clan war confirm | Confirms your personal participation in a war that was accepted. Required before the countdown starts. |
| /clan war leave | Leaves the active war. If your clan runs out of participants, your clan forfeits. |
| /clan war status | Shows the current war state, clans, kill score, and phase. |
Admin Commands
| Command | Description |
|---|---|
| /rclan war arena create <name> | Creates a new arena with the given name. Must be configured before use. |
| /rclan war arena delete <name> | Deletes an arena permanently. |
| /rclan war arena list | Lists all arenas with their status, min players, kill limit, time limit and keep-inventory setting. |
| /rclan war arena setpos1 <arena> | Sets Spawn A (challenger clan) to your current position. |
| /rclan war arena setpos2 <arena> | Sets Spawn B (defender clan) to your current position. |
| /rclan war arena setmin <arena> <amount> | Sets the minimum players per clan required to start the war. |
| /rclan war arena set <arena> keep-inventory <true/false> | Toggles whether players keep their inventory on death inside the arena. |
| /rclan war arena set <arena> kills-to-win <amount> | Sets the kill limit to win. Set to 0 to disable. |
| /rclan war arena set <arena> time-limit <seconds> | Sets a time limit in seconds. Winner is decided by kills at time's end. Set to 0 to disable. |
| /rclan war arena set <arena> allow-drop <true/false> | Toggles whether players can drop items inside the arena. |
| /rclan war arena set <arena> block-commands <true/false> | Toggles whether commands are blocked inside the arena (except those in allowed-commands). |
| /rclan war kit create <name> | Saves your current inventory + armor as a named kit for wars. |
| /rclan war kit delete <name> | Deletes a kit. |
| /rclan war kit list | Lists all configured kits. |
| /rclan war list | Shows all currently active wars with arena, state and kill score. |
| /rclan war end <clanA> <clanB> | Force-ends a war between two clans. Result is a draw. |
Permissions
| Permission | Description | Default |
|---|---|---|
| clanwars.* | Full access to all ClanWars commands. | false |
| clanwars.user | Access to all player commands (/clan war). | true |
| clanwars.admin | Access to all admin commands (/rclan war). Inherits clanwars.user. | op |
War Flow (How it works)
| Step | What happens |
|---|---|
| 1. Challenge | A clan leader opens the kit GUI via /clan war challenge <clan> and selects a kit (or none). |
| 2. Accept / Deny | A leader of the target clan runs /clan war accept or /clan war deny. |
| 3. Confirm | Each player who wants to participate runs /clan war confirm within the confirm window (default: 30s). |
| 4. Countdown | If minimum players per side confirmed, a countdown starts (default: 10s). |
| 5. Teleport | Players are teleported to their clan's spawn. Inventory is saved. Kit is applied if selected. |
| 6. War | Players fight. Kills are tracked. Winner is the clan that reaches the kill limit first, or has more kills when time runs out. |
| 7. End | Players are returned to their original location with their original inventory restored. |
YAML:
# Seconds before the war starts after both clans accepted (teleport countdown)
countdown-seconds: 10
# Seconds before a pending war challenge expires
war-request-timeout-seconds: 60
# Seconds members have to confirm their participation after both leaders accepted
confirm-timeout-seconds: 30
# Conditions that must be true for BOTH the challenger and acceptor at challenge/accept time.
# Format: <placeholder> <operator> <value>
# Operators: ==, !=, >, <, >=, <=
# Example: "%essentials_vanished% == no" prevents vanished players from starting a war.
# Requires PlaceholderAPI. Leave empty to disable condition checks.
start-conditions: []
# examples
# - "%combat_tagged% == false"
# - "%essentials_vanished% == no"
# Commands allowed inside arenas when block-commands is true for an arena.
# The "clanwars" and "clan" commands are always allowed automatically.
allowed-commands:
- clanwars
- clan
blocked-items:
- PAPER
- NETHER_STAR
- WRITTEN_BOOK
# - BOOK
#- ENDER_PEARL
YAML:
prefix: "&8[&dRyzenClans-Addon-ClanWars&8] &r"
no-permission: "&cYou don't have permission to do that."
no-clan: "&cYou are not in a clan."
war:
challenge:
usage: "&cUsage: /clan war challenge <clan> [kit]"
sent: "&aChallenge sent to clan &e%clan%&a! Kit: &e%kit%&a. They have 60s to accept."
received: "&6Clan &e%challenger_clan% &6(&e%challenger%&6) challenged your clan to war! Kit: &e%kit%\n&7Use &e/clan war accept &7or &e/clan war deny&7."
already-at-war: "&cYour clan is already at war."
target-at-war: "&cClan &e%clan% &cis already at war."
self: "&cYou cannot challenge your own clan."
already-sent: "&cA challenge to &e%clan% &cis already pending."
accept:
success: "&aChallenge accepted! Members can now use &e/clan war confirm &ato join."
no-challenge: "&cYour clan has no pending war challenge."
expired: "&cThe war challenge has expired."
deny:
success: "&aChallenge denied."
no-challenge: "&cYour clan has no pending war challenge."
notify: "&eClan &b%clan% &edenied your war challenge."
confirm:
success: "&aYou confirmed your participation! Stand by for the countdown."
no-war: "&cThere is no pending war confirmation for you."
leave:
success: "&eYou left the war."
not-in-war: "&cYou are not in a war."
status:
none: "&cYou are not in an active war."
info: "&6War: &e%clan_a% &7vs &e%clan_b% &7| Score: &e%kills_a%&7-&e%kills_b% &7| State: &f%state%"
confirm-request: "&6War starting between &e%clan% &6and your clan!\n&7Arena: &e%arena% &7| Kit: &e%kit%\n&aUse &e/clan war confirm &ato join! You have 30s."
player-joined: "&a%player% &7has joined ClanWars! &e[%confirmed_a%/%total_a%] %clan_a% &7vs &e%clan_b% [%confirmed_b%/%total_b%]"
countdown: "&eWar starts in &6%seconds%s &7| &e%clan_a% &f[%confirmed_a%/%total_a%] &7vs &e%clan_b% &f[%confirmed_b%/%total_b%]"
started: "&a&lWAR STARTED! &e%clan_a% &7vs &e%clan_b% &7- May the best clan win!"
kill: "&e%killer% &7(&e%killer_clan%&7) killed &c%victim%&7! Score: &e%kills_a%&7-&e%kills_b%"
ended-winner: "&6&lWAR ENDED! &e%winner% &6wins! Final: &e%clan_a% &f%kills_a% &7- &e%clan_b% &f%kills_b%"
ended-draw: "&6&lWAR ENDED IN A DRAW! &e%clan_a% &f%kills_a% &7- &e%clan_b% &f%kills_b%"
cancelled-not-enough-players: "&cWar cancelled: not enough players confirmed participation."
command-blocked: "&cCommands are blocked during war!"
item-blocked: "&cThat item cannot be used inside the arena."
restore-on-join: "&eYour inventory has been restored from an interrupted war session."
no-arena-available: "&cNo arena is available right now. Try again later."
kit-not-found: "&cThat kit does not exist."
condition-failed: "&cYou don't meet the requirements to start a war."
admin:
arena:
created: "&aArena &e%name% &acreated. Use setpos1/setpos2 to configure it."
deleted: "&aArena &e%name% &adeleted."
not-found: "&cArena &e%name% &cnot found."
already-exists: "&cArena &e%name% &calready exists."
pos-set: "&aSet %pos% for arena &e%arena%&a."
updated: "&aArena &e%arena% &aupdated."
list-empty: "&cNo arenas configured."
kit:
created: "&aKit &e%name% &acreated from your current inventory."
deleted: "&aKit &e%name% &adeleted."
not-found: "&cKit &e%name% &cnot found."
list-empty: "&cNo kits configured."
list-empty: "&cNo active wars."
not-found: "&cNo active war found for that clan."
ended-by-admin: "&aWar ended by admin."kit-selection:
title: "&8Select a Kit &7| &e%clan%"
rows: 3
# Item shown for each kit (one per kit, filled left-to-right starting at slot 0)
kit-item:
material: CHEST
name: "&e%kit%"
lore:
- "&7Click to challenge with this kit."
# "Use own inventory" option
no-kit-item:
slot: 22
material: ENDER_CHEST
name: "&aUse own inventory"
lore:
- "&7No kit will be applied."
- "&7You keep your current items."
# Decorative filler (leave material as AIR to disable)
filler:
material: GRAY_STAINED_GLASS_PANE
name: " "
slots: []
title: "&8Select a Kit &7| &e%clan%"
rows: 3
# Item shown for each kit (one per kit, filled left-to-right starting at slot 0)
kit-item:
material: CHEST
name: "&e%kit%"
lore:
- "&7Click to challenge with this kit."
# "Use own inventory" option
no-kit-item:
slot: 22
material: ENDER_CHEST
name: "&aUse own inventory"
lore:
- "&7No kit will be applied."
- "&7You keep your current items."
# Decorative filler (leave material as AIR to disable)
filler:
material: GRAY_STAINED_GLASS_PANE
name: " "
slots: []
