Development workflow

This document outlines the steps recommended for developing a scene for Decentraland, from ideation to publishing and beyond.

• Install the Creator Hub
• Design your experience
• Where to publish
• Templates and examples
• Art assets
• Run a local preview
• Publish to the test server
• Publish to Decentraland
• Promote
• Iterate
• Giving back

Install the Creator Hub #

Make sure you have the Decentraland Creator Hub installed.

• Installation Guide .

If you intend to work with code, also make sure you install Visual Studio Code .

Design your experience #

Think about how much space you need to take up, what kind of distribution, what kinds of mechanics you want players to be able to carry out, etc. The following documents can serve as a guide:

• UX & UI Guide
• Design constraints for games
• Scene MVP guidelines

Where to publish #

In Decentraland, content is published to adjacent plots of land in a finite amount of space. Players can freely walk from one to the other. Each scene is its own contained little world, items from one scene can’t extend out into another scene, and the code for each scene is sandboxed from all others.

Permission to publish to each of these is controlled via tokens. You don’t need land to develop a scene, but you will need access to land once you’re ready to publish.

Alternatively, you have the option to publish to Decentraland Worlds , which are self-contained and isolated scenes.

The following options are available:

• Rent LAND
• Purchase LAND
• Obtain permissions from a land owner
• Publish to a Decentraland World, see worlds to learn more.

See Publishing options for more details.

Templates and examples #

When creating a new scene, choose amongst several base template scenes that include some basic code and 3d models. Use these to get started faster.

• Example scenes : here you can find a large collection of example scenes, each showcasing different mechanics that you can borrow. You can also clone any of these scenes and use it as a starting point.
• Helper libraries : these can simplify many common tasks.

Art assets #

If you’re an experienced artist or you have access to someone who is, you can create custom .gltf or .glb models for your scene. See 3D model essentials for tips on how to create 3D models for Decentraland.

There are many sources to obtain free or paid art assets. For example:

• SketchFab
• Clara.io
• Archive3D
• SketchUp 3D Warehouse
• Thingiverse (3D models made primarily for 3D printing, but adaptable to Virtual Worlds)
• ShareCG
• CGTrader

You can also use Generative AI tools to generate your own 3D models. Check out:

• Meshy
• Luma AI
• TRipo3D

Run a local preview #

To run a preview of your scene, open a Visual Studio Code window on your project’s root folder and click the Preview button on the Decentraland tab.

• Preview your scene ) for more details.
• Check the Debug a scene for tips on how to debug any issues.

💡 Tip: If you get stuck trying to debug an issue, visit the Decentraland Discord server to get help from other developers.

You can also find help in the Decentraland DAO Server .

Optional: Your scene`s mechanics might rely on a 3rd party server to carry out player validations, permanent data storage, or other functionalities. See 3rd party servers

Publish to the test server #

Deploy your scene to a test server. This server is not private but only accessible via a specific URL, so players won’t bump into your tested scene involuntarily.

• Publish to the test server .

Publish to Decentraland #

Once you’re happy with your scene, it’s time to publish it to the production environment. There all players will have access to it if they visit the scene’s coordinates.

• Publish to prod .

📔 Note: Before you do, check that your scene has all the necessary metadata: name, description, a preview image, spawn points. See scene metadata for details.

Promote #

Once your scene is out there, you want to give it visibility and have people visit it. There are a number of ways you can shine a spotlight on it:

• Share it on social media
• Events page : create an event to promote your scene
• Places page : ensure your scene is well positoned here, encourage players to vote your scene to get more visibility

Iterate #

One great advantage of Decentraland is that you can easily iterate over your scenes. Measure your scene’s success with players, then keep publishing changes as you perfect the experience for your players.

• Scene analytics .

Giving back #

Decentraland is a community project, the community of creators learns together and leverage each other’s creations. Consider the following:

• Join the Decentraland Discord server or the Decentraland DAO Server and help other developers in need of advice.
• Share your scene’s code as an open source repo on GitHub.
• Build a minimal example to share a specific reusable mechanic, as an open source repo on GitHub.
• Make a PR to the Examples Repository to include your scenes.
• Write a library that encapsulates the complexity of common challenges, so others can overcome them easily.