Scene content guide
Learn how to import 3D models to use in a scene
Make sure of the following:
Note: The CLI prompts you to provide this information when creating the scene, but you can also modify the file manually at any time.
Your scene complies with all of the scene limitations. Most of these are validated each time you run a preview of your scene.
You installed IPFS correctly. To do so, follow these steps.
You have a Metamask account, with your LAND parcels assigned to it. The account must also hold a minimum amount of Ether to pay a transaction gas fee.
You own the necessary ammount of adjacent LAND parcels. Otherwise you can purchase LAND in the Market.
npm run build.
dcl deployfrom the scene’s folder.
If this is your first time uploading this scene to the selected parcels,Metamask will ask you to approve a transaction for paying the gas fee after the file upload is completed. You only make this payment the first time you deploy content, as the smart contract for your LAND is only updated when you link your content to IPNS, the naming service for IPFS.
This updates your parcel with your latest changes in addition to uploading your content to IPFS.
Currently, as a measure to improve performance and your visitor’s experience, your content will be pinned to Decentraland’s main IPFS server to ensure that the data needed to render your parcel is always readily available.
Note: While this command deploys your scene to your parcel, remember that users can’t currently explore Decentraland, so your content won’t be discoverable “in-world”.
IPFS (short for Inter-Planetary File System) is a hypermedia protocol and a P2P network for distributing files. The filesystem is content-addressed, meaning that each file is identified by its contents, not an arbitrary file name.
We use IPFS to host and distribute all scene content in a similar way to BitTorrent, keeping the Decentraland network distributed. For better performance, we run an “IPFS Gateway”, which means that Decentraland is hosting most of the content referenced from the blockchain (after certain filters are applied) to improve the experience of exploring the world.
In order to upload your files, you’ll need to run an IPFS node. After “pinning” your scene’s content (which means notifying the network that your files are available) our IPFS nodes will try to download the files using the IPFS network, eventually reaching your computer and copying over the files.
To run an IPFS node, please follow these instructions.
IPFS serves two primary functions for Decentraland.
dcl deploycommand links these assets to the LAND parcel specified in your scene.json file. Whenever you redeploy your scene, the CLI will update your LAND smart contract, if needed, to point to the most recent content available on IPFS.