Gemini Unity

NOTE: The virtual machine is now configured. The following steps should be done natively in Windows, not in the VM.

Install Git for Windows command prompt, if you do not already have it installed. Download the installer from git-scm.com and follow the installer instructions.

Clone the Gemini repository by running the following in a Windows terminal.

git clone https://github.com/Njord-The-Autonomous-Ship-Challenge/Gemini.git

Configuring network settings

Open Gemini\Gemini-Unity\Assets\Gemini\Scripts\EMRSensors\Core\Sensor.cs in a file editor. Change the IP address on line 24 to match the IP your VM is using.

Install gRPC dependencies

In the Gemini folder, right click on the 'setup.ps1' file and select 'Run with powershell'.

Unity Hub

For the time being, Gemini depends on the Unity editor. Download Unity Hub from unity3d.com.

Unity Hub requires an active license, which again requires a Unity ID. After creating an account, 'Activate New License' followed by 'Unity Personal' should select the free license. The free license is sufficient for this application.

In Unity Hub, on the 'Installs' tab, select 'Add' and choose version 2019.4.xxf1, where the x's indicate the latest stable version.

Select the 'Projects' tab. Then, select 'Add', and find the 'Gemini-Unity' folder which is inside the cloned 'Gemini' folder. Once added, launch the project.

Unity Packages

Download the Njord assets package from this link. After launching the project from Unity Hub, import the package by clicking 'Assets -> Import package'. This step can take a while.

Configure the force controller IP address

First, launch Unity and open the 'Njord' scene found in the 'Models' folder. Select the 'NjordVessel' object in the left-hand menu. In the inspector on the right-hand side, one of the of components are called 'Force Control Manager'. Open the dropdown menu and change the Host IP address to your Windows IPv4 address (the same as you specified in the ros_clients config file).