Content generated with AI — it may contain mistakes.

ExyliaClans/ReferenceUpdated in v1.4.0

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.

Page 17 of 293 min read

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#

PermissionWho has itWhat it allows
exyliaclans.commands.*EveryoneEvery player-facing clan command at once.
exyliaclans.commands.clanEveryoneOpen the clan menu with /clan.
exyliaclans.commands.createEveryoneCreate a clan.
exyliaclans.commands.joinEveryoneJoin a clan.
exyliaclans.commands.leaveEveryoneDeclared, but /clan leave never checks it.
exyliaclans.commands.disbandEveryoneDeclared, but /clan disband never checks it.
exyliaclans.commands.inviteEveryoneInvite players.
exyliaclans.commands.kickEveryoneKick members.
exyliaclans.commands.banEveryoneBan players from the clan.
exyliaclans.commands.unbanEveryoneLift clan bans.
exyliaclans.commands.promoteEveryonePromote members.
exyliaclans.commands.demoteEveryoneDemote members.
exyliaclans.commands.transferleaderEveryoneHand the clan to someone else.
exyliaclans.commands.depositEveryoneDeposit into the clan bank.
exyliaclans.commands.withdrawEveryoneWithdraw from the clan bank.
exyliaclans.commands.bankEveryoneOpen the clan bank menu.
exyliaclans.commands.allyEveryoneSend and accept alliance requests (decline and remove need no node).
exyliaclans.commands.rivalEveryoneDeclare rivals (removing needs no node).
exyliaclans.commands.claimEveryoneClaim land.
exyliaclans.commands.reclaimEveryoneRedraw the claim.
exyliaclans.commands.unclaimEveryoneDeclared, but /clan unclaim never checks it.
exyliaclans.commands.mapEveryoneShow nearby claims.
exyliaclans.commands.sethomeEveryoneSet the clan home.
exyliaclans.commands.homeEveryoneTeleport to the clan home.
exyliaclans.commands.chatEveryoneClan chat, both forms of /clan chat.
exyliaclans.commands.ffEveryoneToggle friendly fire.
exyliaclans.commands.openEveryoneToggle open or invite-only.
exyliaclans.commands.infoEveryoneShow clan info.
exyliaclans.commands.focusEveryoneMark an enemy.
exyliaclans.commands.campEveryoneMark a camp target.
exyliaclans.commands.rallyEveryoneDrop a rally point (rally clear needs no node).
exyliaclans.commands.regroupEveryoneCall and answer a regroup.
exyliaclans.commands.styleEveryoneUse /clan style; what it may contain depends on the style nodes.
exyliaclans.commands.rolesEveryoneCreate, rename and edit clan roles from the menu.
exyliaclans.commands.levelEveryoneOpen the clan level menu.
exyliaclans.commands.topEveryoneOpen the leaderboards.
exyliaclans.commands.mailEveryoneUse the clan mailbox, all three forms.
exyliaclans.commands.webhookEveryoneManage the Discord webhook (remove needs no node).
exyliaclans.commands.warEveryoneUse /clan war (decline and leave need no node).
exyliaclans.commands.lfcEveryoneOpen /lfc.
exyliaclans.commands.lfpEveryoneOpen /lfp.
exyliaclans.style.*Admins (op)Every way of colouring a clan name.
exyliaclans.style.colorAdmins (op)Colour the clan name with one named colour, such as &b or <aqua>.
exyliaclans.style.hexAdmins (op)Use hex colours in the clan name. Includes style.color.
exyliaclans.style.gradientAdmins (op)Use several colours or a gradient. Includes style.hex.
exyliaclans.style.formatAdmins (op)Use bold, italic, underlined or strikethrough in the clan name.
exyliaclans.members.<n>Nobody until grantedMaximum members of the clan (highest number wins). Replaces settings.max-members.
exyliaclans.allies.<n>Nobody until grantedMaximum alliances (highest wins). Replaces settings.max-alliances.
exyliaclans.rivals.<n>Nobody until grantedMaximum rivals (highest wins). Replaces settings.max-rivals.
exyliaclans.claimarea.<n>Nobody until grantedLargest claim in blocks (highest wins). Replaces claims.max-area.
exyliaclans.regroupcooldown.<n>Nobody until grantedRegroup cooldown in seconds (lowest wins). Replaces settings.regroup-cooldown-seconds.
exyliaclans.createcooldown.<n>Nobody until grantedWait between two clans a player creates, in seconds (lowest wins). Replaces settings.create-cooldown-seconds.
exyliaclans.homewarmup.<n>Nobody until grantedWarmup before /clan home, in seconds (lowest wins). Replaces settings.home-warmup-seconds.
exyliaclans.claim.bypassAdmins (op)Build inside any clan claim under the built-in protection.
exyliaclans.adminAdmins (op)Use /clanadmin. Parent of every admin node.
exyliaclans.admin.addallyAdmins (op)Force an alliance.
exyliaclans.admin.addrivalAdmins (op)Force a rivalry.
exyliaclans.admin.banAdmins (op)Ban a player from a clan.
exyliaclans.admin.disbandAdmins (op)Disband any clan.
exyliaclans.admin.forcejoinAdmins (op)Put a player into a clan.
exyliaclans.admin.forcekickAdmins (op)Remove a player from their clan.
exyliaclans.admin.forceleaderAdmins (op)Make a player a clan's leader.
exyliaclans.admin.infoAdmins (op)See a clan's full info.
exyliaclans.admin.logsAdmins (op)Read a clan's audit log.
exyliaclans.admin.reloadAdmins (op)Reload config and menus.
exyliaclans.admin.removeallyAdmins (op)Break an alliance.
exyliaclans.admin.removerivalAdmins (op)Remove a rivalry.
exyliaclans.admin.renameAdmins (op)Rename a clan.
exyliaclans.admin.styleAdmins (op)Colour or uncolour a clan's name.
exyliaclans.admin.setbalanceAdmins (op)Change a clan's bank.
exyliaclans.admin.setdtrAdmins (op)Change a clan's DTR.
exyliaclans.admin.setexpAdmins (op)Change a clan's EXP.
exyliaclans.admin.setlevelAdmins (op)Change a clan's level.
exyliaclans.admin.setslotsAdmins (op)Give a clan extra member slots.
exyliaclans.admin.statsAdmins (op)Edit player and clan stats.
exyliaclans.admin.unbanAdmins (op)Lift a clan ban.
exyliaclans.admin.warAdmins (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 true

Leaving, 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.

NodeAllows
exyliaclans.style.colorOne named colour, such as &b or <aqua>
exyliaclans.style.hexHex colours (includes style.color)
exyliaclans.style.gradientSeveral colours or a gradient (includes style.hex)
exyliaclans.style.formatBold, 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
NodeReplaces in config.ymlWhich number winsRead from
exyliaclans.members.<n>settings.max-membershighestthe clan leader
exyliaclans.allies.<n>settings.max-allianceshighestthe clan leader
exyliaclans.rivals.<n>settings.max-rivalshighestthe clan leader
exyliaclans.claimarea.<n>claims.max-areahighestthe clan leader
exyliaclans.regroupcooldown.<n>settings.regroup-cooldown-secondslowestthe clan leader
exyliaclans.createcooldown.<n>settings.create-cooldown-secondslowestthe player creating
exyliaclans.homewarmup.<n>settings.home-warmup-secondslowestthe 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 false

That helper keeps info, logs and the rest.

Keep economy and moderation apart

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.

Staff only: exyliaclans.claim.bypass

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