Bomberland engine + starter kits

About

Bomberland is a multi-agent AI competition inspired by the classic console game Bomberman.

Teams build intelligent agents using strategies from tree search to deep reinforcement learning. The goal is to compete in a 2D grid world collecting power-ups and placing explosives to take your opponent down.

This repo contains starter kits for working with the game engine + the engine source!

Contributing

Contributions are always welcome, see our contribution guidelines here

Usage

Basic usage

See: Documentation

1. Clone or download this repo (including both base-compose.yml and docker-compose.yml files).
2. To connect agents and run a game instance, run from the root directory:

docker-compose up --abort-on-container-exit --force-recreate

3. While the engine is running, access the client by going to http://localhost:3000/ in your browser (may be different depending on your settings).
4. From the client, you can connect as a spectator or agent (to play as a human player)

Open AI gym wrapper (experimental)

docker-compose -f open-ai-gym-wrapper-compose.yml up --force-recreate --abort-on-container-exit

Starter kits

Kit	Link	Description	Up-to-date?	Contributed by
Python3	Link	Basic Python3 starter	✅	Coder One
Python3-fwd	Link	Includes example for using forward model simulator	✅	Coder One
Python3-gym-wrapper	Link	Open AI Gym wrapper	✅	Coder One
TypeScript	Link	Basic TypeScript starter	✅	Coder One
TypeScript-fwd	Link	Includes example for using forward model simulator	❌	Coder One
Go	Link	Basic Go starter	❌	dtitov
C++	Link	Basic C++ starter	✅	jfbogusz
Rust	Link	Basic Rust starter	❌	K-JBoon

Discussion and Questions

Join our community on Discord.

Please let us know of any bugs or suggestions by raising an Issue.

Changelog

See changelog here