Frequently asked questions
Short answers to what server owners ask most about ExyliaHitEffect: effects that do not play, modes, visibility, regions, Folia.
For problems that need a checklist start with Common problems. These are the quick answers.
Why does nothing play when a player hits somebody?#
Check, in order: the victim is allowed (effects.all-mobs is false by default, so only PLAYER, MANNEQUIN and ZOMBIE count); the hit was not cancelled by another plugin; the player has an effect that the mode reads (in weapon the menu choice is ignored, in player a bound weapon is ignored); they still own it; and the world is not in effects.disabled-worlds. A player whose visibility is NONE sees nothing, including their own. See Configuration.
Why does the menu say hit effects are off?#
behaviour.mode is weapon. On that server the menu would change nothing, so it refuses to open instead of pretending. Set mode to player or both to use the menu.
Why did a player's effect disappear?#
The permission or rank that granted it ran out, and a choice a player can no longer use is taken off instead of played. They get the rank default if you set one in behaviour.defaults, and when the node comes back they pick the effect again. Effects won from the crate or bought in the menu are unlocked on the account and stay.
Does losing a permission break a bound weapon?#
No. A bound weapon plays its effect for whoever holds it, and binding a token asks for no permission: holding the token is the proof. That is what makes a bound weapon worth trading.
An arrow played the wrong effect#
An arrow plays the effect resolved when it was fired, so switching weapons mid-flight changes nothing. An arrow this plugin never saw launched, for example after a reload, falls back to what the shooter holds when it lands.
Effects stack on top of each other in a fight#
An effect longer than about six tenths of a second is still playing when the next blow lands, which is why the shipped ones are short. If you wrote your own, shorten life: and use fewer lines. One player also starts at most five effects a second. See Effects.
Can I use a kill effect's sequence here?#
The syntax is the same, so it loads, and it plays on every blow. Read the budget in Effects before you paste one in, and the shapes in Sequences.
Can players hide each other's effects?#
Yes. Each player picks ALL, NONE, SELF_ONLY or OTHERS_ONLY with /hiteffect visibility or in the menu. The server default is particles.default-visibility.
Does the weapon lore get written to the item?#
No. The lines are added to the copy that leaves the server, so any plugin reading the weapon finds the lore it always had, and renaming an effect updates every weapon at once. weapon-lore.enabled turns them off.
Can I write my own effects?#
Yes, in effects.yml; the in-game editor and the web editor check it before applying. The shapes and tokens are in Sequences. A line that cannot be read is reported on the console and skipped, and the rest of the effect still plays.
Can I turn effects off in a region or a world?#
Yes. List the world in effects.disabled-worlds, or deny the WorldGuard flag hit-effects (registered by ExyliaLib) in a region. Without WorldGuard the flag simply allows.
Does it work on Folia?#
Yes, the plugin declares Folia support.
Where do I get support?#
On the Exylia Discord.
Something missing on this page? Tell us on Discord