Frequently asked questions

Nothing plays when a player shoots

In order:

1. Is the projectile allowed? projectiles.all-types is true by default; with it off, only the types in projectiles.default-allowed-types — or the ones the effect names — carry anything.
2. Is there an effect at all? In mode: bow the menu choice is never read, and in mode: player a bound bow is never read.
3. Do they own it? A menu choice they no longer have the node for is taken off instead of played.
4. Is anyone set to see it? A player on NONE sees nothing, including their own.
5. Is the trail ceiling full? Past trail.max-active a shot still plays its launch and impact and simply leaves no trail.

The menu says it is off

behaviour.mode is bow. On that server the menu would change nothing, so it refuses to open rather than pretending.

An effect I bound to a bow vanished

The bow carries an id. If the key in effects.yml was renamed, that id names nothing any more and the effect does not play. Renaming a key is not free: it is also a different permission node.

A player says their effect disappeared

Their permission for it went away — a rank expiring, usually. A choice that can no longer be justified is taken off rather than played. The node comes back, they pick it again.

Does losing a permission break a bow?

No. A bound bow plays its effect for whoever holds it: the node is asked for when the token is bound, not on every kill. That is what makes a bound bow worth trading.

Can players see each other's effects?

That is each observer's own choice: ALL, NONE, SELF_ONLY or OTHERS_ONLY, set with /arrows visibility or from the menu.

Are the bodies real entities?

No. [NPC] draws a display: nothing can hit it, loot it or collide with it, and it disappears when its life runs out.

Does the bow lore get written to the item?

Never. It is added to the copy that leaves the server. Any plugin reading that bow finds the lore it always had, and renaming an effect updates every bow on the server at once.

Can I write my own effects?

Yes — that is what effects.yml is for. Twenty-five shapes, thirteen other tokens and the display parameters are in Sequences. A line that cannot be read is reported on the console and skipped; the rest of the effect still plays.

Effects lag during big fights

Displays are animated by the client, so they are cheap to move — but every line is still a packet per viewer. Look at how many lines an effect has and at count: on any particle lines. ticks: spreads a shape over frames instead of sending it all at once.

Can a region turn effects off?

Yes. ExyliaLib registers a WorldGuard flag, arrows-effects: denying it in a region stops launch, trail and impact effects inside it. On a server without WorldGuard the flag simply allows.

Why is my trail missing but the impact fine?

Either the region flag above, or trail.max-active — a full lobby firing crossbows hits the ceiling, and losing a trail is far less visible than losing the tick rate. A trail also stops after trail.max-duration seconds, which is what keeps an arrow lost in an unloaded chunk from drawing forever.

Previews say they are unavailable

No preview stage is set yet. Stand where previews should play and run /arrowsadmin preview location. There is no default on purpose: a guessed one puts the player inside terrain.

A rank ran out — did they lose what the crate gave them?

No. An effect won from a crate is written onto the player's own row rather than granted as a permission, so it survives the rank and player validate never takes it off. Only /arrowsadmin unlocks revoke takes one back.

Does it work on Folia?

Yes, it declares Folia support.

Where do I get support?

On the Exylia Discord.