BubbleShooter

Introduction

BubbleShooter is a captivating bubble shooter game with a unique twist - a rotating board and an endless number of levels but a finite timer, making it a challenge to reach the highest score possible. This project leverages the SDL2 library for rendering, event handling, and audio playback, ensuring a pleasing gaming experience for the player.

Demo Animation

Features

• Dynamic Rotating Board: Test your aiming skills on a board that keeps turning, adding a layer of strategy to the classic bubble shooter gameplay.
• Unlimited Levels: The fun never ends with levels that increase in difficulty and complexity.
• Game Customization: Players can tweak game settings like the timer in the config.txt file for a personalized experience.
• Sound Effects: From shooting bubbles to achieving combos, every action is accompanied by satisfying sound effects, enhancing the game's immersion.
• Score System: Keep track of your progress with an in-game scoring system.

Installation and Running

Ensure SDL2, SDL2_image, SDL2_ttf, and SDL2_mixer are installed on your system. Clone the repository, compile using the provided Makefile, and run the game:

git clone https://github.com/danielw98/BubbleShooter.git
cd BubbleShooter
make
./BubbleShooter

Gameplay Mechanics

• Aim and shoot bubbles to form groups of three or more of the same color to clear them from the board.
• Clearing combos causes all unconnected bubbles to fall, not just the matched ones, adding a satisfying twist to the gameplay. Your score increases based on the size of the combo, so try maximizing the number of bubbles you clear in a move.
• Progress through the levels by clearing all bubbles before time runs out, maximizing your score.
• Spare Ball: there is a spare ball in the left which you can toggle using SPACE key
• Score Multiplier: there is a multiplier bar so when you hit 5 consecutive combos in a row without missing, the score you get for the next combos will be 150% of the normal score, until missing or not making a combo, and the bar resets.

Dive Into the Code

The core of BubbleShooter is split into a more modular architecture, with key functionalities distributed across various files in src/ for implementations and include/ for declarations:

• Gameplay Dynamics: Game.cpp orchestrates the main game loop, interactions, and state transitions, ensuring fluid gameplay.
• Entity Management: Entity.cpp and Bubble.cpp define the game entities and their behaviors. Entity.cpp serves as a base for game entities, while Bubble.cpp specifically handles bubble characteristics and actions.
• Level Management: LevelManager.cpp dynamically manages game levels, including loading and setting bubble configurations per level.
• Collision and Matching: MatchFinder.cpp is responsible for detecting matches of bubbles and handling the game logic for clearing matched bubbles.
• Rendering and GUI: GUIManager.cpp and FontRenderer.cpp manage the graphical user interface, rendering text, and other GUI elements.
• Audio Management: SoundManager.cpp handles all game sounds, from shooting bubbles to combo sounds, enhancing the game's auditory feedback.

Supporting enums in include/enums/ and structures in include/structs/ organize the game's configurations and states, promoting a clean and understandable codebase.

Each component plays a pivotal role in bringing the dynamic and engaging gameplay experience of BubbleShooter to life. Check the contents of these files to explore the game's implementation details, from the rendering techniques to the logic behind the rotating board and bubble interactions. Assets for the game are located under assets/.

Contributing

Contributions are welcome! Whether it's adding new features, fixing bugs, or improving the code, feel free to fork the repository and submit a pull request.

License

BubbleShooter is open-sourced under the MIT License. See the LICENSE file for more details.