Choose and write emotes
See the 107 shipped emotes by tab, change an emote's rarity or cooldown, and write your own entry in emotes.yml.
You end up with the emote catalogue the way you want it: the shipped emotes kept, changed or removed, and your own entries added. Every emote is an entry in emotes.yml; its key is its id, which commands, permissions, placeholders and the crate use in lowercase.
Before you start#
Nothing else is needed. The 107 emotes ship ready in five tabs (Social, Fun, Meme, Party, Poses). To give players an emote, see Permissions; to see how they play it, see Perform and stop emotes.
Steps#
Change the rarity or cooldown of a shipped emote:
Open the catalogue
Run /emotesadmin, click Settings, and open the emotes catalogue. Or run /exylialib editor ExyliaEmotes to edit it in the browser with ExyliaLib's web editor. Both need exyliaemotes.admin. You can also edit plugins/ExyliaEmotes/emotes.yml by hand.
Edit the entry
Find the emote by its id, for example wave, and change tier: common to tier: rare, or cooldown: 8s to cooldown: 30s.
Apply it
Save in the editor, or run /emotesadmin reload if you edited the file by hand. The catalogue is rebuilt, the crate rebuilt, every showcase restarted and every open 3D selector redrawn.
Check that it works#
Run /emote and find the emote: its name now shows the new rarity colour, and /emote play <id> twice in a row makes the second one wait out the new cooldown. A change that would lose a tab or an entry is refused whole, with the line that would be lost; smaller slips are written and logged on load.
Going further#
Know what ships#
There are 107 emotes. Social has 16, Fun 24, Meme 24, Party 24 and Poses 19. A pose never times out: it stays until the player moves, is hit or stops it. Three poses (ledge_sit, ledge_lean, ledge_daydream) need the player to stand at the edge of a block, facing the drop. The full table, with rarity, cooldown and props, is in the details below.
Add a tab#
Declare a category and point emotes at it. A category with no emotes gets no tab, and its key is also its permission, exyliaemotes.category.<key>.
categories:
parties:
name: 'Parties'
material: CAKE
priority: 5Rename carefully#
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.
Run without a camera#
With camera.enabled: false, every [CAMERA] line is removed when the catalogue is compiled. The emote still plays for everybody around the player; the player just does not see it. A showcase never plays the camera line either, see Showcases.
The shipped catalogue
| 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. |
Social#
| 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 |
heart_hands | HEART HANDS | rare | solo | endless | 8s | A heart floating up |
peace | PEACE | common | solo | endless | 8s | — |
chef_kiss | CHEF'S KISS | rare | solo | once | 8s | — |
wakanda | WAKANDA FOREVER | epic | solo | once | 8s | A ring of purple concrete |
calma | CALMA | rare | solo | endless | 8s | — |
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 | — |
renegade | RENEGADE | rare | solo | endless | 8s | — |
wednesday | WEDNESDAY | epic | solo | endless | 8s | — |
apple | APPLE | rare | solo | endless | 8s | An apple on the head |
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 | — |
aura_farming | AURA FARMING | legendary | solo | endless | 10s | — |
skibidi | SKIBIDI | rare | solo | endless | 8s | — |
chill_guy | CHILL GUY | common | solo | endless | 8s | — |
mewing | MEWING | rare | solo | once | 8s | — |
harlem_shake | HARLEM SHAKE | epic | solo | once | 10s | A turtle helmet, then wool thrown everywhere |
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 | STARBURST | rare | solo | once | 8s | A star shot from the palm and a burst drawn in blocks (id kept as 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 | End rod sparks |
chicken_dance | CHICKEN DANCE | common | solo | endless | 10s | — |
siuuu | SIUUU | legendary | solo | once | 10s | A ring of white concrete and the word itself |
lightning_bolt | LIGHTNING BOLT | epic | solo | once | 10s | A ring of yellow concrete and sparks |
zen | ZEN | legendary | solo | endless | 10s | — |
money_rain | MAKE IT RAIN | epic | solo | endless | 10s | Paper and gold nuggets falling |
hotline_bling | HOTLINE BLING | rare | solo | endless | 8s | — |
running_man | RUNNING MAN | common | solo | endless | 8s | — |
jumpstyle | JUMPSTYLE | rare | solo | endless | 8s | — |
thumbs_up, blow_kiss, heart_hands, chef_kiss, point_laugh, sip_tea, slow_clap,
air_guitar, six_seven, robot_walk, default_dance, take_the_l, orange_justice, nae_nae,
chicken_dance, aura_farming, chill_guy, harlem_shake, lightning_bolt, money_rain,
hotline_bling and running_man. Commands
and permissions take them as they are. The %exyliaemotes_emote_<id>_<field>% placeholders cannot
reach them — see Placeholders.
Poses#
Nineteen ways to sit, lie or settle. Every one is endless and has no cooldown, and none of them times
out: a pose stays until the player moves, is hit or stops it (limit: none, see below).
| Id | Name | Rarity | Kind | Plays | Cooldown | What it is |
|---|---|---|---|---|---|---|
sit | SIT | common | solo | endless | — | Down on the floor, knees up, leaning back on both hands. |
criss_cross | CRISS CROSS | common | solo | endless | — | Legs folded, hands on knees, a slow sway. |
hug_knees | HUG KNEES | common | solo | endless | — | Knees to the chest, a sleepy tilt of the head. |
seiza | SEIZA | common | solo | endless | — | Kneeling back on the heels. |
squat | SQUAT | common | solo | endless | — | Down on the heels, elbows on the knees. |
ledge_sit | LEDGE SIT | common | solo | endless | — | Sat on the edge of a block, feet swinging. Needs an edge. |
kid_sit | KID SIT | rare | solo | endless | — | Legs straight out, rocking side to side. |
sulk | SULK | rare | solo | endless | — | Curled up, face hidden in the knees. |
stargaze | STARGAZE | rare | solo | endless | — | On the back, hands behind the head. |
belly | BELLY | rare | solo | endless | — | On the belly, chin in hands, feet kicking. |
flop | FLOP | rare | solo | endless | — | Face down and arms out. |
snooze | SNOOZE | rare | solo | endless | — | Flat on the back, fast asleep. |
ledge_lean | LEDGE LEAN | rare | solo | endless | — | On a block edge, chin in hands. Needs an edge. |
ledge_daydream | LEDGE DAYDREAM | epic | solo | endless | — | On a block edge, one knee hugged. Needs an edge. |
nodding_off | NODDING OFF | epic | solo | endless | — | Sat cross-legged, the head drops and jolts awake. |
snow_angel | SNOW ANGEL | epic | solo | endless | — | On the back, sweeping arms and legs. |
wish | WISH | epic | solo | endless | — | On both knees, hands together, eyes on the sky. |
lounge | LOUNGE | epic | solo | endless | — | On one side, head in one hand. |
meditate | MEDITATE | legendary | solo | endless | — | Legs crossed, slowly rising off the floor. |
ledge_sit, ledge_lean and ledge_daydream use seat: ledge: the body is placed on the edge of the
block the player stands on, legs over the drop. With no edge to sit on they refuse to play and say so
(no-ledge in messages.yml: "Stand at the edge of a block, facing the drop.").
Entry keys, categories and the steps of an emote
Writing an entry#
categories:
social:
name: 'Social'
material: PLAYER_HEAD
priority: 1
emotes:
wave:
category: social
tier: common
name: '{primary}&lWAVE'
material: WHITE_BANNER
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. Every shipped emote has an icon of its own that hints at what it does. |
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. |
price | Its rarity's | What it costs in the menu shop: 250, 2.5k or {amount: 250, currency: gems}. See The crate. |
limit | behaviour.endless-limit | For an endless emote, how long it runs untouched: none never ends it, a duration such as 30m sets its own. One that cannot be read is logged and the server's limit applies. |
seat | None | ledge sits the body on the edge of the block, legs over the drop, and refuses where there is no edge. |
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 at once, the rest as soon as its pieces arrive from Exylia Skins (no key needed); until then 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. |
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.
Something missing on this page? Tell us on Discord