Common problems
Fixes for the problems server owners hit most: nothing plays when shooting, effects that vanish, previews that are not set up and a menu that will not open.
Find your symptom, then follow the fix.
The plugin does not start#
The console names what is missing. packetevents is required, and ExyliaLib is installed by the loader on the first start if it is absent. See Install ExyliaArrows.
Nothing plays when a player shoots#
Check in this order:
- Is the projectile allowed? By default only arrows, spectral arrows and tridents carry an effect (
projectiles.all-typesisfalse). Add types toprojectiles.default-allowed-typesor setall-typestotrue. - Is there an effect to play? With
behaviour.mode: bowthe menu choice is never read, and withplayera bound bow is never read. See Bind effects to bows. - Does the player still own it? A choice they no longer have the permission for is taken off at the shot. Give the permission back and they pick it again.
- Are they in a disabled world?
disabled-worldsinconfig.ymlstops every effect there. - Is the player set to see nothing? A player on the visibility mode "None" sees no effects, not even their own.
- Is a WorldGuard region denying it? ExyliaLib registers the flag
arrows-effects. Denied in a region, launch, trail and impact do not play there.
The trail is missing but the impact plays#
The server hit trail.max-active (200 trails at once, 10 per player). Shots over the limit still play their launch and impact and just leave no trail. Raise the numbers, or set them to 0 for no limit. A trail also stops after trail.max-duration seconds (10 by default).
The menu says it is disabled#
behaviour.mode is bow. On that server the menu would change nothing, so it refuses to open. Set the mode to player or both.
Previews say they are not set up#
No preview stage exists yet. Stand where previews should play and run /arrowsadmin preview location. There is no default on purpose, because a guessed position could put the player inside terrain.
An effect I bound to a bow stopped playing#
The bow stores the effect's key. If you renamed the key in effects.yml, the bow now names nothing. Renaming a key also changes its permission, so rename effects only when you must. Restore the old key, or bind the bow again with /arrowsadmin bow bind <effect>.
A player says their effect disappeared#
Their permission went away, usually because a rank expired. An effect won in the crate or bought in the shop is saved on the player and stays. See Permissions.
Locked effects show no price#
The shop needs shop.enabled, a price (the effect's own price or its rarity in shop.tier-prices), an economy plugin (ExyliaEconomy or Vault) and the player holding exyliarrows.buy. With any of them missing the effect shows as locked without a price.
The menus are in the wrong language#
language in config.yml picks the folder under lang/. default follows ExyliaLib's own language. See Configuration.
Effects lag during big fights#
Every particle and display line is a packet per viewer. Check how many lines an effect has, lower count: on its particle lines, and keep trail.max-active low enough for your server.
Something missing on this page? Tell us on Discord