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.
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.
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.
To debug any issues, we encourage that you post issues to Stack Overflow, using the tags
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:
Install it as an npm package. Run this command in your scene’s project folder:
npm install decentraland-ecs-utils
Import the library into the scene’s script. Add this line at the start of your
game.tsfile, or any other TypeScript files that require it:
import utils from "../node_modules/decentraland-ecs-utils/index"
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:
- Build a scene in the Decentraland Builder and export it, together with all its assets, to keep working on it with the SDK.
- Download all the 3D assets available in the Builder from this repo
- Google Poly
- SketchUp 3D Warehouse
- Thingiverse (3D models made primarily for 3D printing, but adaptable to Virtual Worlds)
Note: Models must be in the supported
.glbformats, 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.
Here are some examples submitted from our Hackathon back in June that you can take inspiration from…
To see our official example scenes, with links to their code, see scene examples.
- 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.