Floppy Bird

Floppy Bird is a clone of the infamous Flappy Bird written in 16 bit (x86) assembly.

In other words it works on RAW METAL and doesn't require an underlying operating system, it is an operating system on its own.

Controls

• Escape - reboot
• Backspace - randomize background
• Tab - randomize bird
• Any key - start the game, flap the wings

Getting Started

If you just want to try it out there's no need to install the development tools because you can use one of the provided 'disk images'.

However, if you really want to 'compile' it yourself then you'll need to install the following tools:

• NASM (required)
• QEMU (optional, needed for testing)
• GIMP (optional, needed for altering "graphics")

To build it just type in any terminal:

make
make iso

How to edit the TGA images with GIMP (tested at 2.8.22)

• install the required VGA palette located at ./data/rgb/palette/ to GIMP
• import the source image from the rgb directory - i.e. ./data/rgb/bird.tga
• Image -> Mode -> Indexed... , Use custom palette (don't remove the unused colors)
• if needed (i.e. bird.tga) add a new background layer, fill with black then merge
• do your edits, if needed update the sizes at ./src/game/data.asm and other places
• export as uncompressed TGA with origin set to Top-Left and 256 color map (palette)

Versions

• build/floppybird.img - Image for Floppy / USB Drives
• build/floppybird.iso - for CD-ROM Drives (with Floppy Emulation)

Virtual Machines

QEMU and VirtualBox have been tested and fully supported.

qemu-system-i386 -boot a -fda build/floppybird.img

WARNING

I am not responsible for any direct or indirect data loss after performing any of the destructive operations presented below.

BE SURE TO BACKUP THE CONTENTS OF YOUR FLOPPY/USB DRIVE.

Linux/Mac (in other words *unix)

You can use the dd utility or your favorite CD Burner like Brasero.

dd if=build/floppybird.img of=/dev/sdb

In the example above, /dev/sdb is your USB Drive.

Windows

You can use the Raw Write 32 utility or your favorite CD Burner like CDBurnerXP.

M$-DOS (BONUS)

It is also possible to run Floppy Bird as a regular .COM executable in any DOS-like environment, like DOSBox for instance.

To build it type:

make com

And then to run it type:

dosbox build/flpybird.com

Note: Make sure to set the cycles to a reasonable value like 10000 for an enjoyable experience.

Contribute

• Fork the project.
• Make your feature addition or bug fix.
• Do not bump the version number.
• Send me a pull request. Bonus points for topic branches.

License

Copyright (c) 2014, Mihail Szabolcs

Floppy Bird is provided as-is under the MIT license. For more information see LICENSE.