To build scenes for Decentraland you will need to install the Command Line Interface (CLI).
The CLI allows you to compile and preview your scene in an “off-chain” development environment. After testing your scene locally, you can use the CLI to upload your content to the content server, linking it with your LAND.
Please note: Currently, the Decentraland SDK (bundled with the CLI installation) only supports TypeScript.
The Decentraland CLI is distributed via npm.
Before you Begin
Please install the following dependencies before you install the CLI:
- Node.js (version 8 or later)
To install the CLI
Open the Terminal app and run the following command:
npm install -g decentraland
Once the installation is complete, the
dcl command will be globally available.
Optional: Install Git
Since Windows machines don’t use bash, we recommend that you install git and include git bash. You can otherwise run the CLI commands on the Windows command prompt.
- Download git (you’ll likely want the 64-bit Windows version):
- When prompted choose to install git bash
- When prompted for a default text editor select Use the Nano editor by default
- When prompted to adjust your path environment, select Use Git from the Windows Command Prompt
- When prompted to choose the SSH executable, select Use OpenSSH
- When prompted to choose the HTTPS transport backend, select Use the OpenSSL library
- When prompted to configure the line ending conversions, select Checkout Windows-style, commit Unix-style line endings
- When prompted to configure the terminal emulator to use with Git Bash select Use MinTTY
- On the final installation screen select the following options
- Enable file system caching
- Enable Git Credential Manager
- Enable symbolic links
Update the CLI on any platform
To update the CLI to the latest supported version, we recommend first uninstalling the CLI and then reinstalling a fresh version. To do this, run the following commands:
// uninstall npm rm decentraland -g // install npm install -g decentraland
Update the SDK version of a scene
If your CLI is up to date, the new projects you create with it will use the latest version of the SDK.
The SDK version used by your existing projects doesn’t change by updating the CLI. You need to manually update the SDK version in the projects.
Note: Checking the SDK version you have installed using
npmwon’t tell you what version of the SDK is being used when previewing a specific scene.
To update the version of the Decentraland SDK used by a project:
- Open the file
package.jsonin the project folder.
In this file, look for the field
- If the value is
latest, keep it.
- If the version points to a number or a build that isn’t the latest version of the SDK, change it to
- If your project is a static XML scene then you won’t find this field. Instead, set the field
- If you can’t find the field
decentraland-ecs, but do find the field
decentraland-api, then your project is written with a deprecated version that’s older than
5.0. Create a new project with the CLI and migrate the content manually to it.
- If the value is
- Delete the file
package-lock.jsonand the folder
node-modulesfrom the project.
- Run the scene preview with
dcl start. All the dependencies should be automatically reinstalled, according to the versions listed in