ThalesGroup / kessler-game

Kessler is a simulation environment loosely modeled after our internal project PsiBee and the external project Fuzzy Asteroids. The game has ships that shoot bullets at asteroids to gain score. Ships can collide with asteroids and other ships and lose lives.
https://github.com/ThalesGroup/kessler-game
Apache License 2.0
10 stars 11 forks source link
arcade-game machine-learning real-time-control simulation

Kessler

Getting started

Kessler is a simulation environment loosely modeled after our internal project PsiBee and the external project Fuzzy Asteroids. The game has ships that shoot bullets at asteroids to gain score. Ships can collide with asteroids and lose lives. If the ship runs out of lives, the game terminates. In multi-ship scenarios, ships can collide with each other as well, but cannot shoot each other.

Kessler can be built as python extension for install using pip, or used as a local package by copying the src/kessler_game directory to your project. Wheels are provided in releases for install using:

pip install <path to kessler_game-#.#.#-py3-none-any.whl>

Kessler has two primary graphics modules. The first uses Python's Tkinter UI library to display the game. The second utilizes a separate executable process called kessler_graphics made in Unreal Engine 5. Data is sent to the kessler_graphics instance using UDP protocol on a local machine.

Using the UE5 graphics engine

Under kessler_graphics is an Unreal Engine 5 project for receiving simulation data from the Kessler Python process and displaying it in a 3d environment. To contribute to the UE5 project, you will need to do the following.

Documentation

Documentation is not yet available for Kessler. If you would like to contribute to documentation, check out CONTRIBUTING.md for info on how to get started

Contributing

If you are interested in contributing to the Kessler project, start by reading the Contributing guide.

License

Kessler is licensed under the Apache 2.0 license. Please read LICENSE for more information.