Installation

Installing realvirtual.io and Unity

Before you dive into the world of realvirtual.io, you'll need to set up your development environment correctly. Here's a step-by-step guide to get you started.

realvirtual.io 6.3 (Unity 6.3 LTS)

Supported Unity Version: realvirtual.io 6.3 requires Unity 6.3 LTS (version number 6000.3 in Unity Hub).

Starting with version 6.3, realvirtual is distributed as Unity Package Manager (UPM) packages (io.realvirtual.starter, io.realvirtual.professional). The installation depends on where you purchased realvirtual — see Step 3 below.

Automatic Configuration: For new installations, Project Settings are applied automatically in the background to optimize your Unity project for industrial automation. For updates to existing projects, a dialog will appear asking if you want to apply these settings.

Step 1: Install Unity 6.3 LTS

Install Unity 6.3 LTS through the Unity Hub. In Unity Hub, the version number is displayed as 6000.3 (e.g., 6000.3.5f1). For detailed instructions, refer to Unity's official installation guide.

Unity - Manual: Install Unitydocs.unity3d.com

Unity 6 Installation guide

Step 2: Create a New Unity Project

1. Open Unity Hub and click New project.

2. Select Universal 3D under Core templates to use the Universal Render Pipeline (URP).

3. Set a project name and choose a location for the project folder.

4. Ensure Editor version 6000.3 (Unity 6.3 LTS) is selected.

5. Click Create project.

Creating a new Universal 3D project with Unity 6.3 LTS

Step 3: Install realvirtual Packages

The installation depends on where you purchased realvirtual. Choose the section that applies to you.

Purchased from the Unity Asset Store

1. Open Window > Package Manager in Unity.

2. Select My Assets in the left panel.

3. Find realvirtual Starter (and realvirtual Professional if purchased) and click Download.

4. After downloading, click Import to install the UPM packages into your project.

Purchased directly from realvirtual.io

For your first installation, download the .tgz package files from the realvirtual Customer Portal. The link and login credentials are provided on your invoice.

After downloading, install the packages in Unity:

1. Open Window > Package Manager.

2. Click the + button in the top-left corner and select Install package from tarball....

Install package from tarball in Package Manager

1. Navigate to the downloaded .tgz file and select io.realvirtual.starter first.

Select the starter package tarball file

1. Wait for the import to complete. This may take a few minutes.

2. Repeat the process for io.realvirtual.professional if you purchased the Professional edition.

realvirtual Professional installed via tarball in Package Manager

Setting Up User Hub for Future Updates

After installing the packages, the realvirtual menu appears in the Unity menu bar. Use the built-in User Hub to manage updates:

1. Go to Tools > realvirtual > User Hub in the Unity menu.

Open User Hub from the realvirtual menu

1. In the Login tab, enter your Invoice Number, Billing ZIP Code, and Email. Click Login.

User Hub login with invoice credentials

Activate UPM Registry (Recommended)

To receive automatic update notifications, activate the realvirtual UPM Registry:

1. In User Hub, go to the Packages tab.

2. Click Activate UPM Registry.

Activate UPM Registry in the Packages tab

1. Unity will add a scoped registry to your Project Settings > Package Manager and show a confirmation dialog.

Scoped registry added to Project Settings

1. Future updates will now appear automatically in the Package Manager under My Registries. Use Check for Updates in User Hub to verify.

Manual Updates via Tarball

Alternatively, you can download newer versions from the Downloads tab in User Hub (or from the Customer Portal) and install them via Install package from tarball as described above.

Download packages from the User Hub Downloads tab

Step 4: Handle Signature Warnings

When installing packages from the Customer Portal or User Hub (not from the Asset Store), Unity may show a Missing Signature or Invalid Signature warning. This is expected — realvirtual packages distributed outside the Asset Store are not Unity-signed. It is safe to click Close and continue.

Missing Signature warning — safe to close

Invalid Signature warning — safe to close

Step 5: Import Demo Scenes

After installation, a dialog will ask if you want to import the Getting Started demo scene. Click Import Now to get started right away.

Import the Getting Started demo scene

You can import additional demo categories at any time using two methods:

Via Package Manager: Select realvirtual Starter (or Professional) in the Package Manager, go to the Samples tab, and click Import for the demo categories you want.

Import demo scene categories from the Samples tab

Via Demo Scenes Browser: Go to Tools > realvirtual > Demo Scenes Browser in the Unity menu. This window shows all available demo scenes organized by category with descriptions.

Open Demo Scenes Browser from the realvirtual menu

Demo Scenes Browser with categories and scene descriptions

Step 6: Explore the Demo Scene

The Getting Started demo scene opens automatically after import. It showcases a complete automation cell with conveyors, a robot, sensors, and a machine — all working together.

realvirtual 6.3 demo scene

Press Play in the Unity Editor to start the simulation and see the automation in action.

Possible Problems and Fixes

Wrong Input System

If you see red error messages in the Console related to the Input System, make sure that the Active Input Handling in Project Settings > Player > Configuration is set to Both (old and new Input System).

Wrong Render Pipeline

If your demo scene appears pink, you may be using the wrong render pipeline. We recommend switching to the Universal Render Pipeline (URP). See Render Pipelines for details.

TextMesh Pro Essentials Not Imported

If you encounter problems with text in the Runtime UI, go to Window > TextMeshPro > Import TMP Essential Resources to install the required components.

(Optional) Clean Up Unnecessary Unity Demo Folders

To keep your project clean, you can delete Unity's default demo assets if present:

• Scenes

• Settings

• TutorialInfo

---

Upgrading from realvirtual 6.0 to 6.3

If you have an existing project using realvirtual 6.0.x (the .unitypackage version), follow these steps to migrate to the new UPM package format.

Important: Two-Step Process — First upgrade Unity, then upgrade realvirtual. Do not attempt both simultaneously.

Step 1: Upgrade Unity to 6.3 LTS

1. Open Unity Hub and change the Editor Version of your project to 6000.3 (Unity 6.3 LTS).

2. Accept any compatibility warnings and let Unity convert your project.

Step 2: Remove the old realvirtual folder

1. Close Unity completely.

2. Delete the Assets/realvirtual folder from your project directory (this is the old .unitypackage content).

3. Delete the Library folder to force Unity to regenerate all cached metadata.

Don't worry about references! All references in your scenes and prefabs are preserved. Unity maintains them through GUIDs, even when folders are deleted and reimported from a different location.

Step 3: Install the UPM packages

1. Reopen your project in Unity 6.3 LTS. You will see compilation errors — this is expected.

2. Install the new UPM packages following Step 3 from the installation instructions above (either via Asset Store or Customer Portal tarball).

3. After the packages are installed, compilation errors should be resolved.

Step 4: Verify the upgrade

1. Check the Console window for any remaining errors.

2. Open one of your scenes and verify that all components, references, and materials are intact.

3. If materials appear pink, go to Tools > realvirtual > Settings > Switch to Universal Render Pipeline (URP) to convert them.

After upgrading, you can use the User Hub to set up the UPM Registry for future automatic updates.

---

realvirtual.io 6.0 (Unity 6 — .unitypackage)

This section covers the legacy .unitypackage installation for realvirtual 6.0.x. For version 6.3 and later, follow the UPM instructions above.

Tutorial realvirtual.io 6 and Unity 6 Installation

Step 1: Install Unity 6 LTS

Install Unity 6000.0 LTS (Unity 6) through the Unity Hub.

Step 2: Create a New Unity Project

1. Open Unity Hub.

2. Select Universal 3D under Core templates.

3. Ensure Editor version 6000.0 LTS is selected.

4. Click Create Project.

Step 3: Install realvirtual.io 6

• Direct Purchase from realvirtual.io:

  1. Download the realvirtual.unitypackage file from your account on the realvirtual.io download website.

  2. Drag and drop the file into the Unity Project window, or go to Assets > Import Package > Custom Package.

• Unity Asset Store:

  1. Open Window > Package Manager.

  2. Under My Assets, locate realvirtual.io 6 and click Download, then Import.

When prompted about a URP Upgrade, select Install / Upgrade.

Installation Warning

Import Unity Package

After import, the demo scene opens automatically.

Demo scene after installation

Possible Problems and Fixes

See the problems and fixes section above — the same issues and solutions apply.

---

realvirtual.io 2022 and before

1. Install Unity

If you haven't already, install Unity on your computer. Unity offers both free and licensed versions, depending on your use case. Check Unity's official website here to determine which version suits your needs.

Installation of realvirtual.io 2022 (old deprecated version)

Our new releases is always based on the latest Unity Long Term stable release. Our main version number (e.g. 6) always corresponds to the Unity version number. For example to run realvirtual.io 2022.09 you need Unity 2022.03 LTS.

2. Unity Hub (Recommended)

We highly recommend installing Unity Hub, a tool that simplifies managing multiple projects and Unity installations. You can download Unity Hub from Unity's official download pages.

3. Create a New Project

Launch Unity and create a new empty project by selecting "New." Choose a location on your computer to store your project files and give your project a name. Then, click "Create Project."

When prompted to choose a template, select the standard 3D template. This will form the foundation of your project:

Creating a new Unity Project with the Unity Hub

5. Ensure .Net Standard Framework 2.1 and Mono are Enabled

By default, Unity should have .Net Standard 2.1 and Mono enabled. However, in some cases, especially when integrating realvirtual.io into an older project, this setting might be incorrect. To confirm or change this setting:

• Go to Player Settings by selecting "Build Settings" > "Player Settings."

• Under "Configuration," change the Scripting Runtime Version to ".NET Standard 2.1"

For the scripting backend, it's recommended to start with Mono rather than IL2CPP, as Mono typically compiles much faster.

Selecting the .Net Standard 2.1 in the Unity Player Project Settings

6. Acquire realvirtual.io

Go to the Unity Asset Store and purchase the version of realvirtual.io that suits your needs, whether it's Lite or Professional.

7. Import realvirtual.io

You can import realvirtual.io directly from the Unity Asset Store or manually download the asset. To install it manually, follow these steps:

• From the main menu, go to "Assets" > "Import Package" > "Custom Package..."

• A new window will appear, displaying the contents of the realvirtual.io package. Select "All" and click "Import."

Import custom package

This will show a new window with all the realvirtual.io package contents:

Please select All and Import.

8. Verify Installation

After importing the realvirtual.io package, check for the following:

• You should see an additional "realvirtual" folder (previously "game4automation" before 2022) in your project structure.

• A new "realvirtual" menu should be available in the main menu bar.

Project view after realvirtual.io installation

9. Set Standard Settings

Usually, standard settings are applied automatically after a fresh installation or update of realvirtual.io. However, if you encounter compile errors in the console window, it may be due to conflicts between your existing project assets and realvirtual.io.

In such cases:

• Address the compile errors first to ensure there are none remaining.

• Once errors are resolved, apply the standard settings by selecting "realvirtual" > "Apply Standard Settings" from the main menu.

Applying standard settings will configure:

• Standard layer naming (for physics).

• Standard physics collision matrix.

• Standard light settings.

Congratulations! You've now completed the installation process and are ready to explore the Demomodel outlined in the documentation.