Difference between revisions of "Verge3D 4.0 migration guide"

From Verge3D Wiki
Jump to navigationJump to search
m
(18 intermediate revisions by the same user not shown)
Line 6: Line 6:


# Install Verge3D 4.0.
# Install Verge3D 4.0.
# Launch App Manager. When it asks to enter a new application directory, leave default or choose existing (e.g verge3d_blender/applications).
# Launch App Manager. When it asks to specify a new application directory, leave it by default or choose some existing folder.
# Update your apps in App Manager using build-in updater.
# Update your apps in the App Manager using the built-in updater.
# Reexport your Blender/3ds Max/Maya assets.
# Re-export your Blender/3ds Max/Maya assets.
# Resave Puzzles.
# Re-save Puzzles.


== Major Changes ==
== Major Changes ==
=== Removal of deprecated puzzles ===
Deprecated puzzles are now removed and replaced by dummy blocks. Be sure to update your project Puzzles before migrating to Verge3D 4.0.
[[File:old_puzzles.jpg|858px]]


=== Directory Split ===
=== Directory Split ===
Line 22: Line 28:
# Temporary directory for Sneak Peek exports.
# Temporary directory for Sneak Peek exports.


Now we store them separately:
Now Verge3D stores them separately:


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


=== Puzzles Library ===
=== Puzzles Library ===
Line 33: Line 39:
The Puzzles library is now stored inside the applications folder (selected on first launch):
The Puzzles library is now stored inside the applications folder (selected on first launch):


[[File:App-manager-splash-screen.jpeg|556px]]
[[File:App-manager-splash-screen.jpeg|600px]]


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.
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 new applications folder.


=== App Manager Templates ===
=== 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'').
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 ===
=== 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'').
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'').
 
=== Dropped support for older modelling suites ===
 
In Verge3D 4.0, the following versions of the modelling suites are no longer supported:
 
* Blender 2.80-2.82
* 3ds Max 2019
* Maya 2018
 
=== Custom settings for glTF-compatible materials no more ===
 
To make glTF-compatible materials lightweight and compatible with various tools, we removed custom Verge3D-based settings from such materials as of Verge3D 4.0. Among these settings: Shadow Cast, Shadow Receive, Depth Write, Depth Test, and Dithering. To enable these features you need to switch off the glTF Compatible checkbox, or use Puzzles/JavaScript.
 
For example, to turn on shadows from all meshes in your scene, you can use the following script:
 
[[File:puzzles_enable_shadows.png|1000px]]
 
=== Removed deprecated Puzzles-based AO ===
 
Instead of the AO puzzle removed in Verge3D 4.0, use GTAO-based ambient occlusion enabled in the modelling suite:
 
[[File:blender_ao_native.jpg|533px]]

Revision as of 06:43, 15 June 2022

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 specify a new application directory, leave it by default or choose some existing folder.
  3. Update your apps in the App Manager using the built-in updater.
  4. Re-export your Blender/3ds Max/Maya assets.
  5. Re-save Puzzles.

Major Changes

Removal of deprecated puzzles

Deprecated puzzles are now removed and replaced by dummy blocks. Be sure to update your project Puzzles before migrating to Verge3D 4.0.

Old puzzles.jpg

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 Verge3D stores them separately:

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

Puzzles Library

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

App-manager-splash-screen.jpeg

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 new 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).

Dropped support for older modelling suites

In Verge3D 4.0, the following versions of the modelling suites are no longer supported:

  • Blender 2.80-2.82
  • 3ds Max 2019
  • Maya 2018

Custom settings for glTF-compatible materials no more

To make glTF-compatible materials lightweight and compatible with various tools, we removed custom Verge3D-based settings from such materials as of Verge3D 4.0. Among these settings: Shadow Cast, Shadow Receive, Depth Write, Depth Test, and Dithering. To enable these features you need to switch off the glTF Compatible checkbox, or use Puzzles/JavaScript.

For example, to turn on shadows from all meshes in your scene, you can use the following script:

Puzzles enable shadows.png

Removed deprecated Puzzles-based AO

Instead of the AO puzzle removed in Verge3D 4.0, use GTAO-based ambient occlusion enabled in the modelling suite:

Blender ao native.jpg