Content Creators
Trigger emotes

Trigger emotes

To make a player perform an emote, use the triggerEmote() function. Note that only existing default emotes are supported for now. This function takes a single argument:

  • emote: An emote from the PredefinedEmote enum.
import { triggerEmote, PredefinedEmote } from "@decentraland/RestrictedActions"

const emoter = new Entity()
emoter.addComponent(new BoxShape())
emoter.addComponent(new Transform({ position: new Vector3(8, 0, 8) }))
emoter.addComponent(
  new OnPointerDown(
    (e) => {
      triggerEmote({ predefined: PredefinedEmote.ROBOT })
    },
    { hoverText: "Dance" }
  )
)

engine.addEntity(emoter)

Only the emotes in the PredefinedEmote enum are currently supported. This list includes the following:

  • ‘WAVE’
  • ‘FIST_PUMP’
  • ‘ROBOT’
  • ‘RAISE_HAND’
  • ‘CLAP’
  • ‘MONEY’
  • ‘KISS’
  • ‘TIK’
  • ‘HAMMER’,
  • ‘TEKTONIK’
  • ‘DONT_SEE’
  • ‘HANDS_AIR’
  • ‘SHRUG’
  • ‘DISCO’
  • ‘DAB’
  • ‘HEAD_EXPLODE’

The emote animation is seen both by the player (in 3rd person view) and any other players around. If the player walks, runs or jumps, they will interrupt the animation and return to playing the corresponding animations for these actions.

📔 Note: Players can only be animated if they already are standing inside the scene’s bounds, not if they are on a neighboring scene.

Before you can use this feature, you must add the ALLOW_TO_TRIGGER_AVATAR_EMOTE permission to the scene.json file. If not yet present, create a requiredPermissions property at root level in the JSON file to assign it this permission.

"requiredPermissions": [
    "ALLOW_TO_TRIGGER_AVATAR_EMOTE"
  ],

See Required permissions for more details.

📔 Note: To prevent abusive behavior that might damage a player’s experience, the ability to make a player perform an emote is handled as a permission. Currently, this permission has no effect in how the player experiences the scene. In the future, players who walk into a scene with this permission in the scene.json file will be requested to grant the scene the ability to play emotes on them.