Content Creators
Preview your scene

Preview your scene

Once you have built a new scene or downloaded a scene example you can preview it locally.

Using the editor #

To run a scene preview using the Decentraland Editor:

Make sure you’ve installed the Decentraland editor .

  1. Open your scene’s folder using Visual Studio Code.

    Note: The Visual Studio window must be at the root folder of the scene project.

  2. Open the Decentraland Editor tab on Visual Studio. Note that the bottom section lists all of your project’s currently installed dependencies.

  3. Click the Run Scene button.

    This opens a new tab in Visual Studio Code, running the Decentraland scene, just like in a web browser tab.

Optionally click Open in browser, over the top margin of the tab to run the preview in a web browser window.

Using the CLI #

Before you begin #

Please make sure you first install the CLI tools by running the following command:

npm install -g decentraland

See the Installation Guide for more details instructions.

Preview a scene #

To preview a scene run the following command on the scene’s main folder:

dcl start

Any dependencies that are missing are installed and then the CLI opens the scene in a new browser tab automatically. It creates a local web server in your system and points the web browser tab to this local address.

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

📔 Note: Some scenes depend on an external server to store a shared state for all players in the scene. When previewing one of these scenes, you’ll likely have to also run the server locally on another port. Check the scene’s readme for instructions on how to launch the server as well as the scene.

Parameters of the preview command #

You can add the following flags to the dcl start command to change its behavior:

  • --port to assign a specific port to run the scene. Otherwise it will use whatever port is available.
  • --no-debug Disable the debug panel, that shows scene and performance stats
  • --no-browser to prevent the preview from opening a new browser tab.
  • --w or --no-watch to not open watch for filesystem changes and avoid hot-reload
  • --c or --ci To run the parcel previewer on a remote unix server
  • --web3 Connects preview to browser wallet to use the associated avatar and account
  • --skip-version-checks Avoids checking if the scene’s ECS library version matches your CLI version, and launches the preview anyway.
  • --desktop-client Runs the preview in the Decentraland Desktop client
📔 Note: To preview old scenes that were built for older versions of the SDK, you must set the corresponding version of decentraland-ecs in your project’s package.json file.

Upload a scene to decentraland #

Once you’re happy with your scene, you can upload it and publish it to Decentraland, see publishing ) for instructions on how to do that.

You can also upload a preview to a free 3rd party server, see instructions here .

Preview scene size #

The scene size shown in the preview is based on the scene’s configuration. By default, the scene occupies a single parcel (16 x 16 meters).

If you’re building a scene to be uploaded to several adjacent parcels, you can edit the scene.json file to reflect this, listing multiple parcels in the “parcels” field. Placing any entities outside the bounds of the listed parcels will display them in red.

 "scene": {
    "parcels": [
    "base": "0,0"

You can also change the coordinates by running the dcl coords command from the command line, this is especially useful on large scenes with many parcels. See set parcels via the command line for more details.

💡 Tip: While running the preview, the parcel coordinates don’t need to match those that your scene will really use, as long as they’re adjacent and are arranged into the same shape. You will have to replace these with the actual coordinates later when you deploy the scene .

Run preview in Desktop #

To run a preview scene in the Desktop native client, instead of in the web browser:

  1. Make sure you have downloaded and installed the Windows or Mac desktop client.

  2. Run the preview with:

    dcl start --desktop-client

  3. Copy the URL provided by the console output under Desktop Client and paste in your browser.

    Note: The Browser might ask you for permission to open an external executable: Decentraland. Select Open.

  4. You’ll see the following screen. Check that the URL is correct, then click Continue to launch the preview.

    If you need to manually add anything to the URL, to change the default way the scene runs, tick the box Add custom URL parameters and write those in the dialog below.