{"id":19439,"library":"decentraland","title":"Decentraland CLI","description":"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).","status":"active","version":"3.21.0","language":"javascript","source_language":"en","source_url":"https://github.com/decentraland/cli","tags":["javascript","decentraland","cli","dcl","mana","land"],"install":[{"cmd":"npm install decentraland","lang":"bash","label":"npm"},{"cmd":"yarn add decentraland","lang":"bash","label":"yarn"},{"cmd":"pnpm add decentraland","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"runtime requirement (>=16)","package":"node","optional":false},{"reason":"package manager requirement (>=8)","package":"npm","optional":false}],"imports":[{"note":"The CLI is intended to be run via npx, not imported programmatically. The old 'dcl' command was deprecated; use 'decentraland'.","wrong":"npx dcl <command> (old name, no longer supported)","symbol":"CLI (default)","correct":"npx decentraland <command>"},{"note":"Package is ESM-only since v3. Use dynamic import or set type:module in package.json.","wrong":"const cli = require('decentraland')","symbol":"main entry","correct":"const cli = await import('decentraland/dist/index.js')"}],"quickstart":{"code":"npx decentraland init --scene my-scene\ncd my-scene\nnpx decentraland start\n# Opens browser preview at http://localhost:8000\n# After development, deploy:\n# npx decentraland deploy --target peer.decentraland.org\n","lang":"javascript","description":"Creates a new Decentraland scene project, starts local preview server, and shows deploy command."},"warnings":[{"fix":"Replace 'dcl' with 'decentraland' in all commands and scripts.","message":"The CLI command 'dcl' is no longer supported. Use 'decentraland' instead (since v3.0.0).","severity":"breaking","affected_versions":">=3.0.0"},{"fix":"Update your scenes and configurations to use Sepolia endpoints.","message":"Removed support for Goerli test network in favor of Sepolia (since v3.18.0).","severity":"breaking","affected_versions":">=3.18.0"},{"fix":"Use SDK7 for smart wearables/items, or avoid those options in SDK6.","message":"Smart items and smart wearables options removed for SDK6 scenes (since v3.19.0).","severity":"breaking","affected_versions":">=3.19.0"},{"fix":"Use dynamic import() or set 'type': 'module' in your project.","message":"ESM-only release. CommonJS require() no longer works (since v3.0.0).","severity":"breaking","affected_versions":">=3.0.0"},{"fix":"Always test scene deploy on a test catalyst before mainnet.","message":"Preview server uses @dcl/explorer which may have different behavior than production environment.","severity":"gotcha","affected_versions":">=3.16.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Run 'npm install -g decentraland' or use 'npx decentraland' without global install.","cause":"Package not installed globally or missing dependency.","error":"Error: Cannot find module 'decentraland'"},{"fix":"Use 'decentraland' instead of 'dcl'.","cause":"The 'dcl' binary was deprecated in v3.","error":"Command 'dcl' not found"},{"fix":"Update Node.js to version 16 or higher.","cause":"Using older Node.js version.","error":"Error: Node.js version must be >= 16"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}