npcs

Install dcl-npc-toolkit and call npc.create with a position, GLB model, idle and walk animations, and an onActivate callback that calls npc.talk with your dialog array. The toolkit handles dialogue UI, movement paths, and interaction out of the box.

Use the NPC Toolkit when you need a GLB model with dialogue, walking, and state machine behavior. Use AvatarShape when the NPC must look like a Decentraland avatar with wearables, expressions, and emotes.

createDialogWindow only sets the dialog component, not npcDataComponent, so openDialogWindow fails reading theme. Fix it by calling npcDataComponent.set on the window entity with a valid theme such as lightTheme and the minimal required fields.

AvatarShape entities have no collider, so pointer events do not register directly. Add an invisible MeshCollider cylinder and use pointerEventsSystem.onPointerDown, or trigger interaction through a proximity distance check in a system.

Dialog buttons render with nowrap text in a fixed-width slot, silently clipping anything past roughly 15 characters. Use short labels like Yes or Decline, or reduce fontSize to fit longer text.

Set expressionTriggerId to a built-in emote name or a scene emote .glb path, and bump expressionTriggerTimestamp to replay the same emote. There is no triggerSceneEmote equivalent for AvatarShape entities.