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).

Installation guide - Previous

ROS

Next - Installation guide

Troubleshooting & Known issues

Last modified 6mo ago

Copy link

On this page

Configuring network settings

Install gRPC dependencies

Unity Hub

Unity Packages