CLI Installation Guide
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)
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.
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.
Run the following command on the scene folder:
npm i decentraland-ecs@latest
You can confirm that it worked by checking the package.json
file for the scene, and looking for the decentraland-ecs
version there.
Troubleshooting
If you get error messages when attempting to install the CLI, check this thread.