Installing Vishva

Note: If you just want to view a world, you do not have to install anything. Just go to the link provided to you. Vishva is browser based and does not need anything else. You only need to install this, if you want to create new worlds.

The install is pretty straightforward - download a zip file, unzip it and you are done.

You get the zip file from Vishva's github release site https://github.com/ssatguru/Vishva/releases

Here is the link for latest realse zip file https://github.com/ssatguru/Vishva/archive/v0.4.0.zip

On unzipping you will see the following folder structure and files

Vishva-master
	src
	webapp
	.gitignore
	pom.xml
	README.md

The only folder of interest is the “webapp” folder. You can delete the rest if you want.

Under webapp you will see the following folders and files

webapp
	js
	lib
	vishva
	assets.js
	config.js
	index.html
	worlds.js

The webapp contains a small world. Opening “index.html” will start and display that world.

If you have “firefox” browser go ahead and open up "index.html" using that.

If you do not have a "firefox" browser you will have to install a simple http webserver and serve "index.html" from there.

See here for some helpful information

If you got your world up and running then everything is good and in the next section we will explore how to navigate the world.

Before we do that, lets quickly review the files and folders you see under the "webapp" folder. We will go through some of them in detail later on, as you will have to modify some of them.

• "js" folder - this contains the Visha Javascript files. You won't have to do anything with them until and unless you want to modify the source code or see how things work
• "lib" folder - this contains various libraries required by Vishva. These include babylonjs, jquery, jqueryui,edit control, water material, color picker. Again nothing you need to interact with directly
• "vishva" folder - this is your most important folder. this contains all the assets you will use in your world, the worlds themselves and some internal assets used by Vishva. You will be adding assets and worlds here. We will come back to this later on
• "assets.js" file - this tells Vishva all the assets it needs to make available to the user. You will have to edit this file every time you add an asset to the "vishva" folder
• "config.js" file - this is the configuration file for Vishva. For now it only tells Vishva which world to load by default.
• "index.html" file - this starts up Vishva.
• "worlds.js" file - this describe all the worlds which Vishva can bring up. Every time you create a new world you will have to add an entry in this file.