Generating

Make a movement group

Makes an emote_group: one emote per movement state (idle, walk, sprint, sneak_idle, sneak_move, jump), worn as one thing with /emote <name>. RP Engine plays whichever state the player is in, so a pack can have its own walk and run and leave jumping to the game.

parts maps a state to an emote's id from POST /packs/{pack}/emotes or the listing. A state left out is the player's own animation. Emotes for more than one performer, and groups, cannot be members: a part naming one is left out and reported in ignored.

Free, and finished when it answers. A pack holds at most 16 groups.

POST/packs/{pack}/emote-groups

Path parameters

packstringrequired

The pack's slug, as returned by the packs endpoints.

Body

namestringrequiredmax 64 characters

What it is called, and what /emote takes.

partsobject

State to emote id, for any of the states.

idlestring

The emote played while idle.

walkstring

The emote played while walk.

sprintstring

The emote played while sprint.

sneak_idlestring

The emote played while sneak idle.

sneak_movestring

The emote played while sneak move.

jumpstring

The emote played while jump.

Response · 201

Made.

idstringrequired

The group's id. Also its job handle's last part, and what /emote takes.

typestringrequired

Always emote_group.

namestringrequired

Its name.

partsobjectrequired

State to emote id, as saved.

idlestring

The emote played while idle.

walkstring

The emote played while walk.

sprintstring

The emote played while sprint.

sneak_idlestring

The emote played while sneak idle.

sneak_movestring

The emote played while sneak move.

jumpstring

The emote played while jump.

packstringrequired

The pack it is in.

ignoredarray of string

States you named whose emote could not be a member. Absent when none.

Error codes

Branch on error.code, never on the message.

invalid_json400

The request body wasn't a JSON object.

invalid_request400

Something in the body or query is wrong. message says what.

invalid_api_key401

The key isn't one of ours, or it has been revoked.

missing_api_key401

No Authorization: Bearer header was sent.

wrong_key_kind401

An MCP key sent to the REST API, or an API key sent to the MCP server. Each only opens its own.

account_suspended403

The account is suspended, so its keys open nothing. message says until when, if the suspension has an end date.

forbidden403

Valid key, but not permitted to do this in this pack.

plan_required403

The key is valid, but its account is on Starter. The API needs a paid plan.

not_found404

No such pack, asset or job.