Verge3D 4.0 migration guide

In this guide you will find info on how to perform migration from Verge3D 3.XX to the major 4.0 release.

Short Memo

In most cases, these steps would be sufficient:

1. Install Verge3D 4.0.
2. Launch App Manager. When it asks to enter a new application directory, leave default or choose existing (e.g verge3d_blender/applications).
3. Update your apps in App Manager using build-in updater.
4. Reexport your Blender/3ds Max/Maya assets.
5. Resave Puzzles.

Major Changes

Directory Split

Before Verge3D 4.0, these were stored in the single distribution directory:

1. Verge3D software files: engine modules, App Manager, exporter plugins, documentation etc.
2. Application files.
3. Configuration files.
4. Temporary directory for Sneak Peek exports.

Now we store them separately:

1. Verge3D software files now installed in the separate read-only directory (e.g Program Files on Windows).
2. Application files now stored in the explicitly selected directory (e.g Documents\verge3d_apps).
3. Configuration files go to system-specific place (e.g AppData\Roaming\Soft8Soft\Verge3D for Blender).
4. Temporary directory go to system-specific place (e.g AppData\Local\Temp) and automatically cleared up on exit.

Puzzles Library

The Puzzles library is now stored inside the applications folder (selected on first launch):

So you should copy the file called my_library.xml from e.g verge3d_blender/puzzles of your old Verge3D 3.X installation to your applications folder.

App Manager Templates

Located in the installation directory, in the manager/templates subfolder. You might need administrative access rights to place your templates there (e.g if you installed Verge3D in Program Files).

Puzzles Plugins

Located in the installation directory, in the puzzles/plugins subfolder. You might need administrative access rights to place your plugins there (e.g if you installed Verge3D in Program Files).