realvirtual.io
  • Building Digital Twins with Unity and realvirtual.io
  • Basics
    • Installation
    • Demo Model
      • Old Demo Model
    • Editor User Interface
      • Hierarchy Window
      • 3D Views
      • Quick Edit
      • Move Pivot Points (Pro)
      • Selection Window (Pro)
      • Material Window (Pro)
      • Measurement (Pro)
      • Kinematic Tool (Pro)
      • Model Checker
    • Runtime UI
      • Group Manager
      • Debug Console
      • Responsiveness
      • Runtime Persistence
    • Importing and exporting
    • Folder structure
    • Tutorial
    • Physics
    • CAD import (Pro)
      • CADLink (Pro)
      • CAD Checker (Pro)
      • CAD Updater (Pro)
    • Reusable Components (Prefabs)
    • Cadenas parts4cad
    • Publishing the Digital Twin
    • Revision management
  • News
  • Login & Download Updates (Pro)
  • Components & Scripts
    • Realvirtual
      • Environment Controller
    • MU, Source and Sink
      • Source
      • Sink
    • Motion and Kinematic
      • Drive
      • Kinematic
      • Group
      • Joint
      • CAM
      • TransportSurface
      • Guided Transport
      • Drive behavior
      • Chain
      • Chain element
      • Motion for developers
    • Sensors
      • Sensor
      • Measure
      • MeasureRaycast
    • Picking and Placing MUs
      • Grip
      • Gripper
      • Fixer
      • Pattern
    • Changing MUs
      • MaterialChanger
      • PartChanger
      • Cutter
    • Scene Interaction
      • 3D Buttons
      • Screen Overlay Buttons
      • Scene Selectables
      • Lamp
      • Interact3D
      • UI components
      • HMI components (Pro)
        • Start your own HMI
        • HMI Tab
        • HMI DropDown
        • HMI Puschbutton
        • HMI Switch
        • HMI Value
        • HMI Text
        • HMI Slider
        • HMI Message
        • HMI Marker
      • ModelZoo (Pro)
    • Interfaces
      • Interface Tools
        • Signal Manager
        • Signal Importer Exporter
        • Signal Catcher
        • OnValueChangedReconnect
      • Signal Importer / Exporter
      • ABB RobotStudio (Pro)
      • Denso Robotics (Pro)
      • EthernetIP (Pro)
      • Fanuc (Pro)
      • FMI
      • Igus Rebel
      • MQTT (Pro)
      • Modbus (Pro)
      • OPCUA (Pro)
      • PLCSIM Advanced (Pro)
      • RoboDK (Pro)
      • RFSuite (Pro)
      • SEW SimInterface (Pro)
      • Siemens Simit Interface (Pro)
      • Simit Shared Memory (Pro)
      • Simulink (Pro)
      • S7 TCP
      • TwinCAT (Pro)
      • TwinCAT HMI (Pro)
      • UDP (Pro)
      • Universal Robots (Pro)
      • Wandelbots Nova (Pro)
      • Websocket (Pro)
      • Windmod Y200 (Pro)
      • Custom Interfaces
    • Performance Tools
      • Combine Meshes (Pro)
      • Create Prefab (Pro)
      • Hierarchy Cleanup (Pro)
      • Mesh Optimizer (Pro)
      • Performance Optimizer (Pro)
    • Defining Logic
      • Unity Scripting
      • Behavior Graph
      • Logicsteps
      • Unity Visual Scripting
      • Recorder
    • Robot Inverse Kinematics (Pro)
    • Volume Tracking (Pro)
  • Multiplayer (Pro)
  • Extensions
    • ModelZoo
      • Beckhoff TwinCAT
      • Siemens S7
      • Denso Cobotta 1300
      • Wandelbots Nova Fanuc CRX
      • Universal Robots UR10
      • Fanuc Roboguide
    • realvirtual.io AIBuilder
      • realvirtual.io AI Builder Overview
      • Generate AI Training Data
      • AI Training
      • Testing AI in a Digital Twin
      • Deploying the AI
    • realvirtual.io Simulation
      • Conveyor Library
      • Path System
        • Path finding
        • Line
        • Curve
        • Workstation
        • Catcher
        • Pathmover
    • realvirtual.io Industrial Metaverse
      • Setup Guide
      • VR Modules
      • AR Modules
      • Multiuser
    • AGX Physics
    • VR Builder
    • CMC ViewR
  • Advanced Topics
    • Render Pipelines
    • Mixed Reality with Meta Quest3
    • Upgrade Guide
      • Upgrade to 2022
    • Open Digital Twin Interface
    • Usefull Addons
    • Improving Performance
    • Supported Platforms
    • Compiler Defines
    • For Developers
      • Important Classes and Interfaces
      • Assembly Definitions
      • Starting your development
      • Class documentation
      • realvirtual Init Sequence
      • realvirtualBehavior Lifetime Methods
      • Testing
    • Newtonsoft JSON
    • Troubleshooting
  • Release Notes
  • AI Digital Twin Assistant (GPT4)
  • License Conditions
Powered by GitBook
On this page
  • Preparation
  • Upgrade your existing Project to Unity 2022
  • Import realvirtual 2022
  • Delete game4automation folder
  • Import realvirtual 2022 once again.
  • Cleaning up Package manager
  • Changing the namespaces
  • Upgrading the layers in your custom scenes
Edit on GitHub
  1. Advanced Topics
  2. Upgrade Guide

Upgrade to 2022

Upgrading from realvirtual (game4automation) 2021 to 2022

PreviousUpgrade GuideNextOpen Digital Twin Interface

Last updated 6 months ago

In our latest release, realvirtual.io 2022, we have changed all previous naming conventions from "game4automation" to "realvirtual. As a result, upgrading to the new version may not be as straightforward as before. This upgrade guide will provide you with instructions on how to upgrade your projects to Version 2022. Unless necessary, we recommend using Version 2022 for new projects and keeping existing projects in Version 2021.

If you prefer Youtube, this tutorial is describing how to upgrade:

Preparation

Before proceeding with the upgrade, ensure that all your custom scripts and components are located outside the "game4automation" folder.

Upgrade your existing Project to Unity 2022

Begin by upgrading your project to Unity 2022. Install the latest Unity 2022.3 release and open your existing project using the installed 2022.3 editor version. You will be prompted to confirm the editor version change. Your project should now open in Unity 2022, and you may encounter an error which can be ignored.

You will be asked to agree to changing the editor version. Your project should now open in Unity 2022. There might be an error which you can ignore.

Import realvirtual 2022

Next, import the latest realvirtual 2022 release by navigating to Assets > Import Custom Package. Select "Import" in the Import Package Window.

You will see several error messages in the console window, and the project structure will still contain the "game4automation" folder along with an additional "realvirtual" folder.

Delete game4automation folder

Although all necessary files have been imported and the references are intact, the project still contains outdated assembly definitions and the "game4automation" folder. Close Unity, delete the entire "game4automation" folder from the project, and then reopen Unity. When prompted with the Enter Safe Mode message, select "Ignore."

Import realvirtual 2022 once again.

Import the realvirtual 2022 package once again.

After the import, your project structure should resemble the following (with the possibility of additional custom folders you are having in the project), containing only the "realvirtual" folder.

You will now encounter several error messages related to your custom scripts. The primary reason for these errors is the namespace change from "game4automation" to "realvirtual" in the realvirtual package.

Cleaning up Package manager

In the event of numerous errors resulting from incorrectly referenced packages, follow these steps to resolve the issue:

  1. Delete the "Packages" Folder: If you encounter errors related to incorrectly referenced packages, the first step is to remove the existing "Packages" folder from your project. This folder contains the packages that may be causing issues.

  2. Replace with a Clean Copy: To ensure a clean start, obtain the "Packages" folder from an empty realvirtual 2022 project. This folder should be free from any conflicts or errors.

  3. Integration: Paste the "Packages" folder from the empty realvirtual 2022 project into the directory of the project that requires upgrading. This action should resolve any package-related errors, providing a smooth and error-free experience.

Changing the namespaces

To resolve the compile errors caused by your custom scripts, you need to replace all references to the "game4automation" namespace with "realvirtual" in your scripts.

Update the namespace declaration from "namespace game4automation" to "namespace realvirtual" and modify any "using game4automation" statements to "using realvirtual."

Upon completing these namespace changes, the console log should no longer display any compile errors caused by your custom scripts.

Upgrading the layers in your custom scenes

To ensure that the new layers exist in your project, select "realvirtual" followed by "Apply standard settings." This action will populate the new layers in the physics settings.

There may still be remnants of old layers (starting with "g4a"), which you can delete by selecting "Edit Layers."

Next, open your scene. To assist you in modifying the scene settings, an upgrade helper is provided. Choose "realvirtual" and then "Update Scene to 2022."

This action will update the most common layer settings in your scene. However, please double-check that all collider settings and layers in your scene align with the new layer naming convention

In addition to the namespace changes, the layer naming has been updated to a new standard (refer to the section for details). Since your scenes might still utilize the old layer names, you need to update them to the new standard.

Physics
Youtube tutorial - upgrading projects to 2022
Opening the project with 2022.3.X
namespace before changes
namespace after al changing to realvirtual
Update layers in current scene