Permissions
Every ExyliaClans permission node, what is open to players by default, how to make a feature a rank perk, and how to set per-rank limits.
Players can use ExyliaClans without any setup: every player command is allowed by default, and what a member may do is decided by their rank inside the clan. Only staff nodes need granting. Use this page to restrict commands, to give staff access and to give ranks bigger limits.
Two systems answer two questions, and both must say yes. A server permission (below) says whether a player may run a command at all. A clan rank permission says whether their rank may do it inside the clan. Granting exyliaclans.commands.kick does not let anyone kick anybody; the command then checks their rank for KICK.
All permissions#
| Permission | Who has it | What it allows |
|---|---|---|
exyliaclans.commands.* | Everyone | Every player-facing clan command at once. |
exyliaclans.commands.clan | Everyone | Open the clan menu with /clan. |
exyliaclans.commands.create | Everyone | Create a clan. |
exyliaclans.commands.join | Everyone | Join a clan. |
exyliaclans.commands.leave | Everyone | Declared, but /clan leave never checks it. |
exyliaclans.commands.disband | Everyone | Declared, but /clan disband never checks it. |
exyliaclans.commands.invite | Everyone | Invite players. |
exyliaclans.commands.kick | Everyone | Kick members. |
exyliaclans.commands.ban | Everyone | Ban players from the clan. |
exyliaclans.commands.unban | Everyone | Lift clan bans. |
exyliaclans.commands.promote | Everyone | Promote members. |
exyliaclans.commands.demote | Everyone | Demote members. |
exyliaclans.commands.transferleader | Everyone | Hand the clan to someone else. |
exyliaclans.commands.deposit | Everyone | Deposit into the clan bank. |
exyliaclans.commands.withdraw | Everyone | Withdraw from the clan bank. |
exyliaclans.commands.bank | Everyone | Open the clan bank menu. |
exyliaclans.commands.ally | Everyone | Send and accept alliance requests (decline and remove need no node). |
exyliaclans.commands.rival | Everyone | Declare rivals (removing needs no node). |
exyliaclans.commands.claim | Everyone | Claim land. |
exyliaclans.commands.reclaim | Everyone | Redraw the claim. |
exyliaclans.commands.unclaim | Everyone | Declared, but /clan unclaim never checks it. |
exyliaclans.commands.map | Everyone | Show nearby claims. |
exyliaclans.commands.sethome | Everyone | Set the clan home. |
exyliaclans.commands.home | Everyone | Teleport to the clan home. |
exyliaclans.commands.chat | Everyone | Clan chat, both forms of /clan chat. |
exyliaclans.commands.ff | Everyone | Toggle friendly fire. |
exyliaclans.commands.open | Everyone | Toggle open or invite-only. |
exyliaclans.commands.info | Everyone | Show clan info. |
exyliaclans.commands.focus | Everyone | Mark an enemy. |
exyliaclans.commands.camp | Everyone | Mark a camp target. |
exyliaclans.commands.rally | Everyone | Drop a rally point (rally clear needs no node). |
exyliaclans.commands.regroup | Everyone | Call and answer a regroup. |
exyliaclans.commands.style | Everyone | Use /clan style; what it may contain depends on the style nodes. |
exyliaclans.commands.roles | Everyone | Create, rename and edit clan roles from the menu. |
exyliaclans.commands.level | Everyone | Open the clan level menu. |
exyliaclans.commands.top | Everyone | Open the leaderboards. |
exyliaclans.commands.mail | Everyone | Use the clan mailbox, all three forms. |
exyliaclans.commands.webhook | Everyone | Manage the Discord webhook (remove needs no node). |
exyliaclans.commands.war | Everyone | Use /clan war (decline and leave need no node). |
exyliaclans.commands.lfc | Everyone | Open /lfc. |
exyliaclans.commands.lfp | Everyone | Open /lfp. |
exyliaclans.style.* | Admins (op) | Every way of colouring a clan name. |
exyliaclans.style.color | Admins (op) | Colour the clan name with one named colour, such as &b or <aqua>. |
exyliaclans.style.hex | Admins (op) | Use hex colours in the clan name. Includes style.color. |
exyliaclans.style.gradient | Admins (op) | Use several colours or a gradient. Includes style.hex. |
exyliaclans.style.format | Admins (op) | Use bold, italic, underlined or strikethrough in the clan name. |
exyliaclans.members.<n> | Nobody until granted | Maximum members of the clan (highest number wins). Replaces settings.max-members. |
exyliaclans.allies.<n> | Nobody until granted | Maximum alliances (highest wins). Replaces settings.max-alliances. |
exyliaclans.rivals.<n> | Nobody until granted | Maximum rivals (highest wins). Replaces settings.max-rivals. |
exyliaclans.claimarea.<n> | Nobody until granted | Largest claim in blocks (highest wins). Replaces claims.max-area. |
exyliaclans.regroupcooldown.<n> | Nobody until granted | Regroup cooldown in seconds (lowest wins). Replaces settings.regroup-cooldown-seconds. |
exyliaclans.createcooldown.<n> | Nobody until granted | Wait between two clans a player creates, in seconds (lowest wins). Replaces settings.create-cooldown-seconds. |
exyliaclans.homewarmup.<n> | Nobody until granted | Warmup before /clan home, in seconds (lowest wins). Replaces settings.home-warmup-seconds. |
exyliaclans.claim.bypass | Admins (op) | Build inside any clan claim under the built-in protection. |
exyliaclans.admin | Admins (op) | Use /clanadmin. Parent of every admin node. |
exyliaclans.admin.addally | Admins (op) | Force an alliance. |
exyliaclans.admin.addrival | Admins (op) | Force a rivalry. |
exyliaclans.admin.ban | Admins (op) | Ban a player from a clan. |
exyliaclans.admin.disband | Admins (op) | Disband any clan. |
exyliaclans.admin.forcejoin | Admins (op) | Put a player into a clan. |
exyliaclans.admin.forcekick | Admins (op) | Remove a player from their clan. |
exyliaclans.admin.forceleader | Admins (op) | Make a player a clan's leader. |
exyliaclans.admin.info | Admins (op) | See a clan's full info. |
exyliaclans.admin.logs | Admins (op) | Read a clan's audit log. |
exyliaclans.admin.reload | Admins (op) | Reload config and menus. |
exyliaclans.admin.removeally | Admins (op) | Break an alliance. |
exyliaclans.admin.removerival | Admins (op) | Remove a rivalry. |
exyliaclans.admin.rename | Admins (op) | Rename a clan. |
exyliaclans.admin.style | Admins (op) | Colour or uncolour a clan's name. |
exyliaclans.admin.setbalance | Admins (op) | Change a clan's bank. |
exyliaclans.admin.setdtr | Admins (op) | Change a clan's DTR. |
exyliaclans.admin.setexp | Admins (op) | Change a clan's EXP. |
exyliaclans.admin.setlevel | Admins (op) | Change a clan's level. |
exyliaclans.admin.setslots | Admins (op) | Give a clan extra member slots. |
exyliaclans.admin.stats | Admins (op) | Edit player and clan stats. |
exyliaclans.admin.unban | Admins (op) | Lift a clan ban. |
exyliaclans.admin.war | Admins (op) | Set up war arenas and kits, and stop wars. |
Make a command a rank perk#
Each command node also guards the menu buttons that do the same thing. To make a feature a perk, deny the node to the default group and grant it to the rank. With LuckPerms:
/lp group default permission set exyliaclans.commands.webhook false
/lp group vip permission set exyliaclans.commands.webhook trueLeaving, declining, cancelling and removing are never gated: /clan leave, disband, unclaim, ally decline, ally remove, rival remove, rally clear, style reset, webhook remove, war decline and war leave always work.
The nodes exyliaclans.commands.roles, level and bank guard menu screens only; there is no /clan roles command.
Style nodes#
These decide what a clan leader may use in /clan style. Unlike the command nodes they default to op: a leader can run the command but cannot colour anything until a rank gets one of these.
| Node | Allows |
|---|---|
exyliaclans.style.color | One named colour, such as &b or <aqua> |
exyliaclans.style.hex | Hex colours (includes style.color) |
exyliaclans.style.gradient | Several colours or a gradient (includes style.hex) |
exyliaclans.style.format | Bold, italic, underlined, strikethrough |
exyliaclans.style.* grants all four. Obfuscated text, clicks, hovers and placeholders are always refused.
Per-rank numbers#
Seven limits change per rank when you grant a node that ends in a number. They are not declared one by one: grant the exact number you want, for example exyliaclans.members.50.
/lp group vip permission set exyliaclans.members.50 true
/lp group vip permission set exyliaclans.claimarea.20000 true| Node | Replaces in config.yml | Which number wins | Read from |
|---|---|---|---|
exyliaclans.members.<n> | settings.max-members | highest | the clan leader |
exyliaclans.allies.<n> | settings.max-alliances | highest | the clan leader |
exyliaclans.rivals.<n> | settings.max-rivals | highest | the clan leader |
exyliaclans.claimarea.<n> | claims.max-area | highest | the clan leader |
exyliaclans.regroupcooldown.<n> | settings.regroup-cooldown-seconds | lowest | the clan leader |
exyliaclans.createcooldown.<n> | settings.create-cooldown-seconds | lowest | the player creating |
exyliaclans.homewarmup.<n> | settings.home-warmup-seconds | lowest | the player teleporting |
The first five apply to the whole clan and are read from the leader at the moment the limit is checked. While the leader is offline, the value in config.yml applies. Level bonuses and extra slots from /clanadmin setslots still add on top.
Staff setup#
exyliaclans.admin is the parent of every admin node: granting it alone gives all of /clanadmin. For a narrower rank, grant it and set the subcommands that rank must not have to false:
/lp group helper permission set exyliaclans.admin true
/lp group helper permission set exyliaclans.admin.disband false
/lp group helper permission set exyliaclans.admin.setbalance false
/lp group helper permission set exyliaclans.admin.reload falseThat helper keeps info, logs and the rest.
setbalance, setexp and setlevel hand out progression, and stats rewrites the leaderboards. Give them to whoever you trust with the economy, which is not always whoever handles reports.
It lets a player build, break and open things in anybody's claim under the built-in protection. It is not included in exyliaclans.commands.*. It does not get past WorldGuard: with protection-mode: WORLDGUARD the region refuses the build, and you need a WorldGuard bypass.
Something missing on this page? Tell us on Discord