Skip to content

VenKamikaze/BitRiot

Repository files navigation

BitRiot

Clone / re-implementation of the Amiga BugBomber game

Screenshot

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.

Tags

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

Changelog

v1.41

Bugfixes:

  • 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

v1.40

Feature:

  • 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

Bugfixes:

  • 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

Branches

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.

TODO

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)

Build

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

CMake

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

git clone --recurse-submodules https://github.com/VenKamikaze/BitRiot.git
cd BitRiot/target
cmake ../
make
./BitRiot

CMake with MinGW

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

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: