Skip to content

Beginner Movement and Animation

These examples are natural-language prompts you can send to the bot in IM.

Basic movement prompts

Walk to me.

Move 5 meters forward.

Fly to me and land.

Stop moving.

Teleport prompts

Teleport to region Welcome Island at 128,128,25.

Teleport back to my current region.

Region and map lookup prompts

Find the region handle at global map coordinates 99712, 102400.

Show agent location map markers for my current region.

Show land-for-sale map entries for region handle 1099511628032.

Use clear targets

Give region name plus coordinates when possible. It reduces ambiguity and failed teleports.

When to use map lookup

If you only have global map coordinates, resolve the region handle first, then query map data for that handle.

Animation prompts

Wave at me.

Play the dance animation.

Start clapping.

Stop all animations.

What animations are you playing?

Use built-in animation names

Names like wave, dance, clap, bow, laugh, and sit resolve to the viewer's built-in animations. You can also pass an animation UUID directly.

Animation permission prompts (object requests)

Some scripted chairs/objects ask permission before they can animate the bot avatar. When this happens, the runtime emits script.permission.animation.requested on channel general.

Try prompts like:

Show pending animation permission requests.

Approve the latest animation permission request.

Reject animation permission request handle <handle>.

Behind the scenes these map to:

  • ListScriptAnimationPermissionRequests
  • ScriptAnimationPermissionRespond

Scripted menus and text input prompts

Some scripted objects open popup menus or text boxes. When this happens, check pending dialogs and respond with either button choice or text.

Try prompts like:

Show pending scripted dialogs.

Press button 1 on dialog handle <handle>.

Submit text "hello" on dialog handle <handle>.

Behind the scenes these map to:

  • ListScriptDialogs
  • ScriptDialogChoice
  • ScriptDialogTextInput

Sitting on chairs and objects

Sit on prim 503191167.

Sit on the nearest chair.

Find the nearest explicit sit target within 15 meters and sit.

Ground sit vs object sit

sit by itself does a ground sit. For furniture/chairs, use object-targeted sit requests (by local ID, by name, or nearest sittable prim).

If sit fails

Move the bot closer to the chair and retry. Some objects require proximity before they return an AvatarSitResponse.

Follow-and-demonstrate workflow

  1. Ask the bot to come near you.
  2. Ask it to fly to a point.
  3. Ask it to stop.
  4. Ask it to return.

Example sequence:

Walk to me.
Fly to 140,130,45.
Stop movement.
Walk back to 128,128,25.

Troubleshooting movement and animation

  • If the bot does not respond, confirm you are messaging the correct avatar.
  • If commands lag, check container health and logs.
  • If teleport fails, verify the destination region exists and is online.
  • If an animation does not play, check that the name is a known built-in animation or provide a valid animation UUID.

For avatar clothing and attachment prompts, see Beginner Guide -> Appearance and Wearables.

For tool-level details, see Advanced Guide -> Movement and Animation.