scene-runtime

Execute asynchronous operations and retrieve remote data in Decentraland SDK7 scenes.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Developers need a concise reference to access Decentraland SDK7 runtime APIs for async tasks, networking, timers, realm data, and player-restricted actions, without digging through scattered docs.

Core Features & Use Cases

  • Provides guidance on using executeTask for async work, fetch and signedFetch for HTTP, WebSocket communication, timers via the SDK, and retrieving scene and realm information.
  • Shows how to perform restricted player actions such as moving the player, teleporting, opening URLs, and interacting with NFTs.
  • Includes testing patterns with the @dcl/sdk/testing framework for reliable scene validation.

Quick Start

Use the scene-runtime skill to fetch world time and log it in the console.

Frequently Asked Questions about scene-runtime

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

FAQPage Schema
How do I fetch remote data in a Decentraland scene?

Fetch remote data in a Decentraland SDK7 scene by using executeTask to run asynchronous operations and calling fetch or signedFetch for HTTP requests. This approach respects the engine's single-threaded execution model while retrieving external payloads.

Can I use WebSockets for real-time networking in Decentraland scenes?

WebSockets can be used for real-time networking in Decentraland SDK7 scenes by wrapping the connection logic inside executeTask. This ensures the asynchronous WebSocket communication runs correctly alongside the engine's single-threaded execution model.

How do I teleport or move a player in a Decentraland SDK7 scene?

Teleport or move a player in a Decentraland SDK7 scene by invoking the RestrictedActions APIs. These APIs allow scenes to execute restricted player actions such as teleporting, opening URLs, and interacting with NFTs.

What is the best way to run timers in Decentraland SDK7?

The best way to run timers in Decentraland SDK7 is by using the SDK timers module. This module provides the necessary functions to schedule and manage time-based asynchronous operations within the scene's execution lifecycle.

Does Decentraland SDK7 support testing scene async and networking logic?

Decentraland SDK7 supports testing scene async and networking logic by using the @dcl/sdk/testing framework. This framework provides testing patterns that allow developers to validate scene behavior and ensure reliable execution of runtime APIs.