Content generated with AI — it may contain mistakes.

ExyliaArrows/ReferenceUpdated in v1.7.1

Permissions

Every ExyliaArrows permission, how to sell effects by effect, category or rarity, and how to turn features into rank perks.

Page 12 of 223 min read

Out of the box every player can open /arrows and use every feature, but nobody owns any effect until you give it to them. Admins get /arrowsadmin. The permission prefix is exyliarrows, with one "a".

All permissions#

PermissionWho has itWhat it allows
exyliarrows.command.arrowsEveryoneUse /arrows: open the menu and the subcommands under it. Without it nobody can open the catalogue.
exyliarrows.previewEveryoneWatch an effect on the preview stage, from /arrows preview, the menu's right click and the 3D selector.
exyliarrows.randomEveryonePlay a different effect on every shot.
exyliarrows.favouritesEveryoneStar effects and open the favourites tab.
exyliarrows.visibilityEveryoneChoose whose arrow effects you see.
exyliarrows.buyEveryoneBuy effects in the shop. Without it no price is shown.
exyliarrows.crateEveryoneOpen the crate: its menu button, /arrows crate and a bound crate block.
exyliarrows.crate.multi.<n>Admins (op)Open up to <n> crates in one go instead of `crate.max-at-once` (seven at most). The highest number a player holds wins.
exyliarrows.adminAdmins (op)Use /arrowsadmin and edit the catalogue in game.
exyliarrows.effect.*Admins (op)Own every effect.
exyliarrows.effect.<id>Admins (op)Own one effect. The id is the effect's key in effects.yml, in lowercase.
exyliarrows.category.<id>Admins (op)Own every effect of one category, for example ember.
exyliarrows.tier.<id>Admins (op)Own every effect of one rarity, for example legendary.

The five feature nodes and the crate node are declared in plugin.yml as true, so permission plugins list them. The effect, category and tier nodes are written by you: they do not exist until you type them.

Sell effects#

An effect is owned when any of these is true:

PermissionOwns
exyliarrows.effect.<id>One effect. The id is its key in effects.yml, in lowercase.
exyliarrows.category.<id>Every effect in a category: ember, frost, storm, void, prism or goofy.
exyliarrows.tier.<id>Every effect of a rarity: common, rare, epic or legendary by default.
exyliarrows.effect.*Every effect.

It is also owned if the player won it in the crate or bought it in the shop. Those are saved on the player, not as permissions, so they survive a rank expiring.

With LuckPerms:

/lp group vip   permission set exyliarrows.category.ember true
/lp group mvp   permission set exyliarrows.effect.ember_trail true
/lp group elite permission set exyliarrows.tier.legendary true
/lp group legend permission set exyliarrows.effect.* true

Each category holds twenty effects, so one category node sells twenty effects in one line.

Renaming an effect changes its permission

EMBER_TRAIL in effects.yml is exyliarrows.effect.ember_trail. Capital letters do not matter, but renaming the key creates a different node, and everybody with the old one loses the effect.

Features as rank perks#

Players hold the feature nodes (preview, random, favourites, visibility, buy, crate) by default. To make one a perk, deny it to the default group and grant it to the rank:

/lp group default permission set exyliarrows.random false
/lp group vip     permission set exyliarrows.random true
/lp group vip     permission set exyliarrows.crate.multi.7 true

A player without the permission is told "Your rank does not include that function" (feature-locked in messages.yml). Taking an effect off, turning random off, unstarring and emptying favourites never need a permission.

exyliarrows.crate.multi.<n> lets a rank open up to <n> crates at once instead of crate.max-at-once (4 by default). The highest number a player holds wins, and the opening screen fits seven.

Keep the menu open to everyone

Without exyliarrows.command.arrows a player cannot open the catalogue, and a player who cannot see what is for sale cannot want it.

Where permissions are checked#

  • Choosing in the menu needs the effect, or the player is told they do not have it.
  • At every shot the choice is checked again. One the player no longer qualifies for is taken off right there.
  • behaviour.hide-without-permission (default false) decides whether effects a player does not own are hidden in the menu or shown locked. Locked effects can still be previewed with exyliarrows.preview.
  • Tokens and bound bows never check permissions. A token is an item you can sell or trade, so holding it is the proof. A bound bow plays its effect for whoever holds it.

Something missing on this page? Tell us on Discord