Configuring

Emotes

The 68 shipped emotes by tab, and how an entry in emotes.yml is written.

Every emote is an entry in emotes.yml. The key is its id: it is what commands, permissions, placeholders and the crate call it, lowercased. The tables below are the shipped catalogue in the order each tab draws it.

Column	What it says
Rarity	Its `tier`: the colour it is named in, how often the crate lands on it, and which `exyliaemotes.tier.<tier>` grants it.
Kind	`solo`, or `duet` for one that takes two players. See Duets.
Plays	`endless` loops until the player stops it; `once` ends on its own.
Cooldown	Its own cooldown. `—` means only the server's `behaviour.cooldown` applies.
Prop	What is drawn besides the body.

Id	Name	Rarity	Kind	Plays	Cooldown	Prop
`wave`	WAVE	common	solo	endless	8s	—
`bow`	BOW	rare	solo	once	—	—
`salute`	SALUTE	common	solo	once	—	—
`highfive`	HIGH FIVE	epic	duet	once	8s	—
`handshake`	HANDSHAKE	epic	duet	once	8s	—
`sway`	SWAY	common	solo	endless	8s	—
`nod`	NOD	common	solo	endless	8s	—
`shrug`	SHRUG	common	solo	endless	8s	—
`thumbs_up`	THUMBS UP	rare	solo	endless	8s	—
`beckon`	COME HERE	common	solo	endless	8s	—
`blow_kiss`	BLOW A KISS	epic	solo	endless	10s	Heart particles

Fun

Id	Name	Rarity	Kind	Plays	Cooldown	Prop
`dance`	DANCE	rare	solo	endless	8s	A ring of `END_ROD`
`facepalm`	FACEPALM	common	solo	endless	8s	—
`flex`	FLEX	rare	solo	endless	8s	—
`dab`	DAB	common	solo	endless	8s	—
`cartwheel`	CARTWHEEL	epic	solo	endless	8s	—
`point_laugh`	POINT AND LAUGH	common	solo	endless	8s	—
`sip_tea`	SIP TEA	rare	solo	endless	8s	—
`slow_clap`	SLOW CLAP	common	solo	endless	8s	—
`crown`	CROWN	legendary	solo	once	10s	A crown of gold blocks
`sleep`	BORING	common	solo	endless	8s	—
`twerk`	TWERK	epic	solo	endless	10s	—
`shuffle`	SHUFFLE	rare	solo	endless	10s	—
`headbang`	HEADBANG	rare	solo	endless	10s	—
`spin`	SPIN	epic	solo	endless	10s	—
`air_guitar`	AIR GUITAR	rare	solo	endless	10s	—
`backflip`	BACKFLIP	epic	solo	endless	10s	—
`shadowbox`	SHADOW BOX	rare	solo	endless	10s	—
`disco`	DISCO	common	solo	endless	8s	—
`ballet`	PIROUETTE	epic	solo	endless	10s	—
`thriller`	THRILLER	epic	solo	endless	10s	—
`egyptian`	EGYPTIAN	common	solo	endless	10s	—

Meme

Id	Name	Rarity	Kind	Plays	Cooldown	Prop
`tpose`	T-POSE	common	solo	endless	8s	A ring of `END_ROD`
`griddy`	GRIDDY	rare	solo	endless	8s	—
`moonwalk`	MOONWALK	epic	solo	endless	8s	—
`robot`	ROBOT	common	solo	endless	8s	—
`sprinkler`	SPRINKLER	rare	solo	endless	8s	—
`six_seven`	SIX SEVEN	legendary	solo	endless	10s	—
`macarena`	MACARENA	rare	solo	endless	10s	—
`floss`	FLOSS	epic	solo	endless	10s	—
`robot_walk`	ROBOT WALK	rare	solo	endless	10s	—
`gangnam`	HORSE DANCE	rare	solo	endless	10s	—
`default_dance`	DEFAULT DANCE	epic	solo	endless	10s	—
`woah`	HIT THE WOAH	rare	solo	endless	8s	—
`take_the_l`	TAKE THE L	common	solo	endless	8s	—
`caramelldansen`	CARAMELL	epic	solo	endless	10s	—
`ymca`	Y.M.C.A.	rare	solo	endless	10s	—
`carlton`	CARLTON	epic	solo	endless	10s	—
`orange_justice`	ORANGE JUSTICE	epic	solo	endless	10s	—
`nae_nae`	WHIP NAE NAE	rare	solo	endless	10s	—
`kazotsky`	KAZOTSKY KICK	legendary	solo	endless	10s	—

Party

Id	Name	Rarity	Kind	Plays	Cooldown	Prop
`confetti`	CONFETTI	rare	solo	once	8s	Pink and light-blue wool falling
`cake`	BIRTHDAY	epic	solo	once	10s	A cake of concrete, candle flames and smoke
`toast`	TOAST	common	solo	once	—	—
`trophy`	TROPHY	legendary	solo	once	12s	A gold-block trophy
`firework`	FIREWORK	rare	solo	once	8s	A block rocket and a firework
`tophat`	TOP HAT	legendary	solo	once	12s	A top hat of concrete, and what comes out of it
`cardtrick`	CARD TRICK	epic	solo	once	8s	Paper thrown into the air
`fireball`	FIREBALL	legendary	solo	once	12s	A ball of magma blocks
`levitate`	LEVITATE	epic	solo	once	10s	Three amethyst blocks
`vanish`	VANISH	legendary	solo	once	12s	Smoke and portal particles
`hype`	HYPE	common	solo	endless	8s	—
`conga`	CONGA	rare	solo	endless	10s	—
`limbo`	LIMBO	rare	solo	endless	10s	—
`lighter`	LIGHTER	common	solo	endless	8s	—
`sparkler`	SPARKLER	rare	solo	endless	10s	`END_ROD` sparks
`countdown`	COUNTDOWN	epic	solo	once	10s	Firework particles
`chicken_dance`	CHICKEN DANCE	common	solo	endless	10s	—

Some ids carry an underscore

thumbs_up, blow_kiss, point_laugh, sip_tea, slow_clap, air_guitar, six_seven, robot_walk, default_dance, take_the_l, orange_justice, nae_nae and chicken_dance. Commands and permissions take them as they are. The %exyliaemotes_emote_<id>_<field>% placeholders cannot reach them — see Placeholders.

Writing an entry

categories:
  social:
    name: 'Social'
    material: PLAYER_HEAD
    priority: 1
 
emotes:
  wave:
    category: social
    tier: common
    name: '{primary}&lWAVE'
    material: PLAYER_HEAD
    priority: 1
    cooldown: 8s
    description:
      - '{letters}A hand up and two turns of the wrist.'
      - '{letters}The one everybody tries first.'
    effects:
      - '[RAGDOLL] {victim};intact:0;follow:1;loop:true;tempo:0.90-1.20;loop_from:0.42;keys:...'
      - '[CAMERA] loop:true;keys:0.00 distance=2.9 yaw=25 pitch=12 height=1.5 | 5.00 yaw=~360 ease=linear'
      - '[SOUND] BLOCK_AMETHYST_BLOCK_CHIME;0.4;1.9;repeat:240;every:0.44'

A category

Key	Default	What it does
`name`	The key	What the tab is called.
`material`	`PAPER`	What the tab is drawn as.
`priority`	`999`	Where the tab sits; lower comes first.

A category with no emotes in it gets no tab. The key is also its permission: exyliaemotes.category.<key>.

An emote

Key	Default	What it does
`category`	`social`	Which tab it appears under. An emote naming an undeclared category is logged and kept: no tab shows it, but commands can still play and grant it.
`tier`	`common`	Its rarity, one of `config.yml`'s `tiers` keys. One that is not declared is logged, and the emote falls back to the first rarity.
`kind`	`solo`	`duet` for two players. `duo`, `pair`, `two` and `together` are read as `duet`; anything else is `solo`.
`name`	The key	What menus, messages and placeholders call it.
`material`	`BARRIER`	What it is drawn as in the menu and the crate.
`description`	Empty	One line or a list of lines. `<nl>` also breaks a single line. `lore` is read as the same key.
`priority`	`999`	Where it sits in its tab; lower comes first.
`cooldown`	None	Its own cooldown, written out: `5s`, `1m30s`. A bare number is seconds. One that cannot be read is logged and ignored.
`gap`	`1.51`	For a duet, how far apart the two bodies stand, in blocks. Never less than `0.5`.
`effects`	—	The steps that play. An emote with none is logged and refuses to play.

A mistyped entry is reported on the console with the entry it came from and never costs the server its other emotes.

The steps

An emote is one [RAGDOLL] line and one [CAMERA] line, plus any sounds and props around them. Every token of ExyliaLib's sequence module can be used; the comment at the top of the shipped emotes.yml explains the body and camera parameters frame by frame.

Line	What it is
`[RAGDOLL] {victim};...;keys:<frames>`	The body. `{victim}` is the player performing it: the body faces where they were looking and wears their skin — the head always, the rest only with a `mineskin-key` in ExyliaLib's `config.yml`; without one the rest is drawn in blocks of the nearest colour.
`[CAMERA] keys:<frames>`	The shot the player watches from. It always looks at the body.
`[SOUND]`, `[CIRCLE]`, `[SCATTER]`, `[SPHERE]`, `[FIREWORK]`, `[DELAY]`	Everything else: what is heard, and props drawn around the body.

Nothing is heard past sixteen blocks

A [SOUND] volume above 1.0 is lowered to 1.0 as the file is read. Above one the client does not play it louder, it plays it further — sixteen blocks times the number — and an emote is played over and over in lobbies by anybody who feels like it.

Endless emotes

An emote is endless when its [RAGDOLL] line says loop:true. It is written as an entry and a cycle:

Parameter	What it does
`loop:true`	The body plays its cycle again and again.
`loop_from:<seconds>`	Where the entry ends and the cycle starts. The last frame has to leave the body in exactly the pose this point left it in, or it snaps back once a cycle.
`tempo:<min>-<max>`	A speed rolled once per play and shared by every piece of that body, so the same dance is a shade quicker or slower every time.
`accel:` / `max_speed:`	Wind the cycle up a little every time round, up to a ceiling. Only `six_seven` does it.

The camera of an endless emote loops too (loop:true, usually a full turn with yaw=~360), and a sound that has to keep the beat is written repeat:<times>;every:<seconds>: its every: follows the rolled tempo.

An endless emote has no length of its own. It lasts until the player stops it, or until behaviour.endless-limit — five minutes by default — ends it for a player who walked away from their keyboard mid-dance.

Without a camera

With camera.enabled: false every [CAMERA] line is taken out as the catalogue is compiled. The emote still plays for everybody around the player; the player simply does not see it. A showcase never plays the camera line either — see Showcases.

Renaming a key is not free

The key is the id, the permission and what the crate unlocked. An emote whose key you rename is a new emote: whoever owned the old one by permission or by crate unlock does not own the new one.

Something missing on this page? Tell us on Discord