Burger Game

About the Game

Create tasty burgers by piling up falling ingredients. Pay attention to specific orders as customers don't like unexpected or missing ingredients. Serve them well and you will become a successful burger shop.

A simple 2D game built with Golang and Ebitengine.

How to Run

• Ensure Go is installed on your system
• Download and extract or git clone this repositories content to your local machine
• Navigate into your local repository directory (e.g. in the terminal) and run go run main.go

How to Play

• Use the left and right arrow key to move falling ingredients to another lane.
• Use the down arrow key or simply wait to ensure an ingredient is stacked on top of a burger.
• Press digit keys 1, 2 or 3 to sell the burgers 1, 2 or 3 respectively.

Troubleshooting

No Audio

You should hear some audio effects while playing the game, e.g. when selling a burger. If you don't hear any sounds while playing, check your audio output device and volume, make sure it is not muted. If it is still not working, and you are running on Linux, you may need to apply subsequent workaround to disable a problematic audio module. This worked for me, but please use it carefully at your own risk and revert it in case of any issues:

• Open following config file for editing: /etc/modprobe.d/alsa-base.conf
• Append an option to disable the possibly problematic module: options snd-hda-intel model=auto blacklist snd_soc_avs

Media Sources

Thank you to all creators of the included free images and sounds.

• For image sources and attributions see resources/images/sources/sources.md
• For sound sources and attributions see resources/sounds/sources.md

Tools Used

• Go as the general programming language.
• Ebitengine for building a 2D game.
• GIMP for extracting ingredient images from source pictures.
• ffmpeg for adapting audio properties like sample size and volume.

Improvement Ideas

• Consider an intro screen that explains how to play the game and how the score is determined.
• Improve logging, e.g. use slog for more structured logging, revisit and introduce logging with proper log levels and configuration.
• Simplify implementation of Game.move method. Avoid recursive call for handling lane change not possible.
• Improve audio control for playing sounds, seems like actual volume is not influenced by system volume, at least on Linux.
• Add more automated tests where easily possible.
• Improve randomness of burgers, e.g. exclude mix of meat and veggie patties, avoid too many repetitive etc.
• Improve scoring of burgers, e.g. introduce higher weight for unexpected or missing patty types, treat expected / unexpected ingredients in a better way.
• Check screen resizing and behavior on screens with smaller / larger sizes.
• Improve layout, separate build from order section more clearly.
• Add a time limit to determine when the game is over.
• When the game is over (i.e. time is up) show the points more prominently and display each built burger vs ordered burger including points won and lost (reasons).
• Introduce a forced sell when the middle burger is too high for new ingredients to spawn (the game stops in this case at the moment).
• For deployment embed all resource, including sounds into the application (more reliable loading).
• Consider refactoring for common image wrappers like Part and Plate (extract common parts, reuse where possible).
• Improve visibility of mayo and onions (make sure they can be distinguished in the order view).
• Check available fonts and if there are any font resources that need to be added.