Permissions
Every ExyliaArrows permission, how to sell effects by effect, category or rarity, and how to turn features into rank perks.
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#
| Permission | Who has it | What it allows |
|---|---|---|
exyliarrows.command.arrows | Everyone | Use /arrows: open the menu and the subcommands under it. Without it nobody can open the catalogue. |
exyliarrows.preview | Everyone | Watch an effect on the preview stage, from /arrows preview, the menu's right click and the 3D selector. |
exyliarrows.random | Everyone | Play a different effect on every shot. |
exyliarrows.favourites | Everyone | Star effects and open the favourites tab. |
exyliarrows.visibility | Everyone | Choose whose arrow effects you see. |
exyliarrows.buy | Everyone | Buy effects in the shop. Without it no price is shown. |
exyliarrows.crate | Everyone | Open 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.admin | Admins (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:
| Permission | Owns |
|---|---|
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.* trueEach category holds twenty effects, so one category node sells twenty effects in one line.
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 trueA 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.
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(defaultfalse) decides whether effects a player does not own are hidden in the menu or shown locked. Locked effects can still be previewed withexyliarrows.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