Advanced Usage¶

Cooldowns¶

Cooldowns are configured with settings.cooldown in each Emote file, not in emotes.json.

{
  "settings": {
    "cooldown": "5s"
  }
}

Time units

Emote uses Minecraft time format.
1s equals 20t.

s: seconds
t or omitted: ticks
d: Minecraft days

When playing a Sequence, only the Sequence's own settings.cooldown applies. Cooldowns of referenced Animations are not added.

Idle Emotes¶

Idle emotes play automatically after a specified time since the player's last action. Add idle to a permission entry in emotes.json.

{
  "permission": "emote.default",
  "emotes": ["example:wave", "example:hello"],
  "idle": {
    "delay": "300s",
    "emote": ["example:drink"]
  }
}

To choose evenly among several emotes, list only their IDs:

"emote": ["example:drink", "example:look-around"]

For weighted selection, alternate IDs and integer weights whose total must equal 100:

"emote": ["example:drink", 70, "example:look-around", 30]

If a player has multiple permissions, entries are checked from top to bottom in emotes.json, and the first allowed entry with idle is used. Place higher-priority groups first.

"permissions": [
  {
    "permission": "emote.vip",
    "emotes": ["example:vip"],
    "idle": {
      "delay": "120s",
      "emote": ["example:vip-idle"]
    }
  },
  {
    "permission": "emote.default",
    "emotes": ["example:wave"],
    "idle": {
      "delay": "300s",
      "emote": ["example:drink"]
    }
  }
]

An idle emote does not start while another emote is playing. A failed attempt is retried after one second. When several candidates are available, Emote avoids selecting the most recently played emote twice in a row when possible.

Sequences¶

A Sequence connects multiple Animations in order and presents them to the player as one emote. Server operators must install both the Sequence JSON and every Animation JSON it references.

Example file layout¶

config/emote/emote/sit/
├── sit-down.json
├── sit-idle.json
├── stand-up.json
└── sit.json

sit.json:

{
  "type": "sequence",
  "schema_version": 4,
  "id": "example:sit",
  "metadata": {
    "name": "Sit",
    "description": "Sit down and stand up after waiting."
  },
  "settings": {
    "cooldown": "5s",
    "rotation_deadzone": 50,
    "player": {
      "hidden": true,
      "stop_conditions": {
        "movement_distance": 0.1,
        "jump": true,
        "submerge": true,
        "ride": true,
        "damage": true,
        "attack": true,
        "game_mode_change": true
      }
    }
  },
  "steps": [
    {"emote": "example:sit-down"},
    {"emote": "example:sit-idle", "repeat": 3},
    {"emote": "example:stand-up"}
  ]
}

Intermediate Animations referenced by a Sequence are usually hidden from direct selection:

"settings": {
  "standalone": false,
}

Verifying the installation¶

Place all JSON files under emote/ on the same server.
After reloading the files, use /emote list to confirm that the Sequence and every referenced Animation loaded.
Run /emote play example:sit with normal player permissions.

If the Sequence does not load, check the server log for missing Animation IDs, incompatible nodes, unsupported playback modes, or invalid wait-step messages.

Complete example pack

The repository includes a ready-to-install two-player handshake sample. The JSON on this page only demonstrates a linear Sequence and requires separate referenced Animation files.

To create random selection, waits, repeat control, or two-player cooperative Sequences, see the Sequence format specification.