Decentraland Awesome Repository

Welcome to the Decentraland Awesome repository!

This is a large collection of example scenes, libraries, and full tutorials meant to help you build scenes for Decentraland!

If you can think of an example that is easy to understand and covers valuable topics that aren't covered here, you're encouraged to create a Pull Request and contribute!

If something doesn’t work, please file an issue.

Key Concepts

For a fully comprehensive introduction, we recommend you read the following topics from the Documentation:

• Entities & Components
• Systems
• Custom Components
• Querying Component
• Files in a Scene

See the Decentraland documentation to find more specific information about various other.

Examples

Wearables

Add-ons

Example	Thumbnail	Description
Feet		Contains all the add-ons of the Feet category: Left base, Right base, Left shoelaces, Right shoelaces, Left sole, Right sole, Left toecap, Right toecap, Left toecap sole and Right toecap sole.
Female Lower body		Contains all the add-ons of the female Lower body category: Waist, Left thigh, Right thigh, Left knee, Right knee, Left leg and Right leg.
Female Upper body		Contains all the add-ons of the male Lower body category: Waist, Left thigh, Right thigh, Left knee, Right knee, Left leg and Right leg.
Male Lower body		Contains all the add-ons of the female Upper body category: Torso, Neck, Left arm, Right arm, Left elbow, Right elbow, Left forearm and Right forearm.
Male Upper body		Contains all the add-ons of the male Upper body category: Torso, Neck, Left arm, Right arm, Left elbow, Right elbow, Left forearm and Right forearm.
Skin		Contains the original body parts with the skin texture of all the previous categories, this is useful if you want to build a wearable with short sleeves or with certain parts exposed such as a thigh, knee, etc.

Essentials

Basics

Example	Thumbnail	Description
Sliding Door		Use the Utils library to shift the position of a door gradually. Clicks on the door toggle it from open to closed.
Door		Use the Utils library to rotate a door gradually. Clicks on the door toggle it from open to closed.
Puffer		Use the Utils library to scale items and delay actions. Also include 3D models and sounds.
Button events		A simple example of each way in which players can use button events to interact with the scene. Each shape's color is activated by interacting with it in a special way.
Jukebox		Play different songs by pressing buttons on a jukebox.
Hypno Wheels		A first encounter with Systems, Custom Components and Component Groups. Check out the related tutorial.)
Shark Animation		Control animations on a 3D model. Toggle them on or off when clicking on the model.
Gnark Patrolling		A character walks along a fixed path, using lerp over each segment of the path. If you approach it, it will switch states to yelling at you. Check out the related tutorial.
Hummingbirds		A new bird spawns every time you click a tree. Each bird moves on its own to random positions.
Smoke		Use planes to create a particle system that simulates smoke rising.
Dance Floor		Combines animations, sound, and tiles on the floor that randomly change color to the beat.
Laser-Ray Casting		Use ray casting to trace a line in space and check for intersections. Cubes change material when hit by the laser. They also change when being pointed at by the player.
UV Map		A simple scene that shows a spritesheet animation of a robot talking. The different expressions of the robot are all stored in the same image.
Swimming in Circles		Move a shark along the segments of a curve to swim in circles.
Block Dog		A simple AI character that randomly chooses what action to take: follow you, sit or remain idle. Tell it to sit or stand up by clicking it, or tell it to drink water by clicking its bowl.
Workspaces		Use workspaces to preview multiple adjacent scenes/portable experiences at onces and see how they interact.

Game Mechanics

Example	Thumbnail	Description
Atari Arcade Cabinets		Arcade cabinets containing variations of the classic Breakout game.
Avatar Swap		Swapping out the default avatar for another character model.
Beer Dispenser		A beer dispenser that uses P2P messaging so that you can pour beer for yourself and friends.
Coconut Shy		A coconut shy built using cannon.js physics engine.
Coin Pickup		Coins are picked up once the player walk over them.
Enemy Spawner		Spawning enemy spaceships from various shaped portals.
Grab Objects		Click an item to hold it and drop it somewhere else in the scene.
Grab Objects Advanced		Click an item to hold it in the air and carry it or toss it around the scene using physics.
Inflatable Punch Bag		An inflatable-punch-bag scene built using cannon.js physics engine.
Item Pickup		Various items like health packs and ammo that are picked up when players walk over them.
Key Binding		Using emote events as key bindings for switching between multiple paint colors, which can be expanded for something like weapon switching.
Light Bounce Puzzle		Reflecting a ray off of multiple objects at arbitrary angles.
Mirror Puzzle		A puzzle game where you reflect a beam of light to a target using a series of mirrors.
Moving Platforms		A simple platformer that demonstrates various platform movements using code.
NPC Dialog		A UI window presents texts from an NPC, allowing you to use Mouse Clicks, E and F keys to advance the conversation or answer questions.
Portal Puzzle		Using the new spawn feature to recreate a simple Portal clone.
Power Cube		Using simple planes to create a force field effect that blocks the player from reaching the access card.
Push Box Puzzle		Based on the classic Sokoban puzzle game where you push statues onto marked spots.
Random Noise Movement		Use noise generation to imitate the kind of randomness you see in nature.
Rocket Board		A rocket board that you can stand on and pilot. The board uses the cannon.js physics engine so you experience the momentum and inertia effects.
Rotating Platforms		A simple platformer that demonstrates rotating various platforms using code.
Shooting Range		Shoot at moving targets. Bullet holes appear in the spots where shots hit.
Shooting Range Advanced		Shoot at moving targets. Bullet holes appear at whatever angle the bullet strikes the target.
Splat Attack		Cover as much of the ground as you can with paint before calculating the area covered by it.
Switchboard Platforms		A platform that moves when the player stands on one of the switches.
Tin Can Alley		A tin-can-alley scene built using cannon.js physics engine.
Translocator		Example of how to create a projectile with physics and combining that with the new spawn feature to create a translocator disc.
Zombie Attack		A zombie will chase you around and attack you once it gets near.
Block Smart Wearables		Players wearing smart wearables are blocked from certain aspects of the scene, to prevent unfair advantages over others.
uv projector		Use UVs to map a video to multiple surfaces, constructing a single image that adjusts as the player changes their angle.
Bird field		Control a flock of birds so that they each take off when you walk near. They can then land back on uneven terrain.
Boolean Hole + Proximity Spheres		Demonstrates several objects that react to your proximity. Simulates a Boolean Hole in a wall, has objects that move over/around you, triggers to activate effects inside or outside the building.
Boid		Implementation of Boids. Flock behavior of fish or birds
NPC Tour Using A* Search Algorithm		Use A* Search algorithm to help guide the NPC.

Event Hosting

Example	Thumbnail	Description
Video Streaming		A video streamed from an external URL. The repo includes instructions for various alternatives for uploading the video content.
Digital Bouncer		Grant admin players special abilities, including kick other players out, and displaying UI announcements.
Lazy Loading		Only load certain entities when the player walks into a room or region.
Auto Dance Areas		Make players dance in a loop when they stand in certain areas of your scene.
Show Management		Schedule the start of a video, then sync the timing of actions in the scene to the video
Green Screen		A simple scene with a green screen that can be used for photoshoots. You can change the background color too.
Video UV Mapping to Archways		Demonstrates how to UV map a video texture onto many many planes

Physics

Example	Thumbnail	Description
Bouncing Balls		Kick balls around and make them bounce off each other, using the cannon.js library for physics.
Car + Physics		Drive a car through piles of boxes and see them tumble down, using cannon.js for physics.
2D Bouncing Ball		A bouncing ball using the box2d physics library to simulate physics in a 2D space.

3D Art

Example	Thumbnail	Description
Dhingia Builds		35+ Opensource builds and assets for Decentraland by MrDhingia.
Indicator Arrows		Improve the conversion optimization and user flow of your build by indicating key areas with these animated GLB files by DOCTORdripp.
Wearable Starter Guide		Everything you need to start your wearable creation journey. Created by Nikki Fuego and Doki.

Monetization and Blockchain

Crypto Libraries

Example	Thumbnail	Description
Donation Box		Request MANA donations to a wallet.
NFT Scanner Basic		Checks whether the player owns a token from a particular smart contract before granting them permission to enter the club.
DCL Access		Check for token or wearable ownership to easily control access to a scene area
Paid Button		Add a button that is only activated by paying a MANA sum to a specified address.
Paid Lever		Add a lever that only switches state by paying a MANA sum to a specified address.
Wearables Scanner		Fetch the list of wearables that a player currently has on. If they have something in the eyewear category, open the door for them.
Wearables Store		Display all wearables on sale on L2 and purchase them in-world. You can also configure it to only display certain collections.

Displaying NFTs

Example	Thumbnail	Description
Simple NFT		Display a 2D NFT in a picture frame.
NFT Wall		Display a collection of 2D NFTs in picture frames, these swap every few seconds, taking data from a JSON file.

Interact Directly With Contract

Example	Thumbnail	Description
MANA Burning		Interact with the MANA contract to burn MANA fees collected over time by the Market place in a ceremonious way.
Mint Pixelchain NFT		Paint a mural made from 32 x 32 pixels. You can then mint the image as a PixelChain NFT.

Multiplayer and APIs

Hit an API

Example	Thumbnail	Description
Party Time		Hit a world clock API to check the time, start a party if it's after 9PM.
DCL Trams		Hit a world clock API to sync the position of a tram line, so all players see them on the same location. Each tram does a full loop every 3 minutes, basing its position on every frame relative to the time.
Events API		Query the Decentraland Events API for any events that are currently active to display their info. If more than one, flip through them on the display.
Weather Simulation		Check a weather API, then represent the weather conditions, whatever they are.

Run Server-Side Validations

Example	Thumbnail	Description
Validate Player Authenticity		Hit a server that validates that the player really is in Decentraland, in a specific parcel, with a recent time-stamp, and signed a message cryptographically with their ephemeral key.

Message Bus

Example	Thumbnail	Description
Block Fountain		The cubes in this fountain have several animations that each set can play. When a player pushes a button, all players see the same animation.
Clap Meter		A meter that goes up based on the number of claps from players applauding in the scene.
Piano Floor		Play the keys of this piano by stepping on them. All players will hear the notes that are played.

API as Database

Example	Thumbnail	Description
Game Management		A fully scalable inventory and leveling system ready for integration into any game.
Leader Board		Upload player's final scores to a server, the best ones are displayed for all to see on a board.
Guest Book API		Players that sign this guest-book upload their user name and address to the server. All signatures are fetched when opening the book.
Pixel Mural		Create 2D pixel art by painting tiles. Players are synced through both the messagebus and a DB in a server.
3D Voxel Art Creator		Create 3D voxel art by placing cubes in place. Players are synced through both the messagebus and a DB in a server.
Zenquencer		Create musical patterns that are played in sequence. Players are synced through both the messagebus and a DB in a server.

Plain WebSockets

Example	Thumbnail	Description
Broadcast Server	(server code only)	A basic server that broadcasts all messages it receives to all other players in a room.
Color Switch		A minimal scene where clicking on cubes changes their color. The broadcast server syncs these changes to all other players in the same realm.
Bouncing Balls		Each player runs physics client side. Websockets sends information about new forces applied to the entities. The broadcast server syncs these changes to all other players in the same realm.
Frisbee Throwing		Each player runs physics client side. Websockets sends information about the throwing of the frisbee. The frisbee is hidden when picked up by a player.
Basketball		Each player runs physics client side. Websockets sends information about the throwing of the ball. The ball is hidden when picked up by a player.
Discord Chat		Display messages being posted to Decentraland discord server in real time inside the world

Colyseus

Example	Thumbnail	Description
Cube Jumper		A basic server that broadcasts all messages it receives to all other players in a room.
Land Flipper Game		A team game for 2 players or more, where tiles switch colors when walked on. The server keeps track of the game's state, and has the final word about when the game ends and who won.
Space Traitor		A game of deceit and secret identities. One player is randomly assigned as the trator, that will work against the others to sabotage the space ship.
OSC Relay		Listen to OSC messages from any source, relay them to affect Decentraland scenes in real time via a Colyseus server.

Full Scenes

Public Scenes

Example	Thumbnail	Description
Crypto Valley Conference Center		A fully equipeped venue ready for live events, with video streaming.
White Rabbit Night Club		A 24/7 nightclub, with lights and smoke effects, arcade machines, and much more.
Default Museum		A simple generic museum to display NFT art and a few common additional features.
Default Wearables Store		A simple generic store to sell wearables, with a few common additional features.
Genesis Plaza		The full code used in Genesis Plaza (0,0), including all the interactive elements found there.
Soho Plaza		The full code used in Soho Plaza (-75,0), including all the interactive elements found there.
Escape Room Tutorial		An escape room full of puzzles to solve. A video tutorial series covers how to make it, starting from the essentials.
Castaway 2048		A puzzle game based on 2048, where you merge similar gems into valuable ones, till you reach the value of 2048.
DecentRally		A racing game that shows what the Infinity Engine code can do.
MVMF 2022 Main Stage		Assets and code used for the Metaverse Music Festival (MVMF) 2022 Main Stage Scene
MVMF 2022 Tower of Babel		Assets and code used for the Metaverse Music Festival (MVMF) 2022 Tower of Babel Scene
Snowball Arena		Multiplayer Snowball Fight Arena

Community Modules

Example	Thumbnail	Description
Checkers Module		Two player game of checkers, with fully outlined peer-to-peer networking.
NFT Gallery Module		Provides easy-to-use interfaces to generate NFT (2D and 3D) displays. By simply editing the JSON files a user can quickly add displays to their scene.
Parkour Creation Kit		Provides all the tools need to create your own parkour stadium. Includes: multiple platform types, collectibles, traps, checkpoint/respawn mechanics.
Card Game Creation Kit		Provides all the utilities required to create card games in Decentraland. Also comes pre-packed with several card games that act as functional examples!
Interactive Art Exhibition		Create an interactive art exhibition with images, videos, and 3D art that rotate to face the player and lower to eye level upon approach. It can be deployed to Decentraland Worlds, so there are no size constraints aside from MB. Made by KJ of Low Poly Models.

Game Jam Winners

You can access the code submitted by previous game jam competitions, for those scenes that creators chose to make open source.

• May/June 2022

Libraries

Note that each library is only compatible with either SDK 6 or SDK 7, use libraries that match the version of the Decentraland project you're working on.

SDK 7

SDK 6

Note: To update these libraries from versions older than February 9th 2021, see the migration guide

Tutorials

Video tutorials

Find a full playlist of all Decentraland video tutorials here:

Youtube Playlist

Escape Room Video Tutorial Series

This series of 5 minute videos covers a number of essential concepts, game mechanics and coding best practices. They take you through the whole process of building a full escape room game.

See the videos

Tip: The videos are presented in the above link together with written accompanying content, including all the code in case you want to copy and paste parts of it.

The full code from the tutorial is available in this repository.

Multiplayer and APIs

Other

Guest Posts

3D Modeling for Decentraland

DevOps

Copyright info

All of these scenes are open source, protected with a standard Apache 2 licence. This licence states that this content can be used freely, even commercially, as long as you acknowledge the author. See the terms and conditions in the LICENSE file.