Hello! Please choose your
desired language:
Dismiss

Game Jam survival guide

The Decentraland September Game Jam (previously ‘Hackathon’) will take place from September 16th to September 30th. This Survival Guide is all you need to get started and get creative in the Metaverse.

Install the CLI and get started

See the Docs Home for first steps to get started.

Tutorials

Read our tutorials for detailed instructions for building basic scenes.

Engage with other Jammers

Visit Discord, join a lively discussion about what’s possible and how!

You can also enrol in free courses at the Decentraland University channel.

Team up

While you’re welcome to work on a project by yourself, the Game Jam experiences are often team efforts. Why not reach out to friends who might be a good match?

You can also check this spreadsheet to post searches for team mates or find teams to join.

Debug

To debug any issues, we encourage that you post issues to Stack Overflow, using the tags decentraland or decentraland-ecs.

You can also ask in Discord. The #developers channel is for questions regarding code, the #building channel is for questions regarding 3D models and art.

The Utils library

The Decentraland ESC Utils library includes a number of helper methods that make it easier to carry out a lot of common use cases.

To use any of the helpers provided by the Utils library:

  1. Install it as an npm package. Run this command in your scene’s project folder:

     npm install decentraland-ecs-utils
    
  2. Import the library into the scene’s script. Add this line at the start of your game.ts file, or any other TypeScript files that require it:

     import utils from "../node_modules/decentraland-ecs-utils/index"
    
  3. In your TypeScript file, write utils. and let the suggestions of your IDE show the available helpers.

Read the full documentation of the Utils library here

3D Art Assets

A good experience will have great 3D art to go with it. If you’re keen on creating those 3D models yourself, you’re encouraged to, see the 3D Modeling section of our docs for more info. But if you prefer to focus on the coding or game design side of things, you don’t need to create your own assets!

Here are a few tips to get great 3D models that you can use in a Decentraland scene:

Note: Models must be in the supported .gltf or .glb formats, and must have a number of triangles, textures and materials that adhere to the scene limitations. If getting models from a third party site, pay attention to the licence restrictions that the content you download has.

Project Examples

Here are some examples submitted from our Hackathon back in June that you can take inspiration from…

Archery Casino

Mystery Castle

Lightcore

Dexcalibur

Chipassic Park

To see our official example scenes, with links to their code, see scene examples.

Competition guidelines

  • You don’t need to own land to participate. You can choose to submit the code of the scene and to allow us to deploy it to an available land pool. You can otherwise decline this and choose to deploy it to land you or a partner owns.
  • We recommend creating scenes that have a reasonably small LAND footprint, as LAND is scarce and expensive. In general, we recommend a maximum size of 3x3 parcels.
  • To keep a level playing field, the scenes submitted for the Game Jam should at least have a significant part of them developed during the two weeks of the competition. When submitting your scene, you should clarify if you reused any prior work as part of the scene.
  • We strongly encourage submitted scenes to be interactive. We consider a scene to be interactive if the player’s actions (clicking, walking, etc) can have some kind of effect on the content. A scene is also valuable if it features animations from 3D models or connects to external APIs.
  • You will retain all the rights to your assets and code after submitting. We’ll be able to share images or videos of your scene, and we’ll be able to deploy it as-is to the land pool if you choose to allow us. We won’t be able to alter or copy assets or parts of your scene for our own purposes.
  • If your scene consists of a game with rules that aren’t self-evident, you should provide instructions, either in-world or in the submit form.

Other useful information