This site contains the documentation for a deprecated version of the Decentraland SDK. For the latest version visit
Hello! Please choose your
desired language:

Creating your first scene

In Decentraland, a scene is the representation of the content of an estate/LAND. All scenes are made up of entities, which represent all of the elements in the scene and are arranged into tree structures, very much like elements in a DOM tree in web development.

Install the CLI

Make sure you first install the CLI tools. In Mac OS, you do this by running the following command:

npm install -g decentraland

See the Installation Guide for more details and specific instructions for Windows and Linux systems.

Create a default scene

Use our CLI tool to automatically build the initial boilerplate scene. To do so:

  1. Create a new folder where you want to create the scene
  2. Open Terminal in Mac or Command prompt in Windows and run the following command in the folder you just created:

    dcl init

The dcl init command creates a Decentraland project in your current working directory containing a scene.

The default scene is defined in a TypeScript file featuring an example with a door that can be opened. The scene features a basic state and handles click events.

See scene contents for an overview of the default files that are created in your scene.

Clone a sample scene

Instead of creating a new scene, you can clone one of the existing sample scenes and use that as a starting point.

To do so:

  1. Go to sample scenes
  2. Find a sample you like and open the Code link to go to its GitHub repo.
  3. From there you can either:
    1. Fork the repo to start working on your own version of it.
    2. Click Clone or Download and select to download it as a .zip file.

Preview your scene

To preview your rendered scene locally, run the following command on the scene’s main folder:

dcl start

Every time you make changes to the scene, the preview reloads and updates automatically, so there’s no need to run the command again.

For more about what you can see in a scene preview, and instructions for how to run a preview of a remote scene, see preview your scene.

Edit your scene

To edit scenes, we recommend using a source code editor like Visual Studio Code or Atom. An editor like this helps you create scenes a lot faster and with less errors, as it marks syntax errors, autocompletes while you write and even shows you smart suggestions that depend on the context that you’re in. With Visual Studio Code you can even click on an object to see the full definition of its class.

  • You create the logic of your scene by editing the Scene.tsx file.
  • You define scene properties, like the parcels it covers or owner information, in the scene.json file.

See the development guide for simple instructions about adding content to your scene.

Publish your scene

Once you’re done creating the scene and want to upload it to your LAND, see publishing.