Commands
Every ExyliaClans command: /clan, /clanadmin, /lfc and /lfp, with the permission each one needs and the rank permission it checks inside the clan.
ExyliaClans has four commands: /clan for players, /clanadmin for staff, and /lfc and /lfp to find a clan or members. Most things you can type are also buttons in the /clan menu.
Two checks decide whether a command works. The server permission (a permission node from LuckPerms) says the player may run it at all. The clan's own rank permission says whether their rank may do it inside the clan. Both must pass. Every player node is true by default, so out of the box the rank decides.
Commands that leave, decline, cancel or remove never need a node, so nobody gets stuck in something they cannot undo. They are marked below.
Basics#
| Command | What it does | Permission |
|---|---|---|
/clan | Open the clan menu. It shows a different menu if you are in a clan or not. | exyliaclans.commands.clan |
/clan create <name> | Create a clan. You become its leader. | exyliaclans.commands.create |
/clan info | Show your clan's info screen. | exyliaclans.commands.info |
/clan info <clan> | Show another clan's info screen (a player name works too). | exyliaclans.commands.info |
/clan top | Open the clan leaderboards. | exyliaclans.commands.top |
/clan join <clan> | Join an open clan, or one that invited you. | exyliaclans.commands.join |
/clan leave | Leave your clan after a confirmation. The leader cannot leave: transfer or disband first. Needs no permission. | — |
/clan disband | Disband your clan after a confirmation. Leader only. Needs no permission. | — |
Clan settings#
| Command | What it does | Permission |
|---|---|---|
/clan open | Switch the clan between open (anyone can join) and invite-only. | exyliaclans.commands.open |
/clan ff | Switch friendly fire between clan members on or off. | exyliaclans.commands.ff |
/clan style | Show how to colour the clan name and the text it has to match. Leader only. | exyliaclans.commands.style |
/clan style <styled name> | Colour how the clan name is drawn. The text must read exactly as the name. Needs a style node. | exyliaclans.commands.style |
/clan style reset | Go back to the plain name. Leader only. Needs no permission. | — |
/clan webhook | Open the Discord webhook menu. | exyliaclans.commands.webhook |
/clan webhook set | Set the clan's Discord webhook URL; the plugin asks for it privately. | exyliaclans.commands.webhook |
/clan webhook test | Send a test message to the webhook. | exyliaclans.commands.webhook |
/clan webhook remove | Remove the webhook after a confirmation. Needs no permission. | — |
Members#
| Command | What it does | Permission |
|---|---|---|
/clan invite <player> | Invite a player to the clan. | exyliaclans.commands.invite |
/clan kick <player> | Remove a member from the clan. | exyliaclans.commands.kick |
/clan ban <player> | Ban a player from the clan so they cannot join again. | exyliaclans.commands.ban |
/clan unban <player> | Lift a clan ban. | exyliaclans.commands.unban |
/clan promote <player> | Open the assign-rank menu for a member, to give a heavier rank. | exyliaclans.commands.promote |
/clan demote <player> | Open the assign-rank menu for a member, to give a lighter rank. | exyliaclans.commands.demote |
/clan transferleader <player> | Hand the clan to another member. Leader only. | exyliaclans.commands.transferleader |
Bank#
| Command | What it does | Permission |
|---|---|---|
/clan deposit <amount> | Put money from your balance into the clan bank. Needs the bank module. | exyliaclans.commands.deposit |
/clan withdraw <amount> | Take money out of the clan bank. Needs the bank module. | exyliaclans.commands.withdraw |
Land and home#
| Command | What it does | Permission |
|---|---|---|
/clan claim | Start a claim session with the golden hoe. Run it again to cancel. Needs the claims module. | exyliaclans.commands.claim |
/clan reclaim | Redraw the clan's claim inside its current bounds. | exyliaclans.commands.reclaim |
/clan unclaim | Give up the clan's land. This also clears the clan home. Needs no permission. | — |
/clan map | Show the claims around you. | exyliaclans.commands.map |
/clan sethome | Set the clan home where you stand. With claims on, it must be inside your claim. | exyliaclans.commands.sethome |
/clan home | Teleport to the clan home after a short warmup. | exyliaclans.commands.home |
Allies and rivals#
| Command | What it does | Permission |
|---|---|---|
/clan ally add <clan> | Send an alliance request. Needs the allies module. | exyliaclans.commands.ally |
/clan ally accept <clan> | Accept an alliance request. | exyliaclans.commands.ally |
/clan ally decline <clan> | Decline an alliance request. Needs no permission. | — |
/clan ally remove <clan> | Break an alliance. Needs no permission. | — |
/clan rival add <clan> | Declare a clan as a rival. Needs the rivals module. | exyliaclans.commands.rival |
/clan rival remove <clan> | Remove a rival. Needs no permission. | — |
Chat and mail#
| Command | What it does | Permission |
|---|---|---|
/clan chat | Switch your chat to clan chat and back. | exyliaclans.commands.chat |
/clan chat <message> | Send one message to the clan. | exyliaclans.commands.chat |
/clan mail | Open the clan mailbox. Needs the mail module. | exyliaclans.commands.mail |
/clan mail send <member> <message> | Send a mail to one member. | exyliaclans.commands.mail |
/clan mail sendclan <message> | Send a mail to the whole clan. | exyliaclans.commands.mail |
Teamplay#
| Command | What it does | Permission |
|---|---|---|
/clan focus [player] | Mark an enemy so the whole clan sees them. No name clears the mark. | exyliaclans.commands.focus |
/clan camp <clan> | Mark a rival clan's base as a camp target for your clan. | exyliaclans.commands.camp |
/clan rally | Drop a rally point where you stand. | exyliaclans.commands.rally |
/clan rally clear | Remove the rally point. Needs no permission. | — |
/clan regroup | Call every member to your position. Needs the regroup module. | exyliaclans.commands.regroup |
/clan regroup join | Answer a regroup call and teleport to it. | exyliaclans.commands.regroup |
Clan wars#
| Command | What it does | Permission |
|---|---|---|
/clan war | Open the clan war hub. Needs the wars module. | exyliaclans.commands.war |
/clan war declare <clan> | Challenge a clan to a war and open the setup screen. | exyliaclans.commands.war |
/clan war accept <clan> | Accept a war request and open the roster screen. | exyliaclans.commands.war |
/clan war decline <clan> | Decline a war request. Needs no permission. | — |
/clan war spectate <clan> | Watch a war that a clan is fighting. | exyliaclans.commands.war |
/clan war leave | Leave the war you are in or watching. Needs no permission. | — |
Finding a clan or players#
| Command | What it does | Permission |
|---|---|---|
/lfc | Open the looking-for-clan board, where players advertise themselves. Needs the lfc module. | exyliaclans.commands.lfc |
/lfp | Open the looking-for-players board, where clans advertise. Needs the lfp module. | exyliaclans.commands.lfp |
/clanadmin#
Staff need exyliaclans.admin and the node of the subcommand they run. /clanadmin also works from the console, except where it needs an online player (forcejoin).
| Command | What it does | Permission |
|---|---|---|
/clanadmin | In game, open the list of every clan. From the console, show the usage. | exyliaclans.admin |
/clanadmin info <clan> | Open the clan's admin hub, or print its info from the console. | exyliaclans.admin.info |
/clanadmin forcekick <player> | Remove a player from their clan. Disbands the clan if it was the last member. | exyliaclans.admin.forcekick |
/clanadmin forcejoin <player> <clan> | Put an online player into a clan. | exyliaclans.admin.forcejoin |
/clanadmin forceleader <player> <clan> | Make a player the leader of a clan. | exyliaclans.admin.forceleader |
/clanadmin disband <clan> [confirm] | Disband a clan. In game it asks for confirmation; from the console add confirm. | exyliaclans.admin.disband |
/clanadmin rename <clan> <newName> | Rename a clan, under the same name rules as /clan create. | exyliaclans.admin.rename |
/clanadmin style <clan> <styled name> | Colour a clan's name. Staff do not need the style nodes. | exyliaclans.admin.style |
/clanadmin unstyle <clan> | Remove a clan's name colours. | exyliaclans.admin.style |
/clanadmin setbalance <clan> <SET|ADD|REMOVE> <amount> | Change a clan's bank. Never goes below zero. | exyliaclans.admin.setbalance |
/clanadmin setdtr <clan> <SET|ADD|REMOVE> <value> | Change a clan's DTR. Capped at its maximum; also clears the freeze. | exyliaclans.admin.setdtr |
/clanadmin setexp <clan> <SET|ADD|REMOVE> <value> | Change a clan's EXP. | exyliaclans.admin.setexp |
/clanadmin setlevel <clan> <level> | Put a clan on a level of the level table. Needs the levels module. | exyliaclans.admin.setlevel |
/clanadmin setslots <clan> <SET|ADD|REMOVE> <amount> | Give a clan extra member slots on top of its cap. | exyliaclans.admin.setslots |
/clanadmin playerstat <player> <KILLS|DEATHS|PLAYTIME> <SET|ADD|REMOVE> <value> | Change one of a player's stats. Playtime is in seconds. | exyliaclans.admin.stats |
/clanadmin clanstat <clan> <KILLS|DEATHS|PLAYTIME> <SET|ADD|REMOVE> <value> | Change one of a clan's stats. Playtime is in seconds. | exyliaclans.admin.stats |
/clanadmin addally <clanA> <clanB> | Force an alliance between two clans. | exyliaclans.admin.addally |
/clanadmin removeally <clanA> <clanB> | Break an alliance between two clans. | exyliaclans.admin.removeally |
/clanadmin addrival <clanA> <clanB> | Force a rivalry between two clans. | exyliaclans.admin.addrival |
/clanadmin removerival <clanA> <clanB> | Remove a rivalry between two clans. | exyliaclans.admin.removerival |
/clanadmin ban <player> <clan> | Ban a player from a clan. | exyliaclans.admin.ban |
/clanadmin unban <player> <clan> | Lift that ban. | exyliaclans.admin.unban |
/clanadmin logs <clan> [amount] | Show a clan's audit log, 20 entries by default. Needs the logs module. | exyliaclans.admin.logs |
/clanadmin reload | Reload the config files, the language files and every menu. | exyliaclans.admin.reload |
War arenas and kits#
Set these up once with /clanadmin war .... They need exyliaclans.admin.war. See Clan wars.
| Command | What it does | Permission |
|---|---|---|
/clanadmin war arena create <id> | Create a war arena. | exyliaclans.admin.war |
/clanadmin war arena delete <id> | Delete a war arena. | exyliaclans.admin.war |
/clanadmin war arena setspawn <id> <A|B> | Set the spawn of team A or B where you stand. | exyliaclans.admin.war |
/clanadmin war arena setspectator <id> | Set where spectators appear. | exyliaclans.admin.war |
/clanadmin war arena setbounds <id> | Set the arena area. | exyliaclans.admin.war |
/clanadmin war arena saveschematic <id> | Save the arena so it can be reset after every war. | exyliaclans.admin.war |
/clanadmin war arena toggle <id> | Turn an arena on or off. | exyliaclans.admin.war |
/clanadmin war arena tp <id> | Teleport to an arena. | exyliaclans.admin.war |
/clanadmin war arena info <id> | Show an arena's settings. | exyliaclans.admin.war |
/clanadmin war arena list | List every arena. | exyliaclans.admin.war |
/clanadmin war kit create <id> | Create a war kit from your inventory. | exyliaclans.admin.war |
/clanadmin war kit edit <id> | Replace a kit's items with your inventory. | exyliaclans.admin.war |
/clanadmin war kit icon <id> | Use the item in your hand as the kit's icon. | exyliaclans.admin.war |
/clanadmin war kit delete <id> | Delete a war kit. | exyliaclans.admin.war |
/clanadmin war kit list | List every kit. | exyliaclans.admin.war |
/clanadmin war stop <clan> | Stop the war a clan is fighting. | exyliaclans.admin.war |
Rank permission checked by each /clan command
| Command | Rank permission |
|---|---|
invite | INVITE |
kick | KICK |
ban, unban | BAN |
promote, demote | PROMOTE, DEMOTE |
deposit, withdraw | DEPOSIT_BANK, WITHDRAW_BANK |
ally add, ally accept, ally remove | SEND_ALLIANCE_REQUEST, ACCEPT_ALLIANCE, REMOVE_ALLY |
rival add, rival remove | MANAGE_RIVALS |
claim, reclaim, unclaim | CLAIM_LAND, UNCLAIM_LAND |
sethome | SET_HOME |
ff, open | TOGGLE_FRIENDLY_FIRE, TOGGLE_OPEN |
focus, camp, rally, regroup | FOCUS, CAMP, RALLY, REGROUP |
mail sendclan | SEND_CLAN_MAIL |
webhook | MANAGE_WEBHOOK |
war declare, accept, decline | MANAGE_WARS |
disband, transferleader, style | leader only |
The leader passes every rank check. Commands that need a module do nothing when the module is off in config.yml; see Modules.
/clan style#
/clan style lets the leader draw the clan name in colour. The name players type does not change: the styled text must read exactly as the name, ignoring case. A clan called Nova can be styled <gradient:#8a51c4:#59a4ff>Nova</gradient> or &b&lNOVA, never Nova!.
What the leader may use depends on the style nodes, which are op by default. Obfuscated text, clicks, hovers and placeholders are always refused, and the style is capped at 512 characters. /clan style reset goes back to the plain name.
Anti-spam waits#
| Action | Wait | Setting |
|---|---|---|
/clan create | Between two clans one player creates | settings.create-cooldown-seconds, 120 |
/clan invite | Before inviting the same player again | settings.invite-cooldown-seconds, 60 |
/clan mail send and sendclan | Between two mails | mail.send-cooldown-seconds, 30 |
Set a wait to 0 to turn it off. Ranks can get a shorter wait with the number permissions.
Reload#
/clanadmin reload re-reads config.yml, wars.yml and the language files, starts or stops modules, and recompiles every menu. No restart is needed. /clanadmin disband <clan> confirm is the console form of disband.
Wiping the plugin's data or resetting one player is done with ExyliaLib's /exylialib wipe and /exylialib resetplayer, see ExyliaLib commands.
Something missing on this page? Tell us on Discord