NOTICE!
Code that has been commented out and needs revisiting should be tagged with
/*
//TODO TAG:PORT-REIMPLEMENT-ME
code block to be revistied here
*/
NOTE: This is deployed by a git action branches are configured to auto deploy. Merge code ready to release into release branch
- testing = peer-testing
This folder contains all the necessary files to launch a Decentraland scene.
A few screenshots of Genesis Plaza.
The newly revamped Genesis Plaza.
Read the behind the scenes from this scene in these blog posts:
This scene contains a lot of useful mechanics, including:
- Interacting with an NPC
- Fetching data from APIs
- Adding teleports to other scenes
- Adding external links outside Decentraland
- Syncing player actions with the messagebus
- Streaming audio
- Streaming video
- Displaying a custom UI
Because it can be hard to find specific things in such a large repository, some of the most interesting bits of the scene have been exported into their own example repos:
- NPC Dialog: A UI window presents texts from an NPC, allowing you to use the Right Click, E and F keys to advance the conversation or answer questions.
- NFT: Display a 2D NFT in a picture frame.
- 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.
- Piano Floor: Play the keys of this piano by stepping on them. All players will hear the notes that are played.
- Zenquencer: Create musical patterns that are played in sequence. Players are synced through both the messagebus and a DB in a server.
Install the CLI
Download and install the Decentraland CLI by running the following command:
npm i -g decentraland
Previewing the scene
Download this example and navigate to its directory, then run:
$: dcl start
Any dependencies are installed and then the CLI opens the scene in a new browser tab.
Setting up the server
The scene is set up to make use of the same server that's used by Genesis Plaza. To launch your own server, we recommend you deploy what's in the /server
folder to your own Firebase account, following the steps in this tutorial. To store data on an Amazon S3 server, as done here, you'll also need to set up your own Amazon S3, and fetch credentials for that account to include in your server folder.
Learn more about how to build your own scenes in our documentation site.
If something doesn’t work, please file an issue.
- Thank you to Polygonal Mind for providing sample code of the NPC used in Tomb Chaser
- alice.mp3 modified from https://freesound.org/people/mik300z/sounds/103525/
- bela.mp3 modified from https://freesound.org/people/AderuMoro/sounds/213282/
- betty.mp3_ modified from https://freesfx.co.uk/Category/Robots/83
- bob.mp3 modified from https://freesound.org/people/mik300z/sounds/103525/
- charlie.mp3_ modified from https://freesound.org/people/Satoration/sounds/57296/
- marsha.mp3 modified from https://freesound.org/people/urupin/sounds/199905/
- ron.mp3 modified from https://freesound.org/people/xtrgamr/sounds/257808/
- beerPump.mp3 modified from https://freesound.org/people/RG_Campus/sounds/392893/
- error.mp3 modified from https://freesound.org/people/distillerystudio/sounds/327736/
- pickUp.mp3 modified from https://freesound.org/people/drummerman/sounds/368130/
- putDown.mp3 modified from https://freesound.org/people/Nightflame/sounds/368614/
- swallow.mp3 modified from https://freesound.org/people/freakinbehemoth/sounds/243635/
- micFeedback.mp3 modified from https://freesound.org/people/chimerical/sounds/105980/
This scene is protected with a standard Apache 2 licence. See the terms and conditions in the LICENSE file.