npcs

Create and manage GLB-based and AvatarShape NPCs with dialogue in Decentraland scenes.

3|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/decentraland/sdk-skills --skill npcs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: npcs
Source: https://github.com/decentraland/sdk-skills/tree/main/npcs
Command: npx skills add https://github.com/decentraland/sdk-skills --skill npcs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers often struggle to add interactive NPCs with dialogue and predictable behavior in Decentraland scenes, leading to inconsistent experiences and manual wiring.

Core Features & Use Cases

  • NPC Toolkit integration for GLB-based NPCs with built-in dialogue, movement along paths, and state machines
  • AvatarShape-based NPCs that resemble Decentraland avatars with wearables for storefronts or display purposes
  • Guidelines for dialog scripting, interactions, and multiplayer considerations across scene types

Quick Start

Install the NPCs skill and follow the included examples to create a sample NPC with dialogue.

Frequently Asked Questions about npcs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create interactive NPCs with dialogue in Decentraland?

To create interactive NPCs with dialogue in Decentraland, you can use the NPC Toolkit for GLB-based characters or the AvatarShape approach for avatar-like entities, both supporting scripted dialog and behavior management.

What is the difference between NPC Toolkit and AvatarShape for Decentraland characters?

NPC Toolkit handles GLB-based characters with built-in dialogue, path movement, and state machines, whereas AvatarShape creates NPCs resembling Decentraland avatars with wearables for display purposes like storefronts.

How do I add state machines and path movement to Decentraland NPCs?

You add state machines and path movement to Decentraland NPCs by integrating the NPC Toolkit, which provides built-in support for GLB-based characters to follow paths and manage behavioral states.

Can I use AvatarShape to display NPCs with wearables in a Decentraland scene?

Yes, you can use AvatarShape to display NPCs with wearables in a Decentraland scene, which is specifically designed to create non-player entities that resemble standard Decentraland avatars for storefronts or display purposes.

What are the multiplayer considerations when scripting NPC dialogue in Decentraland?

When scripting NPC dialogue in Decentraland, multiplayer considerations involve ensuring consistent interactions and behavior across scene types, requiring specific guidelines to manage state and avatar synchronization for all connected players.

Do I need the NPC Toolkit to build non-player characters in Decentraland?

You do not strictly need the NPC Toolkit to build non-player characters in Decentraland, as you can also use the AvatarShape approach, but the toolkit provides built-in state machines and path movement for GLB models.