Content generated with AI — it may contain mistakes.

ExyliaEmotes/GuidesUpdated in v1.4.1

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.

Page 4 of 2118 min read

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>.

yaml
categories:
  parties:
    name: 'Parties'
    material: CAKE
    priority: 5

Rename carefully#

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.

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
ColumnWhat it says
RarityIts tier: the colour it is named in, how often the crate lands on it, and which exyliaemotes.tier.<tier> grants it.
Kindsolo, or duet for one that takes two players. See Duets.
Playsendless loops until the player stops it; once ends on its own.
CooldownIts own cooldown. — means only the server's behaviour.cooldown applies.
PropWhat is drawn besides the body.

Social#

IdNameRarityKindPlaysCooldownProp
waveWAVEcommonsoloendless8s—
bowBOWraresoloonce——
saluteSALUTEcommonsoloonce——
highfiveHIGH FIVEepicduetonce8s—
handshakeHANDSHAKEepicduetonce8s—
swaySWAYcommonsoloendless8s—
nodNODcommonsoloendless8s—
shrugSHRUGcommonsoloendless8s—
thumbs_upTHUMBS UPraresoloendless8s—
beckonCOME HEREcommonsoloendless8s—
blow_kissBLOW A KISSepicsoloendless10sHeart particles
heart_handsHEART HANDSraresoloendless8sA heart floating up
peacePEACEcommonsoloendless8s—
chef_kissCHEF'S KISSraresoloonce8s—
wakandaWAKANDA FOREVERepicsoloonce8sA ring of purple concrete
calmaCALMAraresoloendless8s—

Fun#

IdNameRarityKindPlaysCooldownProp
danceDANCEraresoloendless8sA ring of END_ROD
facepalmFACEPALMcommonsoloendless8s—
flexFLEXraresoloendless8s—
dabDABcommonsoloendless8s—
cartwheelCARTWHEELepicsoloendless8s—
point_laughPOINT AND LAUGHcommonsoloendless8s—
sip_teaSIP TEAraresoloendless8s—
slow_clapSLOW CLAPcommonsoloendless8s—
crownCROWNlegendarysoloonce10sA crown of gold blocks
sleepBORINGcommonsoloendless8s—
twerkTWERKepicsoloendless10s—
shuffleSHUFFLEraresoloendless10s—
headbangHEADBANGraresoloendless10s—
spinSPINepicsoloendless10s—
air_guitarAIR GUITARraresoloendless10s—
backflipBACKFLIPepicsoloendless10s—
shadowboxSHADOW BOXraresoloendless10s—
discoDISCOcommonsoloendless8s—
balletPIROUETTEepicsoloendless10s—
thrillerTHRILLERepicsoloendless10s—
egyptianEGYPTIANcommonsoloendless10s—
renegadeRENEGADEraresoloendless8s—
wednesdayWEDNESDAYepicsoloendless8s—
appleAPPLEraresoloendless8sAn apple on the head

Meme#

IdNameRarityKindPlaysCooldownProp
tposeT-POSEcommonsoloendless8sA ring of END_ROD
griddyGRIDDYraresoloendless8s—
moonwalkMOONWALKepicsoloendless8s—
robotROBOTcommonsoloendless8s—
sprinklerSPRINKLERraresoloendless8s—
six_sevenSIX SEVENlegendarysoloendless10s—
macarenaMACARENAraresoloendless10s—
flossFLOSSepicsoloendless10s—
robot_walkROBOT WALKraresoloendless10s—
gangnamHORSE DANCEraresoloendless10s—
default_danceDEFAULT DANCEepicsoloendless10s—
woahHIT THE WOAHraresoloendless8s—
take_the_lTAKE THE Lcommonsoloendless8s—
caramelldansenCARAMELLepicsoloendless10s—
ymcaY.M.C.A.raresoloendless10s—
carltonCARLTONepicsoloendless10s—
orange_justiceORANGE JUSTICEepicsoloendless10s—
nae_naeWHIP NAE NAEraresoloendless10s—
kazotskyKAZOTSKY KICKlegendarysoloendless10s—
aura_farmingAURA FARMINGlegendarysoloendless10s—
skibidiSKIBIDIraresoloendless8s—
chill_guyCHILL GUYcommonsoloendless8s—
mewingMEWINGraresoloonce8s—
harlem_shakeHARLEM SHAKEepicsoloonce10sA turtle helmet, then wool thrown everywhere

Party#

IdNameRarityKindPlaysCooldownProp
confettiCONFETTIraresoloonce8sPink and light-blue wool falling
cakeBIRTHDAYepicsoloonce10sA cake of concrete, candle flames and smoke
toastTOASTcommonsoloonce——
trophyTROPHYlegendarysoloonce12sA gold-block trophy
fireworkSTARBURSTraresoloonce8sA star shot from the palm and a burst drawn in blocks (id kept as firework)
tophatTOP HATlegendarysoloonce12sA top hat of concrete, and what comes out of it
cardtrickCARD TRICKepicsoloonce8sPaper thrown into the air
fireballFIREBALLlegendarysoloonce12sA ball of magma blocks
levitateLEVITATEepicsoloonce10sThree amethyst blocks
vanishVANISHlegendarysoloonce12sSmoke and portal particles
hypeHYPEcommonsoloendless8s—
congaCONGAraresoloendless10s—
limboLIMBOraresoloendless10s—
lighterLIGHTERcommonsoloendless8s—
sparklerSPARKLERraresoloendless10sEND_ROD sparks
countdownCOUNTDOWNepicsoloonce10sEnd rod sparks
chicken_danceCHICKEN DANCEcommonsoloendless10s—
siuuuSIUUUlegendarysoloonce10sA ring of white concrete and the word itself
lightning_boltLIGHTNING BOLTepicsoloonce10sA ring of yellow concrete and sparks
zenZENlegendarysoloendless10s—
money_rainMAKE IT RAINepicsoloendless10sPaper and gold nuggets falling
hotline_blingHOTLINE BLINGraresoloendless8s—
running_manRUNNING MANcommonsoloendless8s—
jumpstyleJUMPSTYLEraresoloendless8s—
Some ids carry an underscore

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).

IdNameRarityKindPlaysCooldownWhat it is
sitSITcommonsoloendless—Down on the floor, knees up, leaning back on both hands.
criss_crossCRISS CROSScommonsoloendless—Legs folded, hands on knees, a slow sway.
hug_kneesHUG KNEEScommonsoloendless—Knees to the chest, a sleepy tilt of the head.
seizaSEIZAcommonsoloendless—Kneeling back on the heels.
squatSQUATcommonsoloendless—Down on the heels, elbows on the knees.
ledge_sitLEDGE SITcommonsoloendless—Sat on the edge of a block, feet swinging. Needs an edge.
kid_sitKID SITraresoloendless—Legs straight out, rocking side to side.
sulkSULKraresoloendless—Curled up, face hidden in the knees.
stargazeSTARGAZEraresoloendless—On the back, hands behind the head.
bellyBELLYraresoloendless—On the belly, chin in hands, feet kicking.
flopFLOPraresoloendless—Face down and arms out.
snoozeSNOOZEraresoloendless—Flat on the back, fast asleep.
ledge_leanLEDGE LEANraresoloendless—On a block edge, chin in hands. Needs an edge.
ledge_daydreamLEDGE DAYDREAMepicsoloendless—On a block edge, one knee hugged. Needs an edge.
nodding_offNODDING OFFepicsoloendless—Sat cross-legged, the head drops and jolts awake.
snow_angelSNOW ANGELepicsoloendless—On the back, sweeping arms and legs.
wishWISHepicsoloendless—On both knees, hands together, eyes on the sky.
loungeLOUNGEepicsoloendless—On one side, head in one hand.
meditateMEDITATElegendarysoloendless—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#

yaml
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

KeyDefaultWhat it does
nameThe keyWhat the tab is called.
materialPAPERWhat the tab is drawn as.
priority999Where 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

KeyDefaultWhat it does
categorysocialWhich 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.
tiercommonIts rarity, one of config.yml's tiers keys. One that is not declared is logged, and the emote falls back to the first rarity.
kindsoloduet for two players. duo, pair, two and together are read as duet; anything else is solo.
nameThe keyWhat menus, messages and placeholders call it.
materialBARRIERWhat 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.
descriptionEmptyOne line or a list of lines. <nl> also breaks a single line. lore is read as the same key.
priority999Where it sits in its tab; lower comes first.
cooldownNoneIts own cooldown, written out: 5s, 1m30s. A bare number is seconds. One that cannot be read is logged and ignored.
priceIts rarity'sWhat it costs in the menu shop: 250, 2.5k or {amount: 250, currency: gems}. See The crate.
limitbehaviour.endless-limitFor 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.
seatNoneledge sits the body on the edge of the block, legs over the drop, and refuses where there is no edge.
gap1.51For 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.

LineWhat 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.
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:

ParameterWhat it does
loop:trueThe 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