Installing the Vortex Studio Package in a Unity Project

To use Vortex assets with Unity graphics on a distributed simulator, the Vortex Studio Package for Unity is required. It includes tools for packaging and testing Vortex graphics assets (such as Graphics Galleries and Graphics Splines) via the Unity Editor.

Installing the Vortex Studio Package involves downloading the package and copying the file to a folder with a path relative to your Unity project.

Prerequisites

Starting with Vortex 2024.3,  Vortex toolkit is using Unity 2022.3.21f1

From Vortex Studio 2023.4 to Vortex Studio 2024.2, the Vortex toolkit is using Unity 2021.3.22f1

From Vortex Studio 2023.1 to Vortex Studio 2023.3, the Vortex toolkit is using Unity 2021.3.16f1

From Vortex Studio 2022.10 to Vortex Studio 2023.12, the Vortex Vortex toolkit is using Unity 2021.3.12f1

From Vortex Studio 2022.6 to Vortex Studio 2023.9, the Vortex toolkit is using Unity 2021.3.4f1

From Vortex Studio 2022.4 to Vortex Studio 2022.6, the Vortex toolkit is using Unity 2020.3.20

The Vortex Integration tarball packages (.tgz files) can be found in the Vortex Studio installation directory, under C:/CM Labs/Vortex Studio 2022.X/bin/unity.

IMPORTANT: You must have a valid Unity user account and license to download the Unity Engine and use it.

To begin, you need a Unity project. We recommend using the Unity Hub to install Unity and to create a project in this version.

Installing the Package

To use the Vortex Studio package for Unity, there are two options:

  • The first one is the recommended option, especially for teams of users working on the same Unity project from different computers. This is because it relies on a relative path to the Vortex Studio Integration Package file.

  • The second one is more manual in how the package is installed. It relies on an absolute path to the Vortex Studio Integration Package file.

Method #1  Manually modify the manifest.json

 

This is the recommended approach when the Unity project is in source control and it will be used on several different computers. In this case, the path to the package file needs to be relative, so it is always found when the project is extracted from the source control software.

 

Manually add a dependency to the Vortex Studio package as a relative path.

  1. Get a copy of the Vortex Studio package for Unity mentioned earlier on your local computer and put it alongside your Unity project (not under the Unity Project's root folder). Please note that it can be anywhere, as long as you can refer to it with a relative path (same drive for instance).

  2. Make sure your Unity Project is closed.

  3. In a Windows Explorer window, navigate to your Unity Project's location and open the "manifest.json" file under the "Packages" directory.

  4. Here is the default content of this file:

  5. Add to this file a reference to Vortex  integration package "com.cmlabs.vortex.integration" as the first element and save the file:

    Use the exact name of your tgz package file, which should match your Vortex Studio version.

  6. Open your Unity project again.

  7. In the Unity Package Manager window, make sure to select "In Project" from the dropdown menu directly under the Package Manager tab's name

  8. Validate that the Vortex Studio package is properly used by your project by opening the Unity Package Manager again.

  9. You should see it in the list.

 

Method #2 Use the Package Manager

Use the Unity Package Manager to import the Vortex Studio package into your Unity project. 

  1. Get a copy of the Vortex Studio package for Unity on your local computer.

  2. Open the Unity Package Manager:

  3. Select the "Add package from tarball..." option:

  4. Make sure to select the "In Project" tab of the package manager:

  5. Select the ".tgz" file of the installed Vortex Studio package for Unity. The Unity Package Manager should now show your new package:

You should now have access to Vortex tools for preparing and packaging graphics assets for a distributed Vortex simulation.

 

Â