decentraland

library3.21.0jsnpmunverified

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).

devops aws

npm install decentraland

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · DECENTRALAND

decentraland

devopsjavascriptv3.21.0

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

CLI (default)

✓ npx decentraland <command>

✗ npx dcl <command> (old name, no longer supported)

The CLI is intended to be run via npx, not imported programmatically. The old 'dcl' command was deprecated; use 'decentraland'.

main entry

✓ const cli = await import('decentraland/dist/index.js')

✗ const cli = require('decentraland')

Package is ESM-only since v3. Use dynamic import or set type:module in package.json.

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

decentraland --version

Debug

Known issues

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

fix

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

affects: >=3.0.0

breakingRemoved support for Goerli test network in favor of Sepolia (since v3.18.0).

fix

Update your scenes and configurations to use Sepolia endpoints.

affects: >=3.18.0

breakingSmart 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.

affects: >=3.19.0

breakingESM-only release. CommonJS require() no longer works (since v3.0.0).

fix

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

affects: >=3.0.0

gotchaPreview server uses @dcl/explorer which may have different behavior than production environment.

fix

Always test scene deploy on a test catalyst before mainnet.

affects: >=3.16.0

Errors

Common errors & fixes

Error: Cannot find module 'decentraland'

Package not installed globally or missing dependency.

fix

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

Command 'dcl' not found

The 'dcl' binary was deprecated in v3.

fix

Use 'decentraland' instead of 'dcl'.

Error: Node.js version must be >= 16

Using older Node.js version.

fix

Update Node.js to version 16 or higher.

Upgrade

Version history

3.21.0latest on npm

Audit

Dependencies

noderequiredruntime requirement (>=16)

npmrequiredpackage manager requirement (>=8)

Agent activity

13 hits · last 30 days

node

Resources

githubhttps://github.com/decentraland/cli ↗

packagehttps://www.npmjs.com/package/decentraland ↗

homepagehttps://decentraland.org ↗