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

GAMA may show a security warning about unsigned content. This is expected for all third-party GAMA plugins — click Install anyway to proceed.

  1. Follow the remaining 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.