Installation requirements: node.js

• First and foremost, Gama Server Middleware based on Node.js 22th version (not tested with previous version). It is imperative to install the latter via this link: https://nodejs.org/.

[!TIP] After installation, if the node command is not recognized in your environment variables, please run the commands below in the node.js console.

This step only needs to be carried out once during the first installation. After this step, you can launch the Middleware.

Launching Gama Server Middleware

• Starting the middleware:

  • run command "npm install", in the project root directory.

  • run command "npm start", to launch the project.

This executes in the terminal different http links. Each will redirect to the application, by default open this one: http://localhost:8000/.

[!CAUTION] When the middleware is launched, it opens several internet ports. If these ports are already occupied by another program, you will see this in the console. To remedy this problem, you need to change the ports used in .env file, and in particular change the problematic port.

[!TIP] In general, I suggest you take a look at .env to understand the global variables used by the middleware.

[!TIP] If you want to launch the application on a tablet, first make sure that the tablet and the laptop are connected to the same network. Then on your mobile, enter one of the link showed in the terminal except the "http://localhost:8000/". It may look like this: → Network: http://10.2.172.36:8000/

Launching Gama Server

You will also need to load Gama Server:

• If you have a recent version of Gama which includes Gama Server GUI (GAMA 1.9.3+), you only need to launch GAMA.
• If you have an older version of GAMA, you will need to launch Gama Server. For more information see this documentation.

[!NOTE] To install Gama Server, go to Gama Platform

[!WARNING] You must have Gama 1.9.3+ version if you want to run Gama Server easily by just launching Gama. To check the version of Gama, go to Support > About Gama.

You can start Gama before or after the middleware

Launching an experiment

To launch an experiment, first put your project with a settings.json file in the "learning-packages" folder. •(optionnal) Add an image for your simulation (splashscreen) which will be displayed on the main page. The image path must be added in the settings.json file. •Add the minimal players and/or maximal players in the settings.json required to launch the simulation Then set the attribute "selected_monitoring" as either "gama_screen" or "shared_screen". This affect the initial mirror page of the application between either displaying only a copy of the gama simulation, or sharing it with the mirrors of the headsets.

[!NOTE] The mode is not definitive, and can be changed later using the application

Here is an example of settings.json file for you to create your own settings.json. The name attribut will also be displayed on the page :

The middleware can now detect this simulation, and will display it on the front page

[!NOTE] The file path of the splashscreen must follow this template : "learning-packages/yourDemo/splashscreen/yourdemoSplashscreen.png" .

Configuration on Unity

On Unity change the default IP by putting the one from your wifi Put on the case "Use Middleware DM " Then Ctrl+S

Language selection

On the main page you can choose the language you want : English, French, Vietnamese, Thai