Deploying to Genesis City

Deploy to specific parcels you own or have permission to deploy to.

Use the
/deploy
command to deploy. It runs

npx @dcl/sdk-commands deploy

and handles the full process:

Build the scene
Upload assets to IPFS
Deploy to the specified parcels
Requires a wallet with LAND or deployment permissions

Deploying to a World instead? See the
deploy-worlds
skill for Worlds deployment (personal spaces using DCL NAMEs or ENS domains).

Pre-Deployment Checklist

Before deploying, verify:

scene.json is valid:
- ```
ecs7: true
```
  and
```
runtimeVersion: "7"
```
- Correct
```
parcels
```
  matching your LAND (for Genesis City)
- Valid
```
base
```
  parcel
- ```
main: "bin/index.js"
```
Code compiles:
bash
```
npx tsc --noEmit
```
Scene previews correctly: Use the
```
preview
```
tool to verify the scene works (or
```
npx @dcl/sdk-commands start
```
manually, optionally with
```
--web
```
to preview in the Bevy Web browser client). Test with multiple browser tabs to verify multiplayer behavior.
Dependencies installed:
bash
```
npm install
```
Assets are within limits — see the optimize-scene skill for full limit formulas per parcel count (triangles, entities, materials, textures, height). Keep scene load time under 15 seconds by optimizing assets.
.dclignore
covers all working files — Blender/FBX sources, concept art, spreadsheets, markdown docs, etc. must not be uploaded. See the
```
.dclignore
```
section below.

Deployment Process

Using CLI

bash

# Build first
npx @dcl/sdk-commands build

# Deploy (will open browser for wallet connection)
npx @dcl/sdk-commands deploy

Using Creator Hub

Open Creator Hub
Select your scene
Click "Publish"
Connect wallet
Confirm transaction

scene.json for Deployment

json

{
  "ecs7": true,
  "runtimeVersion": "7",
  "display": {
    "title": "My Awesome Scene",
    "description": "A description for the marketplace",
    "navmapThumbnail": "images/thumbnail.png"
  },
  "scene": {
    "parcels": ["0,0", "0,1"],
    "base": "0,0"
  },
  "main": "bin/index.js"
}

display.navmapThumbnail

sets the image shown for the scene on the Genesis City map — always provide one, and write a clear

display.description

for discovery.

Spawn Points

Configure where players appear when entering the scene:

json

{
  "spawnPoints": [
    {
      "name": "spawn1",
      "default": true,
      "position": { "x": [1, 5], "y": [0, 0], "z": [2, 4] },
      "cameraTarget": { "x": 8, "y": 1, "z": 8 }
    }
  ]
}

Position ranges (e.g.,

[1, 5]

) spawn players randomly within the range. Use

cameraTarget

to orient the player's camera on spawn.

.dclignore — Exclude Files from Upload

The

.dclignore

file, always at the project root, lists files and patterns that are NOT uploaded to the content server when deploying. Everything in the project folder that isn't matched by

.dclignore

gets uploaded, and the uploaded total counts against the per-parcel MB limits — so only files the running scene actually needs should be deployed.

Format: one glob pattern per line. The default from scene templates:

.*
package-lock.json
yarn-lock.json
build.json
export
tsconfig.json
tslint.json
node_modules
*.ts
*.tsx
.vscode
Dockerfile
dist
README.md
*.blend
*.fbx
*.zip
*.rar
*.md
src

Keep it up to date as the project grows. Whenever working files exist in the project — Blender or other 3D source files, draft models, concept art, PSDs, spreadsheets, markdown notes, reference photos — add them (or their extensions) to

.dclignore

so the deployed scene stays as light as possible. When creating or editing a scene, add these patterns proactively; don't wait for the deploy to fail. Common additions:

*.blend
*.blend1
*.fbx
*.psd
*.kra
*.xcf
*.md
*.csv
*.xlsx
drafts
concept-art
reference

If a deploy fails with "Scene is too large", checking

.dclignore

is the first step: working files are often the bulk of the excess, and excluding them reduces upload size with zero impact on the scene.

Never ignore files the scene needs at runtime:

bin/index.js

scene.json

assets/

(composites, .glb models, textures, sounds, video), thumbnails referenced in

scene.json

, or any file path referenced in code. Note the default ignores

*.ts

src

— only the compiled

bin/index.js

runs, so source code is never needed in the upload.

Troubleshooting

Error	Cause	Solution
"You don't have permission to deploy"	Wallet doesn't own the target LAND/parcels	Verify LAND ownership on the marketplace, or get deployment permissions from the LAND owner
"Scene is too large"	Assets exceed parcel size limits	First add all working files (Blender/FBX sources, concept art, docs) to `.dclignore` — see the `.dclignore` section above. Then check triangle count, file sizes, and texture counts against the limits. See optimize-scene skill
Wallet connection fails	Browser popup blocked or MetaMask locked	Allow popups, unlock MetaMask, refresh and try again
"Invalid scene.json"	Missing required fields or malformed JSON	Verify `ecs7: true` , `runtimeVersion: "7"` , valid `parcels` array, and `main: "bin/index.js"`
Deploy succeeds but scene is empty	`main` field doesn't point to compiled output	Ensure `main` is `"bin/index.js"` and run `npx @dcl/sdk-commands build` first
Catalyst rejection	Content violates Decentraland content policies	Review content guidelines at docs.decentraland.org

Genesis City vs Worlds

	Genesis City	Worlds
Requirement	Own LAND parcels	Own DCL NAME or ENS domain
Parcel limits	Enforced (entity/triangle budgets per parcel)	Not constrained by LAND
Visibility	Shown on the Genesis City map	Listed on Places page (opt-out available)
Deploy target	Default Catalyst network	`--target-content https://worlds-content-server.decentraland.org`
Best for	Permanent installations, high-traffic scenes	Testing, personal spaces, events

Deploying to a World instead? See the deploy-worlds skill.

Scene Tipping

Let visitors send MANA tips to the scene creator. Add a

creator

field to

scene.json

json

{
  "creator": "0x1234567890123456789012345678901234567890"
}

When set, a piggy bank icon appears in the top-left for visitors. Clicking it opens a MANA tip modal. If the address is linked to a Decentraland NAME, the name is shown in the modal. Creators receive an in-app notification for each tip.

Can also be configured via Creator Hub → scene Settings → Details → Creator wallet address.

deploy-scene

NPX Install

SKILL.md Content

Deploying to Genesis City

Pre-Deployment Checklist

Deployment Process

Using CLI

Using Creator Hub

scene.json for Deployment

Spawn Points

.dclignore — Exclude Files from Upload

Troubleshooting

Genesis City vs Worlds

Scene Tipping