Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Clone / re-implementation of the Amiga BugBomber game


This game is a re-implementation of 'BugBomber' - a great Amiga game that is similar to Bomberman but with a twist of being able to spawn your own helper robots. I found the code for BitRiot when I was searching to see if anyone recreated bomberman. It was built by one guy as a university project and posted to a forum.

It was original built against the win32 API, and I figured I'd like to learn the difficulties in porting a game from win32 to something Linux native. I wasn't quite ready to jump into OpenGL / 3D APIs, so I took the approach of porting to SDL 1.2.x with normal software blitting.

I contacted the original author and they were happy for me to work on this code. When I asked about licencing they said they would have licensed it as something free "like Apache", hence the Apache Software License now added to the source code!

Thanks to contributors, the game now supports SDL2 and game controllers!

There are also older versions of the game code working with SDL 1.2.x, and an even older version that was originally written against win32 + directdraw. Note that tags before sdl2 are not maintained and do not have the fixes the SDL2 version contains.


Here's an example of the tagged releases:

  • win32-v1
  • sdl-v1.1
  • sdl2-v1.2
  • sdl2-v1.3
  • sdl2-v1.39
  • sdl2-v1.40
  • sdl2-v1.41

This indicates both the framework used underneath (win32, sdl, sdl2), plus the version of the game code, e.g. v1.1, v1.2. It means that the sdl2-v1.41 tag contains a lot of fixes and changes that are not within the sdl-v1.1 tag.

The master branch typically has the latest stable sdl2 code. It may or may not advance further as I don't have as much time to spend on this as I'd like. That being said, I'm very open to any contributions. Contributions to this code base are what enabled SDL2 support in the first place.

The newest SDL2 version (v1.41) now supports a larger map option on startup (-b), fullscreen (-f), game controllers (plus rumble support) and hot joining (take over from CPU player), and a menu system.

Larger map screenshot




  • Resizing window in menu system did not adjust renderer, causing letterboxing of view.
  • SDL GameController was not being initialised - controllers were non functional in 1.40



  • Switch to RmlUi which is a forked and supported version of libRocket
  • Implement additional toggle option in Game Options menu (total players)
  • Add a scoreboard showing the winner's statistics
  • Support SDL2 2.0.18+ (this is now a minimum)
  • Resizable window


  • Handle escape key in menu system
  • Minor cleanup of menu styles / layout
  • Autofocus an element on new menu open
  • Fix up conflicting rendering calls when in menu system
  • Fix up letterboxing of game rendering when going from menu -> game


The 'develop' branch should contain the latest development code for BitRiot, stability is not the primary concern of this branch. The 'master' branch should have somewhat stable / tested code within it. If you are looking to branch to add features, please fork and branch from 'develop' and file pull requests back to that branch, I'm thankful for any contributions you can make.


Things that I'd like to do, but likely won't ever find time for (in order of personal interest). Note if the top two items are completed I'll remove the 'Beta' tag from the game title:

  • Create a player select menu before starting a game and remove 'Human Players' option in Game Options.
  • Allow toggle of map height/width in menu options
  • Scaling and fullscreen options (mostly done - fullscreen parameter '-f' available - (should be added to Game Options), resizing window works fine).
  • Cleanups (code formatting and style, also some collections always grow e.g. in the input code)
  • Write up some notes to explain the porting process to SDL2, as a quick 'n' dirty tutorial for others thinking of doing this for other games.
  • Network play (this will probably never get done)


To build the game, first make sure you have the necessary dependencies installed on your system. The main master branch is now using SDL2 and RmlUI. Assuming you are compiling this branch, you will need: CMake 3.4.3, SDL 2.0.18+, SDL2_mixer and SDL2_ttf, SDL2_image, RmlUI v4.3+, FreeType.

on ubuntu/debian:

sudo apt-get install cmake libsdl2-dev libsdl2-ttf-dev libsdl2-mixer-dev


Get the BitRiot code and the RmlUi submodule. Build BitRiot and run it.

git clone --recurse-submodules
cd BitRiot/target
cmake ../

CMake with MinGW

cd BitRiot
target/cmake.exe -G "MinGW Makefiles" ..

Steps shown above:

  1. Clone the BitRiot repository and submodules (includes RmlUi)
  2. Change into the target directory inside your cloned BitRiot repository
  3. Generate a Makefile with CMake
  4. Build it
  5. Run the game - you should now have a 'BitRiot' executable in your current directory: