fabianishere/boot2flappy repository overview

⁠boot2flappy

Flappy Bird for UEFI written in x86 Assembly.

⁠Getting the source

Download the source code by running the following code in your command prompt:

$ git clone https://github.com/fabianishere/boot2flappy.git

or simply grab⁠ a copy of the source code as a Zip file.

⁠Building

We provide two ways for building the project: manually on your local system or in a container using Docker. If installing the required dependencies is not trivial or unwanted, we suggest building the project with Docker⁠.

⁠Manual

Create the build directory.

$ mkdir build
$ cd build

boot2flappy requires CMake and a specific C cross-compiler (namely mingw-w64-x86-64) in order to build. On Ubuntu, please install the following packages:

• binutils-mingw-w64
• gcc-mingw-w64-x86-64

Then, simply create the Makefiles:

$ cmake ..

and finally, build it using the building system you chose (e.g. Make):

$ make

⁠Docker

Build the project with the provided fabianishere/boot2flappy container as follows. Make sure you run the command in the project root directory.

$ docker run --rm -it -v `pwd`:/root/boot2flappy fabianishere/boot2flappy

This will build the project in the build/ directory.

⁠Playing

⁠QEMU

After building the project, in the build directory, run the following code in your command prompt:

$ vm/start.sh

This will start a QEMU virtual machine in which you can play the game. Make sure QEMU is installed.

⁠Why

One of the assignments for the Computer Organisation course of 2016 at Delft University of Technology was to create a bootable game in x86 assembly. Why not create a simple EFI game with nice graphics?

⁠License

The code is released under the MIT license. See the LICENSE file.

All sprite files in the resources directory: all copyrights belong to their respective owners. The files are used for education purpose only.