https://github.com/unitytechnologies/machinelearningroguelike

A small Roguelike game that uses Machine Learning to power its entities. Originally used in talks by Ciro & Alessia.
https://github.com/unitytechnologies/machinelearningroguelike

2d ai cinemachine intermediate machine-learning reinforcement-learning unity

Last synced: 6 days ago
JSON representation

A small Roguelike game that uses Machine Learning to power its entities. Originally used in talks by Ciro & Alessia.

• Host: GitHub
• URL: https://github.com/unitytechnologies/machinelearningroguelike
• Owner: UnityTechnologies
• License: other
• Created: 2017-11-27T16:11:29.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2022-03-17T18:01:42.000Z (almost 3 years ago)
• Last Synced: 2024-12-30T04:15:29.805Z (13 days ago)
• Topics: 2d, ai, cinemachine, intermediate, machine-learning, reinforcement-learning, unity
• Language: C#
• Size: 3.85 MB
• Stars: 443
• Watchers: 37
• Forks: 84
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# Machine Learning Roguelike

![MLRoguelike](https://i.imgur.com/Cxf4PaK.png)

## Description

A small Roguelike game that uses Machine Learning to power its entities. Both the player and its enemies are ML Agents, and the demo is a good playground to test Machine Learning in a real game environment. A scene specifically for training is included, to demonstrate how to train the agents in a different environment than the one where the game is going to happen. This demo also features the use of Cinemachine for 2D and Tilemap.



Originally used in Codemotion (Milan) and DevGAMM (Minsk) talks by Ciro Continisio & Alessia Nigretti.


## Documentation

**Objective**

This project is intended to demonstrate a practical application of the Machine Learning Agents in a real game.

**Usage instructions**

Please note that this project is using v0.2.1d of Unity ML-Agents.

To try out the project, you need to add the [Tensorflow Sharp plugin](https://s3.amazonaws.com/unity-ml-agents/0.5/TFSharpPlugin.unitypackage) to your Assets folder. More information on how to set up Tensorflow Sharp Support is provided [here](https://github.com/Unity-Technologies/ml-agents/blob/0.2.1d/docs/Getting-Started-with-Balance-Ball.md).
 

To be able to train the agents, make sure that the Python API is installed in your system. [This](https://github.com/Unity-Technologies/ml-agents/blob/0.2.1d/docs/installation.md) is a guide on how to do it. Then, add the [python folder](https://github.com/Unity-Technologies/ml-agents/blob/0.2.1d/python) from the Machine Learning Agents repository to the project (outside the Assets folder).



Refer to the [Machine Learning Agents wiki](https://github.com/Unity-Technologies/ml-agents/tree/0.2.1d) for further instructions on how to set up the project for external training.


**Extra Materials**

Information on how this project was created is available on the [blog post](https://blogs.unity3d.com/2017/12/11/using-machine-learning-agents-in-a-real-game-a-beginners-guide/).


Slides: [Link](https://docs.google.com/presentation/d/1Cs2r8eRLkcjqyKXUT5O96VAZ7NsvlNmSI1eFbGFhx3w/edit).


Talk video: [Link](https://www.youtube.com/watch?v=ZIHJ28oz3hk).

**Software Requirements**

Required: Unity 2017.2, or later version

**Hardware Requirements**

Required: Any computer (Win or Mac)

**Owner and Responsible Devs**

Owners: Alessia Nigretti ([email protected]), Ciro Continisio ([email protected])

Original graphics: Michele "Buch" Bucelli on [OpenGameArt](https://opengameart.org/content/a-blocky-dungeon) under CC0 License

**Major Change Log**

- 24 Oct: Created repository

- 14 Nov: First real working copy

- 27 Nov: Updated for public use, added license, Readme

- 11 Dec: Repository is public