Bring your custom vehicle to life in Webaverse and ride around in style.

image_2022-02-19_001116.png

Hosted Webaverse Environments:

To get started with a customized vehicle, follow these simple steps.

  1. Go to the GitHub “hovercraft” example repo: https://github.com/webaverse/hovercraft and fork it to your personal account.

4.png

  1. Add your own .glb model into the repo —- Or just use the existing model that’s already there.
  2. Next, open the .metaversefile and edit it.

5.png

  1. Search the file for “.glb” ***and update the reference from “.glb” to the name of the model you want to use (i.e., **“mymodel.glb” ). ****Then save and commit the changes. For more information about .metaversefile, look here.

6.png

  1. Your model is now ready to be used in any Webaverse scene! There’s just one last step required in order to reference it from a hosted Webaverse installation: enable the GitHub Page on your repo. Head over to the settings for the repo, go to the Pages section, set the branch as master and save it. Finally, make a note of the GitHub page URL for later.

bandicam 2022-02-19 22-29-09-026.mp4

  1. You can use any of our template scenes or make your own. To add a model in a template scene, go the “app/scenes” folder in your cloned Webaverse app and open any of the .scn files.
  2. Copy and paste this into the .scn file right before the closing “]” bracket.
,{
	"position": [
		0,
		1,
		0
	],
	"quaternion": [
		0,
		0,
		0,
		1
	],
	"start_url": "<https://webaverse.github.io/hovercraft/>"
}
  1. Set “start_url” to the url of the GitHub Page for your repository. You can also adjust the starting position and rotation of the model based on where you want it in your scene. Now save the file and you’re good to go.
  2. Go to https://app.webaverse.com or some other hosted version of the app, drag your .scn file into the browser and experience your model brought to life.

Local Webaverse Environments:

  1. Go to the GitHub repo: https://github.com/webaverse/hovercraft and download the repo as a zip.
  2. Extract the zip folder into your already available Webaverse “app” folder.
  3. Add your own .glb model into the extracted folder —- Or just the existing model that’s already there.