Skip to content
This repository has been archived by the owner on Jul 30, 2024. It is now read-only.

project-SIMPLE/gaml.extension.unity

Repository files navigation

Overview

The gaml.extension.unity GAMA plugin provides a number of tools and GAML extensions (built-in species and new experiment type) to transform a GAMA model into a Unity 3D universe. It works with the simple UNITY template and the simple server middleware.

The plugin integrates:

  • 2 new abstract agent species for GAMA:
    • An abstract species, abstract_unity_linker, which links a GAMA simulation to a Unity game.
    • An abstract species, abstract_unity_player, which represents a Unity player in a GAMA simulation.
  • A new type of experiment, unity, which creates a unity_linker at initialization.
  • 3 new types of variables:
    • unity_property: a type representing a set of properties for the geometry/agent to send to Unity, in particular a unity_aspect, and a unity_interaction
    • unity_aspect: a type representing the way a geometry will be displayed in Unity"
    • unity_interaction: a type representing a set of properties concerning the interaction for the geometry/agent to send to Unity

In addition, the plugin integrates a tool accessible from the UnityVR menu that allows you to generate a new VR model from a GAMA model, extending it and linking it to Unity.

Finally, the plugin includes several templates illustrating how to use the plugin (Single player and Multi-player Demos) or how to send or receive geometries from GAMA to Unity or from Unity to GAMA.

A description of the use of the plugin with a tutorial can be found here.

Installation

From GAMA

To use the plugin from a release version of GAMA (version 2024-03), it can be installed directly from the plugin installer. Specifically, select "Support/Install new plugins..." from the menu, qs1

then "Work with", copy the address https://project-simple.github.io/gaml.extension.unity/ and select the plugin afterwards. qs1

Developer mode

If you have a developer version of GAMA (branch 2024/06), you can clone the project directly to add the plugin to GAMA.

About

⚠️ Merged in repo https://github.com/project-SIMPLE/simple.toolchain ⚠️ GAMA plugin allowing to automatically edit GAML project to connect it to Unity 3D Engine

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published