Learn how to import 3D models to use in a scene
Make sure of the following:
Your scene complies with all of the scene limitations. Most of these are validated each time you run a preview of your scene.
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 amount of adjacent LAND parcels. Otherwise you can purchase LAND in the Market.
If you’re deploying a single scene to multiple adjacent parcels, you must first merge them together into an Estate before you can deploy to them. See Marketplace for instructions on how to create an estate.
When deploying, the CLI reads information from the scene.json to know where to deploy your scene to.
Open your scene’s scene.json file and verify the following:
Owner: Needs to match your Ethereum wallet address. This same address needs to hold the LAND tokens, or have been granted permissions by the owner.
Parcels: The coordinates of the parcels that will be occupied by your scene
Base: The coordinates of the parcel that will be considered the [0,0] coordinate of the scene.
Estate: The ID of the estate you’re deploying to. If you’re deploying to a single parcel, this field isn’t necessary.
Note: To find your estate’s id, open the estate’s detail page in the Marketplace. The URL should include a number for the ID. For example if the URL is market.decentraland.org/estates/84/detail, the estate’s ID is 84.
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”.
Instead of storing your LAND tokens in a Metamask account, you may find it more secure to store them in a Ledger device that’s phyisically plugged in to your computer.
If you’re using one of these, the process of uploading content to your LAND is slightly different.
npm run build.
dcl deploy --httpsfrom the scene’s folder. This will open a tab on your browser where you need to confirm this action.
Note: Currently, the certificate is self-signed, so your browser might give you a warning before launching the page. The warning is displayed only because the certificate is self-signed by your machine, please ignore it and carry on.
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.