Common problems
What to check when an emote does not play, is not seen, or will not stop.
Start with what the player was told in chat: every refusal says why.
A player clicks an emote and nothing happens#
They are told why, in chat. In order, the usual answers:
- They do not own it —
no-permission. The menu draws it locked. - It is a duet — a duet cannot be started from the menu.
/emote play <id> <player>. - A cooldown — three seconds between any two emotes, and most emotes have their own on top.
- The world —
behaviour.worldslists the worlds emotes are allowed in. - Combat —
behaviour.block-in-combatrefuses them while tagged.
The emote plays but the player does not see it#
The camera is off: camera.enabled is false, or it was turned off after the catalogue was compiled
and the plugin has not been reloaded since. Everybody around them still sees it.
How does a player stop an emote?#
Any click, crouching, jumping, a walking key, being hit, or /emote cancel. The first 300 ms are
ignored, so the key they were already holding does not end it at once.
I set cancel-on-move to false and walking keys still end it#
Yes. While the camera is up, the keys are read straight off the connection and any walking key ends the emote there, whatever the setting says. See Playing an emote.
Does an emote make a player invulnerable?#
No. The real player stays where they were, with their hitbox. A hit lands as it always would and ends
the emote; a punch aimed at the body ends it too. behaviour.cancel-on-damage should stay on.
Can a player get stuck inside a camera?#
Every way out ends it: clicks, keys, damage, leaving, dying, changing world, /emote cancel. An endless
emote with nothing pressed ends after behaviour.endless-limit. The plugin shutting down ends every
emote first. As an admin, /emotesadmin cancel with no player ends all of them.
Why can't a showcase play the handshake?#
A showcase plays one body at one spot. A duet needs two bodies turned towards each other, so duets are left out of every showcase.
The invitation expired before they accepted#
duet.invite is 20 seconds. And the two must still be within duet.max-distance — three blocks — when
it is accepted.
They accepted and were told they do not own it#
Ownership is not checked when an invitation is sent, only when it is accepted. Both players must own the emote, be off cooldown, out of combat and in a world that allows emotes.
Why is the emote body black, or made of blocks?#
The body is waiting for its real skin. ExyliaLib cuts every skin into pieces and gets a texture for each from Exylia Skins, free and with no key. Until a piece arrives, it is drawn in blocks of the nearest colour to that part of the skin, so a dark outfit comes out as a black body made of blocks for a moment:
- A piece any server already made arrives at once. A brand-new skin waits its turn in the service's queue; it is prepared when its owner joins, so it is normally ready before the first emote.
- Every piece is kept in ExyliaEmotes' database (
database.yml), so it is never asked for again, not after a restart and not on another server sharing that database. - If bodies never get their skin, make sure the server can reach
https://skins-api.exylia.netand that ExyliaLib is up to date: older versions needed a MineSkin key. ragdoll-skin-quality, in ExyliaLib'splugins/ExyliaLib/config.yml, trades detail for pieces:highcuts a skin in 18,normal, the default, in 10, andlowin 5.
See Displays and NPCs.
Something missing on this page? Tell us on Discord