Commands
Every ExyliaArrows command: what players type to wear an effect and what admins type to give, bind and set things up.
Players use /arrows; admins use /arrowsadmin. Typing /arrowsadmin alone opens the admin hub, a menu with the catalogue, players, showcases and crate blocks. Every subcommand below is a shortcut to something the hub can also do.
A command in <angle brackets> is required, one in [square brackets] is optional. To let a rank use a command, see Permissions.
Player commands#
Everything under /arrows needs exyliarrows.command.arrows, which everyone has by default. Preview, crate, random, favourites and visibility also check their own feature permission.
| Command | What it does | Permission |
|---|---|---|
/arrows | Open the effects menu: the classic one or the 3D selector, whichever `menu.style` picks. | exyliarrows.command.arrows |
/arrows 3d | Open the 3D selector, whatever `menu.style` says. | exyliarrows.command.arrows |
/arrows preview <effect> | Play an effect on the preview stage. You do not need to own it. | exyliarrows.preview |
/arrows crate | Open the crate. | exyliarrows.crate |
/arrows random | Play a different effect from the ones you own on every shot. Run it again to stop. | exyliarrows.random |
/arrows visibility [mode] | Choose whose arrow effects you see: all, none, only yours or only other players'. With no mode it moves to the next one. | exyliarrows.visibility |
/arrows favourites | Open the menu on your favourites tab. | exyliarrows.command.arrows |
/arrows favourite <effect> | Star an effect, or unstar it if it is already starred. | exyliarrows.favourites |
/arrows favourites clear | Empty your favourites. | exyliarrows.command.arrows |
/arrows clear | Take your effect off, including a rank default. Nothing plays until you pick again. | exyliarrows.command.arrows |
Admin commands#
player clear, crate block clear and showcase clear only say what they would delete until you run them again with confirm at the end.
Tokens and keys as items#
| Command | What it does | Permission |
|---|---|---|
/arrowsadmin item give <player> <effect> [amount] | Give effect tokens (1 to 64, default 1). | exyliarrows.admin |
/arrowsadmin item remover <player> [amount] | Give removers (1 to 64, default 1). | exyliarrows.admin |
/arrowsadmin item key <player> [amount] | Give crate keys as items (1 to 64, default 1). | exyliarrows.admin |
If the items do not fit in the player's inventory they are kept and handed over on the player's next join. Nothing is dropped on the floor.
Bows#
| Command | What it does | Permission |
|---|---|---|
/arrowsadmin bow bind <effect> [player] | Bind an effect to the bow in hand, replacing what it carried. Ignores ownership. | exyliarrows.admin |
/arrowsadmin bow unbind [player] | Strip the effect from the bow in hand. Nothing is given back. | exyliarrows.admin |
Players#
| Command | What it does | Permission |
|---|---|---|
/arrowsadmin player set <player> <effect> | Set the effect a player wears. Works on offline players. | exyliarrows.admin |
/arrowsadmin player clear <player> [confirm] | Take back the player's own choice so their rank default plays again. Add `confirm` to run it. | exyliarrows.admin |
/arrowsadmin player favourites clear <player> | Empty a player's favourites. | exyliarrows.admin |
/arrowsadmin player validate [player] | Take off an effect the player may no longer use. With no player, everyone online. | exyliarrows.admin |
player set, player clear and player favourites clear also work on players who are offline.
Keys and unlocks#
| Command | What it does | Permission |
|---|---|---|
/arrowsadmin keys give <player> [amount] | Add crate keys to a player (1 to 10000, default 1). | exyliarrows.admin |
/arrowsadmin keys take <player> [amount] | Take keys away, never below zero (1 to 10000, default 1). | exyliarrows.admin |
/arrowsadmin keys set <player> <amount> | Set the number of keys (0 to 100000). | exyliarrows.admin |
/arrowsadmin keys check <player> | Show how many keys a player holds. | exyliarrows.admin |
| Command | What it does | Permission |
|---|---|---|
/arrowsadmin unlocks grant <player> <effect> | Mark an effect as unlocked for a player, without a crate. | exyliarrows.admin |
/arrowsadmin unlocks revoke <player> <effect> | Take an unlocked effect back. | exyliarrows.admin |
Keys are a number stored on the player, so they cannot be dropped or lost, and these commands run from the console. That is how a shop, a vote plugin or a rank reward hands them out. To reset everything a player owns, use ExyliaLib's /exylialib resetplayer.
Crate blocks and showcases#
| Command | What it does | Permission |
|---|---|---|
/arrowsadmin crate block add | Start the wizard that binds the block you look at as a crate. | exyliarrows.admin |
/arrowsadmin crate block remove | Unbind the crate block you look at. | exyliarrows.admin |
/arrowsadmin crate block list | List every bound crate block. | exyliarrows.admin |
/arrowsadmin crate block clear [confirm] | Unbind every crate block. Add `confirm` to run it. | exyliarrows.admin |
| Command | What it does | Permission |
|---|---|---|
/arrowsadmin showcase add | Start the wizard that places a showcase where you stand. | exyliarrows.admin |
/arrowsadmin showcase remove | Remove the showcase nearest to you. | exyliarrows.admin |
/arrowsadmin showcase list | List every showcase. | exyliarrows.admin |
/arrowsadmin showcase clear [confirm] | Remove every showcase. Add `confirm` to run it. | exyliarrows.admin |
crate block add and showcase add open a short setup wizard in chat. See Set up the crate and the shop and Configuration.
Menus, 3D selector and preview#
| Command | What it does | Permission |
|---|---|---|
/arrowsadmin menu open <player> | Open the effects menu for a player. | exyliarrows.admin |
/arrowsadmin menu crate <player> | Open the crate for a player. | exyliarrows.admin |
| Command | What it does | Permission |
|---|---|---|
/arrowsadmin spatial place | Start the wizard that places a fixed 3D selector where you stand. | exyliarrows.admin |
/arrowsadmin spatial remove | Remove the fixed 3D selector nearest to you. | exyliarrows.admin |
/arrowsadmin spatial edit | Open the 3D selector in edit mode to move its pieces. | exyliarrows.admin |
/arrowsadmin spatial tour <player> | Show the 3D selector's guided tour to a player again. | exyliarrows.admin |
| Command | What it does | Permission |
|---|---|---|
/arrowsadmin preview play <effect> [player] | Play an effect on the preview stage for yourself or another player. | exyliarrows.admin |
/arrowsadmin preview location | Start the wizard that sets the preview stage where you stand. | exyliarrows.admin |
Catalogue and maintenance#
| Command | What it does | Permission |
|---|---|---|
/arrowsadmin list [category] | List every effect, or only one category's. | exyliarrows.admin |
/arrowsadmin refresh [player] | Redraw what a player holds so a stale bow line updates. With no player, everyone online. | exyliarrows.admin |
/arrowsadmin reload | Re-read this plugin's files. Does not reload ExyliaLib. | exyliarrows.admin |
These are admin commands: a crate, a rank reward or a support ticket has already decided the player may have the effect. Permissions only decide what a player picks from the menu.
What each command does exactly
bow bind works on the main hand of the target. With an empty hand the plugin answers that you must hold the bow. A bow that already has an effect gets it replaced, and the old one is not returned as a token. A bow the effect does not fit (see bows in Add and edit effects) is refused.
bow unbind strips the effect and gives nothing back. To give the token back, use a remover item instead.
player validate re-checks the player's choice against their permissions and takes it off if they no longer qualify. The same check runs on join, on the next shot and every time the menu opens. Use it to make a rank change take effect at once. An effect won from the crate or bought in the shop is never taken off by it.
preview location sets the one stage the whole server shares. Only the position is stored, and a preview always faces north. Until it is set, /arrows preview and the menu's right click tell the player previews are not set up.
refresh re-sends the inventory so the line under a bound bow is redrawn. It touches no file.
reload re-reads config.yml, effects.yml, messages.yml, the files in menus/ and spatial/effects.yml, and recompiles every sequence. It does not reload ExyliaLib; that is /exylialib reload. If you renamed an effect key, that is a new effect: players wearing the old one lose it and bows bound to it stop playing.
Something missing on this page? Tell us on Discord