Content generated with AI — it may contain mistakes.

ExyliaEmotes/How it worksUpdated in v1.4.1

Perform and stop emotes

Start an emote from the menu or chat, see what happens, and learn every way it ends and every reason it is refused.

Page 10 of 217 min read

You end up knowing how a player performs an emote, what the server does while it runs, and why one is sometimes refused. A player starts an emote and watches their own animated body from outside, with a camera, while everybody else sees the body.

Before you start#

The player needs to own the emote, see Permissions. Run /emote list to see what they own. Nobody except operators owns one until you grant it, see Your first emote.

Steps#

Start it

Open the menu with /emote and left-click an emote you own. The window closes first and the emote starts a tick later, so no screen is left over the shot. In chat, /emote play <emote> does the same. An admin can use /emotesadmin play <player> <emote>, which reaches past ownership and nothing else.

Watch it

The real player is hidden and a body wearing their skin plays the emote at their feet, while the camera shows it from outside.

Stop it

Click, crouch, jump, press a walking key or run /emote cancel (or /emote stop). A one-shot emote ends on its own.

A duet cannot be started from the menu, a row has nobody to name. See Duets.

Check that it works#

Run /emote play wave as a player who owns it. You see a body waving from the outside; a second player nearby sees it too. A click ends it and the player stands where they were. Try it twice in a row to meet the cooldown message.

Going further#

What happens#

The real player is hidden

From everybody, while camera.hide-body is on. They are still there, with their hitbox, where they stood.

A body is drawn in their place

Wearing their skin, at their feet, facing where they were looking. Everybody around them sees it.

A camera opens

The player watches their own body from outside, from the shot the emote's [CAMERA] line describes. With camera.enabled off there is no shot and they see nothing of it.

It ends

The body disappears on its last pose, the camera closes and the real player is shown again, exactly where they were. One tick after the animation's own end, so the swap does not happen a frame early.

feedback.on-play is played to the player the moment it starts.

What ends one#

WhatWhen
Any clickEither button, at anything. The click is swallowed: it neither swings, places, uses nor interacts, because the player cannot see what they are aiming at.
Crouching or jumpingAlways.
A walking key or sprintIn practice always — see the note below.
Being hitAny damage, when behaviour.cancel-on-damage is on. The damage lands as it always would.
A punch at the bodyAnother player swinging at the body within 3.5 blocks, when behaviour.cancel-on-damage is on. A wall in between stops it.
Walking awayWith the camera off the player can actually move: drifting further than behaviour.move-tolerance ends it, when cancel-on-move is on.
/emote cancelOr /emote stop.
Leaving, dying, changing worldAlways.
The end of the animationA one-shot emote ends on its own.
behaviour.endless-limitAn endless emote that nothing else ended, after five minutes by default.
An admin/emotesadmin cancel [player].
The plugin shutting downEvery emote is ended first, so nobody is left inside a camera.
The first 300 milliseconds are ignored

The player was pressing something the moment they asked for the emote — the key that opened the menu, the walk they were in the middle of — and the client reports it again as soon as it changes. A key, click, crouch or swing in the first 300 ms does not end it. Damage, a punch at the body, leaving, dying and admins are not held back.

cancel-on-move does not keep walking keys from ending an emote

The key state is read twice: as the server's own input event, which obeys cancel-on-move, and straight off the connection, which does not — any walking or sprint key going down ends the emote there. What cancel-on-move: false does turn off is ending on actual movement, which only happens with the camera off.

Only keys going down count. Letting go of a walk they arrived in, or standing up from a crouch they were already in, ends nothing.

On a server older than 1.21.3 there is no input event, so only the connection path above hears the keys; clicks, the swing and crouching end an emote the same way.

An emote cut short plays feedback.on-cancel to its performers. One that ran to its end plays nothing: the body standing up again says so.

Why an emote is refused#

Checked in this order; the first that applies is what the player is told:

RefusalMessageWhen
Unknownunknown-emoteNo emote has that id, or its effects are empty.
Needs a partnerneeds-partnerIt is a duet and nobody was named.
Already playingalready-playingThey are performing one.
Not ownedno-permissionbehaviour.require-permission is on and they neither hold a node for it nor unlocked it.
Wrong worldwrong-worldbehaviour.worlds is not empty and does not list their world.
In combatin-combatbehaviour.block-in-combat is on and they are combat tagged.
On cooldownon-cooldownEither cooldown below is running. %time% is what is left.

An admin's /emotesadmin play skips only the ownership check. A player already performing, in combat or in a world where emotes are off is not made to perform anyway.

Combat comes from ExyliaLib

block-in-combat reads whichever combat plugin ExyliaLib is bridged to. With none, nobody is ever tagged and the setting does nothing.

Cooldowns#

Two, both started the moment an emote starts:

CooldownBlocksSet by
SharedEvery emote.behaviour.cooldown, 3 seconds by default. 0s turns it off. A rank's exyliaemotes.cooldown.<seconds> replaces it — see Permissions.
Its ownThat emote only.cooldown on the entry in emotes.yml. Most shipped emotes carry 8 to 12 seconds.

So after a wave the player waits three seconds for anything else and eight for another wave. In a duet both players get both.

Endless emotes and tempo#

85 of the shipped emotes loop until they are stopped. Each play of one rolls a tempo from the range its [RAGDOLL] line declares, so the same dance is a shade quicker or slower every time anybody sees it. The camera circles the body on a loop of its own for as long as it lasts.

With nothing to stop it, an endless emote ends after behaviour.endless-limit (5 minutes, never less than a second), or after the highest exyliaemotes.endless.<seconds> the player holds. An emote with its own limit uses that instead; the poses have limit: none and never time out.

Why a click ends it and why a punch is traced

Why a click is the way out#

A client looking through a camera stops driving its own player: it sends no movement, and on most versions no keys either. What it still sends is clicks, and the key state changes, and both are read straight off the connection. Clicking is also what everybody tries first.

The player's own body is still drawn for them right in front of the shot. Right-clicking it would send an interaction with themselves, which the server answers by disconnecting them — so that click is dropped too, and ends the emote instead.

Why a punch is traced#

The performer is hidden from every client, so no client will ever send an attack on them, and the body in their place has no hitbox. Left alone, that would make an emote a few seconds of immunity. So a swing near a body is traced against the body itself — a player-sized box at its feet — and ends the emote. The next swing is an ordinary hit on an ordinary player.

Something missing on this page? Tell us on Discord