Introduction
What ExyliaEmotes is: 107 emotes performed by an animated body and filmed from outside, so the player watches themselves do it.
In about 10 minutes you will have ExyliaEmotes installed, a player performing their first emote, and a clear idea of what the rest of these pages cover.
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#
107 emotes in five tabs ship in emotes.yml:
| Tab | Icon | Emotes | What is in it |
|---|---|---|---|
social | PLAYER_HEAD | 16 | Greetings, and the two that take a friend. |
fun | SLIME_BALL | 24 | Showing off, dancing, and the ones aimed at somebody in particular. |
meme | NOTE_BLOCK | 24 | The ones the internet already knows. |
party | BELL | 24 | Celebrations, and props that do something that cannot happen. |
poses | ARMOR_STAND | 19 | Sitting, lying and settling in, none of which times out. |
85 of them never stop: they loop until the player presses a key, is hit or asks. The other 22 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. Or, with menu.style: SPATIAL, the 3D selector: the
catalogue standing in front of them, the emote they pick danced live in their own skin.
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.
Check that it works#
Start the server with the jars in place and run /emote as an operator: the menu opens with five tabs. Click one emote and a body performs it while the camera shows it from outside. Follow First steps to give it to other players.
Requirements#
| Requirement | Detail |
|---|---|
| Server | Paper 1.21.1 or newer; Folia 1.21.4 or newer. |
| Client | Any the server accepts. The 3D selector and the 3D crate opening need 1.21.4 or newer; older clients get the classic menu and the inventory reels. |
| Required | packetevents |
| Recommended | ExyliaLib (a soft depend: the loader installs it) |
| Optional | PlaceholderAPI; ExyliaEconomy or Vault for the menu shop |
| Languages | English, Spanish, Portuguese, French, Russian and Turkish ship with it. |
| Database | Always. Favourites live in one table, keys and unlocks in ExyliaLib's crate table. |
Something missing on this page? Tell us on Discord