Installing Unity Forma

Unity Forma is an entitled package for the Unity Industrial Collection.

Before you can use Unity Forma, you must make sure that:

  • Your organization has valid licenses for both the Unity Industrial Collection and Unity Forma.
  • An administrator in your organization has assigned you a seat from the subscription.
  • You have installed Unity version 2020.3 or 2021.1.

For information about purchasing a subscription for your organization, contact your sales representative.

Installing the Unity Industrial collection

Before you can install Unity Forma, you must install the Unity Editor with the Unity Industrial Collection.

  • For organizations with node-locked licences: If your organization purchased node-locked licenses for Unity Forma, your Unity ID must be assigned to one of the seats for the node-locked license. If your Unity ID is not assigned a seat, the Unity Forma package is not available in the Package Manager. To find out whether your Unity ID is assigned a Unity Forma seat, contact your system administrator.

  • For organizations with floating licenses: If your organization purchased a Floating license for Unity Forma, the Unity Forma package appears in the Package Manager for you to install. If other users in your organization are working with Unity Forma, you may not be able to use it until a license in your pool becomes available. For more information, contact your system administrator.

To install Unity Forma

To install the Unity Editor, follow these steps:

  1. Download and launch the Unity Hub.
  2. Login using the Unity Account that has the license for both Unity Industrial Collection and Unity Forma.
  3. Select Installs and then ADD to download a supported version of the Unity Editor.
  4. Once the Unity Editor is installed, you can continue the installation from the Unity Forma Sample Project or by installing the Unity Forma package into an existing package (see Option 1, below).

Option 1: Start with the Unity Forma Sample Project (preferred)

To help you get started with Unity Forma more quickly, we created a sample project that includes the packages you need and any dependencies that must be installed at the same time. Installing Unity Forma from the sample project is the fastest way to make sure that all the correct packages and dependencies are installed.

To install Unity Forma from the sample project, follow these steps:

  1. Download the latest version of the sample project and extract the files to the correct location on your desktop.
    Once extracted, you can see that the sample project files are organized as follows:

    • The SampleProject folder contains the Aviera Model (a model of a car that you can use to generate a sample configurator to see how a configurator project is organized).
    • The TemplateProject folder contains a basic configurator project that does not use the Aviera model. To start a project with your own product model, you can copy and rename this folder to the Project name you want to use.

  2. Select the Projects tab.

  3. Verify that the correct version of the Unity Editor is installed.
    If you want to use the sample project, make sure that the installed version of the Editor is the correct version for this project.
    Important: If a warning icon appears in the row for the Sample Project in the Unity Hub, you do not have the correct version. Follow instructions to install the correct version before launching the project.
  4. In the Unity Hub, select ADD and select the project folder you want to launch (for example, the SampleProject).
  5. In the Projects list, select a project to open in the Editor.

If the correct version of the Editor is installed, the project opens in the version of the Unity Editor associated with that project.

NOTE: It can take several minutes for the Editor to import and open this Unity Forma Sample Project for the first time.

Option 2: Installing the Unity Forma package into an existing project

Unity Forma is an entitled package that you must install with the Unity Editor. Installing Unity Forma into an existing project involves using the Package Manager to download and add the package to your project.

Before you start

To successfully install Unity Forma you must:

  • Have already installed a supported version of the Unity Editor.
  • Have a license for one of the following:
    • The Unity Industrial Collection (preferred)
    • Unity Pro and the Pixyz Plugin for Unity (limits some functionality)

Downloading the Unity Forma package

To download the Unity Forma package, follow these steps:

  1. In the Editor, open the Project you want to add the Unity Forma package to.
  2. To open the Package Manager, select the Window menu and then select Package Manager.
  3. In the Package Manager, select the Unity Registry.
  4. In the list of packages in the Unity Registry, use search or scroll to find and select the Unity Forma package.
  5. Select the Unity Forma package and and then select Install on the lower right of the window.

Importing a product from Pixyz to Unity Forma

The Pixyz for Unity plugin lets you import various file formats that you save in Pixyz to the Unity Editor.

If you use the Unity Forma Sample Project or Template Project to create your configurator, the Pixyz for Unity plugin is installed automatically when you import the project.

If you want to import a product from Pixyz into a different project, you must add the plugin to the project manually from the Package Manager.

When installed, a Pixyz menu appears on the menu bar of the Editor. The menu lets you connect to the Pixyz License Manager to add your Pixyz license.

For more information about Pixyz licensing, see: https://www.pixyz-software.com/documentations/html/2020.2/plugin4unity/Licensing.html.