Decentraland CLI

3.21.0 verified Sat Apr 25 auth: no javascript

CLI tool for developing, building, and deploying Decentraland scenes and worlds. Current stable version: 3.21.0. Released on npm with frequent updates (multiple releases per month). Key differentiators: official tool for Decentraland ecosystem, supports both SDK6 and SDK7 scenes, integrates with Decentraland's decentraland-archipelago and catalyst servers, provides commands for scene creation, preview, deploy, and ACL management. Requires Node >=16 and npm >=8. ESM-only package (no CommonJS require support).

Common errors

error Error: Cannot find module 'decentraland' ↓

cause Package not installed globally or missing dependency.

fix

Run 'npm install -g decentraland' or use 'npx decentraland' without global install.

error Command 'dcl' not found ↓

cause The 'dcl' binary was deprecated in v3.

fix

Use 'decentraland' instead of 'dcl'.

error Error: Node.js version must be >= 16 ↓

cause Using older Node.js version.

fix

Update Node.js to version 16 or higher.

Warnings

breaking The CLI command 'dcl' is no longer supported. Use 'decentraland' instead (since v3.0.0). ↓

fix Replace 'dcl' with 'decentraland' in all commands and scripts.

breaking Removed support for Goerli test network in favor of Sepolia (since v3.18.0). ↓

fix Update your scenes and configurations to use Sepolia endpoints.

breaking Smart items and smart wearables options removed for SDK6 scenes (since v3.19.0). ↓

fix Use SDK7 for smart wearables/items, or avoid those options in SDK6.

breaking ESM-only release. CommonJS require() no longer works (since v3.0.0). ↓

fix Use dynamic import() or set 'type': 'module' in your project.

gotcha Preview server uses @dcl/explorer which may have different behavior than production environment. ↓

fix Always test scene deploy on a test catalyst before mainnet.

Install

npm install decentraland

yarn add decentraland

pnpm add decentraland

Imports

CLI (default)
wrong
```
npx dcl <command> (old name, no longer supported)
```
correct
```
npx decentraland <command>
```
The CLI is intended to be run via npx, not imported programmatically. The old 'dcl' command was deprecated; use 'decentraland'.
main entry
wrong
```
const cli = require('decentraland')
```
correct
```
const cli = await import('decentraland/dist/index.js')
```
Package is ESM-only since v3. Use dynamic import or set type:module in package.json.

Quickstart

Creates a new Decentraland scene project, starts local preview server, and shows deploy command.

npx decentraland init --scene my-scene
cd my-scene
npx decentraland start
# Opens browser preview at http://localhost:8000
# After development, deploy:
# npx decentraland deploy --target peer.decentraland.org