Skip to main content

Install a Virtual Universe

Virtual Universes are 3D simulations that run on the GAMA platform. This guide explains how to install them.

Download a Virtual Universe​

  1. Visit the SIMPLE GitHub organization
  2. Find a Virtual Universe repository
  3. Download using either:
    • Release (recommended) - Pre-built stable version
    • Direct Download - Latest code from the main branch

Install the Virtual Universe​

  1. Extract the downloaded ZIP file
  2. Move the folder to your learning package directory

The default location is: simple.webplatform/learning-packages

info

This path is configured by LEARNING_PACKAGE_PATH in your .env file. See the .env reference for details.

Expected Structure​

simple.webplatform/
├── learning-packages/
│   ├── virtual-universe-1/
│   │   ├── some-files.gaml
│   │   └── settings.json
│   ├── virtual-universe-2/
│   │   ├── some-files.gaml
│   │   └── settings.json
│   └── ...
├── .env
├── package.json
└── ...

Each Virtual Universe must have a settings.json file in its root folder.

Verify Installation​

  1. Start the web platform
  2. Your installed Virtual Universes should appear in the list
  3. Click on your Virtual Universes to start it

Troubleshooting​

  • Virtual Universe not appearing? Check that the folder contains settings.json
  • Wrong path? Verify LEARNING_PACKAGE_PATH in your .env file

Next Steps​