Frequently asked questions

A player clicks an emote and nothing happens

They are told why, in chat. In order, the usual answers:

1. They do not own it — no-permission. The menu draws it locked.
2. It is a duet — a duet cannot be started from the menu. /emote play <id> <player>.
3. A cooldown — three seconds between any two emotes, and most emotes have their own on top.
4. The world — behaviour.worlds lists the worlds emotes are allowed in.
5. Combat — behaviour.block-in-combat refuses 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?

ExyliaLib has no MineSkin key. Without one, an emote's body keeps the player's real face on its head, but every other part 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.

Set mineskin-key in ExyliaLib's plugins/ExyliaLib/config.yml to a free key from account.mineskin.org/keys and run /exylialib reload. From then on the bodies in ExyliaEmotes wear the real skin:

• Each new skin is uploaded once, in the background, and kept in ExyliaEmotes' database (database.yml), so it is never uploaded again, not after a restart and not on another server sharing that database. Until it arrives, the body is still drawn in blocks.
• MineSkin's free plan allows 20 uploads a minute and 100 an hour; past the hour, uploads wait for it to reset.
• ragdoll-skin-quality, in the same ExyliaLib file, trades detail for uploads: high costs 18 uploads per new skin (about 5 skins an hour on the free plan), normal, the default, 10 (about 10), and low 5 (about 20).

See Displays and NPCs.

Will an update overwrite my emotes.yml?

No. New emotes from an update are added to your file; anything you changed or deleted is left alone.

Can I write my own emotes?

Yes — that is what emotes.yml is for. An emote is a [RAGDOLL] line and a [CAMERA] line; the comment at the top of the shipped file documents both, and Emotes covers every key of an entry. A line that cannot be read is reported on the console; the rest of the catalogue still loads.

Does it need PacketEvents?

Yes, it will not load without it. The camera, the hidden player and the way out of an emote are all packets.

Is there an API?

No. ExyliaEmotes publishes no service in exylia-api.

Does it work on Folia?

Yes, it declares Folia support.

Where do I get support?

On the Exylia Discord.