Beginner's Guide

Verge3D is a versatile piece of software which you can utilize differently depending on your personal preferences. This guide describes just one of possible ways of how you can build your workflow, so take it as a friendly recommendation. The only prerequisite is that you should have some experience with 3D editing software on top of which Verge3D works: Autodesk 3ds Max or Blender.

Installation

The installation procedure is throughly described in the corresponding sections for each supported 3D suite individually: 3ds Max, Blender.

Sneak Peek

To make sure that Verge3D is installed correctly, you can render a basic model in the web browser by using the Sneak Peek menu option (3ds Max) or button (Blender). This function will perform an export to a temporary folder and will run the default web browser with interactive rendering.
You can use Sneak Peek for quick tests any time you are working on your projects.

App Manager

Although you can start working on the graphics first and create a Verge3D project later, we encourage you to get used to the App Manager from the beginning. By doing so you ensure that your files are properly organized and stored within the same folder which is important for integrity of your project, and especially for publishing. You will also have a working web application which you can run/reload in the browser independently from your source scene files.
The App Manager as a web-based tool which opens up in the browser when you select the App Manager option in the Verge3D menu (3ds Max) or click the same-name button (Blender). The default system browser will be running - you can change it in your OS settings. Any modern browser will work yet we recommend the latest version of Google Chrome which is fast, standards-compliant and offers good web development tools.
You can create a new project using the panel on the right. Type a project name (or just leave my_awesome_app) and click Create App. Leave the default configuration options as they are for now.
As a result, a folder named after your app will be created inside the applications folder of your Verge3D installation. It is important to know where your app folder is because all your textures and other project assets should be stored here.
After you created a project, return to the main screen of the App Manager - your project should be listed there. Now you can proceed with your app in several directions, by simply running it, authoring the graphics, creating interactive scenarios and eventually, publishing.

Running Your App

You can run your app any time by clicking the Verge3D icons, either the blue or the green one. The blue icon launches an app in its final form, with its Puzzles scenario and the programming code (if present). On the contrary, the green icon only opens the exported scene.
A freshly created app loads and displays just a cube. You can look around with the left mouse button pressed, and zoom in and out with the mouse wheel.

    If instead of the cube it shows something like "This site can’t be reached" this means that the development server is down, probably because you accidentally closed the first launched instance of your 3D editor and the development server along with it. In this case you should launch 3ds Max or Blender, or, if the program is already running, start the App Manager again.
    

    Although very rare, another warning can be shown: "Your graphics card does not seem to support WebGL." This can happen if you're using an outdated or unsupported browser such as Internet Explorer below version 11, or your video card and/or drivers are blacklisted by the browser. Try installing latest Google Chrome/updating your OS/downloading latest drivers or just find another computer to work on.
    

Export

By clicking on the 3ds Max or Blender icon you can open up the main .max or .blend file of your application respectively.
The 3D editor files can be also opened as usual via the "File > Open" dialog or simply by double-clicking on them in the application folder.

    It is important to understand that an application loads only exported scenes and not the source 3D editor files. So every time you change something in your source file you should export it in order to see the modified scene in your app.
    
Exporting can be performed from the Verge3D menu of the main menu bar (in 3ds Max) or from the "File > Export" menu (in Blender). You might want to assign a shortcut for this operation since you may perform it quite often.
You should export your scene to the root of the application folder, in glTF format.
To test it out, add some teapots/Suzannes to your scene, export to glTF and run your app by clicking the blue Verge3D logo icon in the App Manager.

    For quicker iterations, you can keep your application always running in a browser tab. 
    Hit "F5" on your keyboard after you re-export your scene so that it reloads in the browser. 
    Use the "Alt+Tab" ("Command+Tab" on Mac) shortcut to instantly switch between your 3D editor and the browser.
    

Puzzles

Until now we used Verge3D as a fancy web exporter, which generates live 3D views running in the browser. With Puzzles, Verge3D's visual scripting tool, you can add behavior scenarios so that your 3D scene becomes a truly interactive web application.
Click the Puzzles button near your app name in the App Manager. This will run your app with the Puzzles editor attached on top of it. On the left the toolbox with some categories ("Events", "Selectors", "Objects", etc) is located. The categories are expanded upon mouse click revealing puzzles which you can drag out to the workspace. By connecting various puzzles with each other you can create a scenario of how your 3D objects will behave upon user input.
To do something meaningful for the beginning, drag out the when clicked puzzle from the Events category, and the select an object puzzle from the Selectors.
Connecting them together means that you app will be waiting until the user clicks on the object that you chose in the dropdown menu ("Cube", for example), and will do... nothing unless you add something in the do slot.
Drag out the hide puzzle from the Objects and insert it to that slot. Drag out another object selector puzzle and connect it with hide.
Now, once the user clicks on the 3D object, it it should disappear. Click the Run button in order to launch your program and check if it works by clicking on the cube.
In order to make your scenario a persistent part of your application, be sure to save it.
Once you finished with Puzzles, you can run your now-interactive app using the blue icon in the App Manager.

    Congratulations, you have become a programmer!
    

Publishing

On your own website...

You've created a web application and probably want the billions of Internet users to come and check it out. If you own a website, this won't be a problem - simply upload the entire folder with your application to your server (via FTP, for example). Once deployed, you can provide a link to the app's HTML file somewhere on your website, or embed it in a web page with the iframe HTML element:
<iframe width="1024" height="640" src="https://www.example.com/my_awesome_app/my_awesome_app.html"></iframe>

Using Wordpress...

The task is even more simplified if you are running the Wordpress CMS on your website - you can use the free Verge3D Wordpress plugin to upload and embed Verge3D apps.

On Verge3D Network...

But what if you haven't had the chance to become a web master? No problem - by clicking the "Globe" button in the App Manager you can upload your app to the Verge3D Network, a cloud-based storage and CDN hosted on Amazon servers.
After the uploading is complete, a screen will show up with a direct link which you can share by whatever means (in a blog post, social media, comments, email, you name it). It will also generate HTML code for embedding your app in third-party websites just like you do it with YouTube videos.

On Facebook...

Finally, you can post a 3D model directly on Facebook by leveraging the 3D Posts feature.

License key

After acquiring a license, you'll be sent the license information in an email (the key below is a random example).
The license key will activate your Verge3D instance and will remove the trial watermark from all your apps.

    Be sure to enter the license key each time you update to a new version.
    

What's Next

For more detailed information check out the other topics from this User Manual. We also invite you join Soft8Soft community forums where we'd be happy to answer all your questions.