npc-toolkit

Create interactive NPCs with dialogs, animations, and path-following in Decentraland SDK7 scenes.

1|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/stom66/dcl-bowling --skill npc-toolkit-stom66
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: npc-toolkit
Source: https://github.com/stom66/dcl-bowling/tree/main/.cursor/skills/npc-toolkit
Command: npx skills add https://github.com/stom66/dcl-bowling --skill npc-toolkit-stom66

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires dcl-npc-toolkit, @dcl/sdk.

What problem does it solve? Building interactive non-player characters in Decentraland SDK7 scenes requires wiring up activation triggers, dialog UI, animations, and movement logic from scratch. This Skill provides the dcl-npc-toolkit library patterns to create NPCs that converse with players, react to proximity or clicks, play animations, and walk paths without reimplementing that boilerplate. ## Core Features & Use Cases - NPC Creation and Activation: Create CUSTOM (GLB model) or AVATAR (AvatarShape with wearables) NPCs triggered by clicking, pressing E, walking near, or external calls, with configurable cooldowns and react distances. - Dialog System: Build branching conversation trees with questions, up to four buttons per entry, triggered actions, typing effects, audio, and both UI windows and floating speech bubbles. - Animation and Movement: Loop idle animations, play one-shot animations or avatar emotes, and make NPCs walk waypoint paths with speed, duration, looping, and callback controls. - Use Case: Add a quest-giver NPC to a scene that greets players on approach, asks a yes/no question through a dialog window, plays a celebration animation on acceptance, and resumes patrolling a looped path when the conversation ends. ## Quick Start Ask the AI to create an NPC in your Decentraland SDK7 scene using dcl-npc-toolkit that talks to the player with a branching dialog when clicked.

Frequently Asked Questions about npc-toolkit

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

FAQPage Schema
How do I create an NPC in a Decentraland SDK7 scene?▼

Install dcl-npc-toolkit via npm, then call npc.create with a TransformType and an NPCData object containing a type (CUSTOM or AVATAR) and an onActivate function. CUSTOM NPCs need a model path to a GLB file, while AVATAR NPCs use AvatarShape with optional wearables.

How do I add branching dialog with buttons to a Decentraland NPC?▼

Define a Dialog[] script where question entries set isQuestion to true and include a buttons array. Each button needs a label and goToDialog pointing to the next entry by index or name, plus an optional triggeredActions function.

Can Decentraland NPCs use avatar wearables instead of GLB models?▼

Yes, NPCType.AVATAR renders an AvatarShape that accepts wearables URNs, bodyShape, name, and eye, skin, and hair colors without requiring a GLB model. If a GLTF exists on the entity, it is removed and replaced with an AvatarShape.

How do I make a Decentraland NPC walk along a path?▼

Call npc.followPath with a FollowPathData object containing an array of Vector3 points, plus optional speed, totalDuration, loop, and callback fields. The NPC plays its walkingAnim while moving and returns to idle when stopped or finished.

Why is my Decentraland NPC dialog UI not showing?▼

The NPC dialog UI requires registering NpcUtilsUi in your scene's ReactEcs UI tree via ReactEcsRenderer.setUiRenderer. Without this setup, calls to talk() have no visible window to render into.

How do I trigger an NPC action without player interaction?▼

Set onlyExternalTrigger to true so the NPC cannot be activated by clicking, pressing E, or walking near, then call npc.activate(myNPC) from your own code. The activate function works even during cooldown periods.