skills.rest
decentraland
decentralandOFFICIAL
Explore all skills by this author →
Website𝕏@decentralandGitHub

player-avatar

Read and control live player avatars in Decentraland scenes.

3|Updated Apr 13, 2026
Search Tags:#ecs#player#avatar#attachment#teleport#emote
One-click install
npx skills add https://github.com/decentraland/sdk-skills --skill player-avatar-decentraland
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: player-avatar
Source: https://github.com/decentraland/sdk-skills/tree/main/player-avatar
Command: npx skills add https://github.com/decentraland/sdk-skills --skill player-avatar-decentraland

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

The live player in a Decentraland scene. Read player position (Transform on engine.PlayerEntity), player profile (getPlayer, isGuest), trigger emotes (triggerEmote, triggerSceneEmote), read equipped wearables (AvatarEquippedData.onChange), attach objects to avatars (AvatarAttach with anchor points), hide avatars or disable passports in zones (AvatarModifierArea), adjust locomotion speed (AvatarLocomotionSettings), teleport the player (movePlayerTo), and listen for scene entry/exit (onEnterScene/onLeaveScene). Use when the user wants player position, player profile, emotes, wearables, attaching items to players, or avatar zones. Do NOT use for NPC characters (see npcs), wallet/blockchain checks (see nft-blockchain), freezing player movement (see advanced-input for InputModifier), or camera mode (see camera-control).

Core Features & Use Cases

  • Read and monitor the live player position and transform data.
  • Read and react to player profile data (name, wallet, isGuest).
  • Attach 3D objects to a player's avatar at defined anchor points.
  • Trigger built-in or custom emotes on the local or remote avatars.
  • Modify avatar appearance and attachment behavior within zone-based rules.
  • Teleport or move the player using safe, scene-bounded methods.
  • React to scene entry/exit events for onboarding or cleanup.

Quick Start

Install the player-avatar skill and use its APIs to read and manipulate the local player's avatar in your scene.

Frequently Asked Questions about player-avatar

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

FAQPage Schema
How do I read the live player position in a Decentraland scene?▼

To read the live player position in a Decentraland scene, access the Transform component on engine.PlayerEntity. This provides real-time spatial data for in-scene interactions and player tracking.

How do I attach 3D objects to a player avatar in Decentraland?▼

You attach 3D objects to a player avatar using the AvatarAttach component with defined anchor points. This allows items to dynamically follow and align with the live player's movements.

Can I trigger emotes on player avatars within a Decentraland scene?▼

You can trigger emotes on player avatars within a Decentraland scene using the triggerEmote and triggerSceneEmote APIs. These functions initiate built-in or custom avatar animations.

How do I teleport a player to a different location in a Decentraland scene?▼

To teleport a player in a Decentraland scene, use the movePlayerTo API. This method safely moves the player to a new position within scene boundaries.

How do I hide avatars or disable passports in specific zones?▼

You hide avatars or disable passports in specific zones by defining an AvatarModifierArea. This component applies localized rules to modify avatar appearance and behavior upon entry.

When should I not use the player-avatar APIs in Decentraland?▼

Do not use the player-avatar APIs for NPC characters, wallet or blockchain checks, freezing player movement, or camera mode. Use npcs, nft-blockchain, advanced-input, or camera-control instead.

Related Skills

Explore More Software Engineering Skills→
dcl-regenesislabsdcl-regenesislabs

add-interactivity

Add click handlers, hover effects, and raycasting to Decentraland scene entities.

Official
Intermediate
atomicojsatomicojs
1.3k

atomico-hooks-effects

Coordinate Atomico hook side effects across web component lifecycle callbacks.

Official
Intermediate
dcl-regenesislabsdcl-regenesislabs

advanced-input

Manage pointer lock, input polling, and player movement restrictions in Decentraland scenes via InputAction and InputModifier.

Official
Intermediate
ever-oliever-oli
3

solana

Query Solana blockchain data with USD pricing via Python CLI.

Community
Advanced