Introduction
What ExyliaEmotes is: 68 emotes performed by an animated body and filmed from outside, so the player watches themselves do it.
ExyliaEmotes lets a player perform an emote: a wave, a dance, a handshake, a crown lowering onto their head. The emote is not an animation of the player's own model. The real player is hidden, an animated body is drawn where they stand, and a camera is opened outside it so the player can watch themselves perform it. When it ends the body disappears, the camera closes and the real player is back exactly where they were.
Everything visual belongs to ExyliaLib: the body is a [RAGDOLL] line and the camera a [CAMERA]
line, written in emotes.yml and compiled once by the sequence module. What this plugin owns is the
catalogue, who may play what, and when an emote has to stop. An emote somebody can write in a file is
an emote a server can add without waiting for a release.
The catalogue
68 emotes in four tabs ship in emotes.yml:
| Tab | Icon | Emotes | What is in it |
|---|---|---|---|
social | PLAYER_HEAD | 11 | Greetings, and the two that take a friend. |
fun | SLIME_BALL | 21 | Showing off, dancing, and the ones aimed at somebody in particular. |
meme | NOTE_BLOCK | 19 | The ones the internet already knows. |
party | FIREWORK_ROCKET | 17 | Celebrations, and props that do something that cannot happen. |
52 of them never stop: they loop until the player presses a key, is hit or asks. The other 16 play
once. Two — highfive and handshake — take two players. The full list is in
Emotes.
How it plays out
A player opens the menu
/emote is one screen: the tabs down the side, that tab's emotes beside them, their favourites
first.
They click one
The window closes and the emote starts where they are standing, facing the way they were looking. Everybody around them sees the body; they see it from the camera.
They get out
Any click, crouching, jumping, a walking key, a hit, or a punch at the body ends it. A one-shot emote also ends on its own.
Owning an emote
A player may perform an emote when either is true:
| Way | Where it lives |
|---|---|
| A permission | exyliaemotes.emote.<id>, the whole catalogue, its tab or its rarity. See Permissions. |
| A crate unlock | Won out of the crate or granted by an admin, and kept on the player's account for good. See The crate. |
Previewing an emote on the server's preview stage never needs either.
What the emote does not do
It does not protect anybody. The real player is still standing where they started, with a hitbox, unable to see who is next to them. Being hit ends the emote and the damage lands as it always would; nothing is cancelled.
Requirements
| Requirement | Detail |
|---|---|
| Server | Paper 1.21 or newer. Folia supported. |
| Required | packetevents |
| Recommended | ExyliaLib (a soft depend: the loader installs it) |
| Optional | PlaceholderAPI |
| Database | Always. Favourites live in one table, keys and unlocks in ExyliaLib's crate table. |
Something missing on this page? Tell us on Discord