player-avatar

Read player data, attach items, trigger emotes, and control avatars in Decentraland SDK7 scenes.

Updated Sep 11, 2026
One-click install
npx skills add https://github.com/ansonj-dev/neon-reverse --skill player-avatar-ansonj-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: player-avatar
Source: https://github.com/ansonj-dev/neon-reverse/tree/main/agent/skills/player-avatar
Command: npx skills add https://github.com/ansonj-dev/neon-reverse --skill player-avatar-ansonj-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @dcl/sdk, and includes references (resource) components.

What problem does it solve? Decentraland SDK7 scene developers frequently hit silent failures when manipulating the player: mutating the player Transform does nothing, held items parented to the wrong entity lose camera pitch, and custom emotes fail in production due to file naming rules. This Skill provides verified patterns for every player and avatar interaction so these bugs are avoided. ## Core Features & Use Cases - Player Data & Position: Read the player Transform, profile (name, wallet, guest status), and fetch off-scene avatar appearances from the catalyst /lambdas/profile endpoint. - Attachments & Held Items: Attach cosmetics via AvatarAttach anchor points, or parent aim-sensitive items to engine.CameraEntity and body-fixed items to engine.PlayerEntity with clear guidance on which to choose. - Emotes, Teleport & Modifiers: Trigger built-in and custom _emote.glb emotes with lifecycle detection, teleport with movePlayerTo, adjust locomotion via AvatarLocomotionSettings, and hide avatars or nametags with AvatarModifierArea. - Use Case: Build a multiplayer game where players carry a first-person flashlight, trigger a wave emote on puzzle completion, and get teleported into a final room while nametags are hidden. ## Quick Start Ask the assistant to write Decentraland SDK7 code that teleports the player to a position and attaches a hat to their avatar using this skill.

Frequently Asked Questions about player-avatar

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

FAQPage Schema
How do I teleport the player in a Decentraland SDK7 scene?

Use movePlayerTo from ~system/RestrictedActions with a newRelativePosition and optional cameraTarget, avatarTarget, and duration. Setting Transform on engine.PlayerEntity is silently ignored. The scene must declare the ALLOW_TO_MOVE_PLAYER_INSIDE_SCENE permission.

How do I attach an item to a player avatar in Decentraland SDK7?

Use AvatarAttach with an anchorPointId for cosmetic items like hats or backpacks. For aim-sensitive held items like guns, parent the entity to engine.CameraEntity instead, since bone anchors inherit animation jitter and PlayerEntity loses camera pitch.

Why does changing the player Transform do nothing in Decentraland?

The player Transform is engine-controlled and read-only from scene code, so mutations compile and run but are silently ignored. Use movePlayerTo for teleports, Physics for forces, and InputModifier to restrict movement.

How do I get avatar wearables for a wallet address not in the scene?

Fetch https://peer.decentraland.org/lambdas/profile/<address> and read json.avatars[0].avatar for bodyShape, wearables, and colors. Pass raw Color3 values to AvatarShape skinColor, hairColor, and eyeColor, and handle the empty avatars array for unknown addresses.

Why does my custom scene emote work in preview but fail after deployment?

The emote GLB file must end with _emote.glb, case-insensitive. Preview is permissive but the deployed runtime rejects files without the suffix, so rename files like SnowballThrow.glb to SnowballThrow_emote.glb before deploying.

How do I detect when an emote finishes playing in Decentraland?

Subscribe with AvatarEmoteCommand.onChange on the player entity and check the state field for ES_STARTED, ES_FINISHED, or ES_INTERRUPTED. Default absent state to ES_STARTED since older clients omit it, and avoid hard-blocking gameplay on the finish signal.