Skip to main content

GAMA Installation

GAMA runs the simulation models (.gaml files) and exposes a WebSocket server that the WebPlatform connects to.

Install GAMA​

Required version: GAMA 2025.06 or later.

Download from gama-platform.org/download and follow the official installation guide.

After installing, launch GAMA and verify the WebSocket server is on the default port:

  1. Go to Support → Preferences → Network → Server Mode.
  2. Confirm Port is 1000. Change it here if there is a conflict, and update GAMA_WS_PORT in your .env to match.
info

GAMA_IP_ADDRESS in the WebPlatform .env defaults to localhost. Change it only if GAMA and the WebPlatform run on different machines.

Install the SIMPLE plugin​

The SIMPLE plugin adds VR-specific GAML species, operators, and the VR_Experiment type to GAMA.

  1. In GAMA, go to Support → Install new plugins...
InstallPlugin
  1. In the dialog, click Work with and enter this update site URL:
https://project-simple.github.io/simple.toolchain/
  1. Press Enter. The plugin list loads.
Plugin
  1. Select SIMPLE Unity plugin and click Next, then follow the prompts to finish installation.
  2. Restart GAMA when asked.

After restarting, you should see a UnityVR menu in the GAMA IDE.

Next step​

Proceed to Install the WebPlatform.