💣 Bomberrage

Join our Discord ››
Releases · Kanban Board

🌟 About

Bomberrage is an open-source indie game developed on Unreal Engine 5 for Windows, MacOS and Linux.

Forget hidden exits and classic rules - Bomberrage is a fast, competitive game where you beat tough AI or friends in explosive multiplayer battles!

Table of Contents

• 💣 About the Bomber Project
• 🚀 Getting Started
• 💻 Platforms and Requirements
• 🛠 Key Features
• 💾 Play the Build
• 📋 Kanban Board
• 📅 Changelog
• 🎮 Overview
• 🧑‍🤝‍🧑 Credits
• 📫 Feedback & Contribution
• 📜 License

🚀 Getting Started

This project contains submodules and requires --recurse-submodules when cloning:

git clone --recurse-submodules https://github.com/JanSeliv/Bomber.git

If already cloned without submodules, you'll find empty folders in Bomber\Plugins and error on project startup. To download submodules separately, run:

git submodule update --init --recursive

💻 Platforms and Requirements

The project has been tested and verified to run on the following platforms:

• Windows 10 22H2
• macOS Sonoma 14.4 (Apple M2 hardware)
• Ubuntu 22.04 LTS

Project Disk Space: 33GB

🛠 Key Features

This project could be useful for learners, demonstrating next features:

• Multiplayer
• Procedurally generated playfield
• Challenging AI
• Enhanced Input
• Modular Game Features
• Complex cinematics (Level Sequences)
• World Partition
• Model-View-ViewModel (MVVM) UI Pattern
• Data-Driven Design (Data Assets, Data Tables, Data Registries, see below)

Despite this project is fully written in C++, it's extremely blueprint-friendly:

• Data-Driven Design: No hardcoded values. All data can be tweaked via Data Assets in editor as well as accessed in blueprints [doc].
• Fully Exposed: Every class, property, and function is exposed to Blueprints allowing for heavy changes the logic with no code.
• Well-Commented: Every class, property and function is well-commented for easy understanding.
• Utility Libraries: Core static functions are accessible globally like Cell Utils [doc]. See more in the Source\UtilityLibraries folder.

Next plugins were developed for this project, but could be useful for other developers:

• ⚙️ Settings Widget Constructor
• 🔄 Pool Manager
• 🎭 Morphs Player
• ƒ Function Picker
• >_ Meta Cheat Manager
• ✂️ Level Sequencer Audio Trimmer

💾 Play the Build

To download and play the build, visit GitHub Releases or GDrive.

Want to test develop branch on Steam? Message me for a key.

📋 Kanban Board

Stay updated with the current progress and plans on the Trello board.

📅 Changelog

2024-12-29:

• Updated to Unreal Engine 5.4.
• Added Linux support (tested on Ubuntu 22.04 LTS)
• Introduced In-Game User Interface with completely new look, utilizing the Model-View-ViewModel (MVVM) pattern:

• Added cinematic for the Roger character on the Maya level by Kateryna Shchetinina:

• Added cinematic for the Bastet character on the Maya level by Kateryna Shchetinina:

• Implemented Switch Camera Transitions between characters in Main Menu:

• Unique Bomb VFX for each character:

• Implemented Progression System by Valeriy Rotermel that unlocks new playable characters as you progress in the game:

• New Box and Wall meshes for the Maya level by Maksim Shashkov:

• Implemented Credits screen by Yevhenii Oksenchuk:

• New Splash by Maksim Shashkov:

• Converted the Maya level to the World Partition to benefit from automatic streaming and External Data Layers.

---

2024-01-13:

• Updated to Unreal Engine 5.3.
• New Main Menu with completely different UI and complex cinematics for Hugo and Fori characters on starting the game:

• New Bomb meshes for each character (shown from left to right: Bastet, Hugo, Fori, Roger) by Maksim Shashkov:

• New game icon:

---

2023-06-12:

• Updated to Unreal Engine 5.2.
• Added MacOS support.
• Added Ultra-wide resolutions support.
• Extracted logic into plugins, so other developers can benefit from it in their projects
• Added Foot Trails for the Maya level by Anton Selivanov:

• New power-ups meshes for the Maya level (shown from left to right: move speed, bomb length, bomb quantity) by Maksim Shashkov:

• Added new cheats such as: Bomber.Level.SetSize 9x7 (find more on the Bomber cheats page)
• Updated Main-Menu background music.

---

2022-05-31:

• Added initial multiplayer support for 4 players (without Steam now, use 'Open' command to connect to each other).
• Created the Pool Manager for the generated level to avoid spawning and destroying actors on each level reconstruction.
• Added new SteelMan character for AI players with 3 different skins by Kateryna Shchetinina:

---

2021-12-31:

• The game migrated to the Unreal Engine 5.
• Added sounds (background music, UI, in-game sounds) and sliders to tweak volumes in Settings Audio tab (Master, Music and SFX).
• Added Controls tab in Settings to allow player remap input keys.

---

2021-06-03:

• Added the Maya level by Maksim Shashkov:

• Implemented Settings screen:

---

2021-01-31:

• Added the Bastet (Sphynx cat) and Roger (Pirate) characters by Kateryna Shchetinina:
• Fori and Hugo characters got additional second skins by Kateryna Shchetinina:

---

`25.10.2020:

• Added the Hugo and Fori characters by Kateryna Shchetinina:

---

2019-10-15: Uploaded first game-ready build.

🎮 Overview

The level camera that moves and zooms lens depending on the distance between players:

Level actors

• Items that affect the abilities of a player during gameplay:

Skate: Increase the movement speed of the character.

Bomb: Increase the number of bombs that can be set at one time.

Fire: Increase the bomb blast radius.

• Bombs: are left by the character to destroy the level actors. Triggers other bombs and prevents players from moving through the bomb after it has been left behind.
• Walls: are not destroyed by a bomb explosion and stop the explosion.
• Boxes on destruction with some chances spawn an item.
• Players and AI - characters whose goal is to remain the last survivor for the win.

Game interface

The number of items that are shown at the left side of the player’s avatar, the timer that is placed under and at the right side is shown the number of alive players:

The game menu is shown the result of the games match (win, lose, draw). If the match has not yet finished, it could be minimized or opened out by ESC button in order to continue watching the game or restart the play, or to return to the main menu:

• Shows the win notification when there is one character left:

• Shows the draw when the last players are killed at the same time or at the end of game timer:

• Shows the lose when the player was killed:

Procedural generation

• Symmetrical regeneration for each new game:

• Scaling sides sizes in the editor or sizes selection in the start menu:

Cells Data Structure

• Actors snapping to the center of the cell:

• Searching of the nearest cell to an actor:

The Map Component

These components manage their owners and update this level actors in case of any changes on the map that allow to:

• Prepare in advance the level actors in the editor time:

(Dragged from the Content Browser the wall, the character, the item, the box, and the bomb, that correctly exploded due to Maps Components)

• Free location and rotation of the level map in the editor time:

Artificial Intelligence

Bots behave like players with no use of the Unreal NavMesh:

• They can find items even around the corners and are able to manage their priorities correctly:

(There are three items: A - the nearest under the bomb explosion, B - the item that is placed around the corner near the enemy character. C - the farthest safe item. The bot does not risk and chooses to move to the C)

• Emergency Priority Change:

(The bot runs for the item, the player otherwise set the bomb. Meanwhile, the bot changes direction and runs off the bomb)

• The bots even survive through in the midst of explosions:

• The editor preview visualization for selected bot automatically updates upon any changes on the map including addition from the Content Browser or drag-and-drop.

Where is :

Green +: a safe crossway.

Red +: crossway which has at least one enemy character.

Yellow F: filtered cells for moving.

Grey Х: the selected cell on which the bot moves to.

🧑‍🤝‍🧑 Credits

• Yevhenii Selivanov - Programming - GitHub, Telegram
• Maksim Shashkov - Level Design & Level Art - Artstation
• Kateryna Shchetinina - Characters & Animations - Artstation
• Yevhenii Oksenchuk - Game Design (Audio, UI, and Cinematics) - Telegram
• Valeriy Rotermel - Progression System - GitHub
• Anton Selivanov - Foot Trails - GitHub

Special thanks to the following companies for providing their licenses to support our open source development:

• JetBrains Rider - cross-platform .NET IDE.
• PVS-Studio - static analyzer for C, C++, C#, and Java code.

📫 Feedback & Contribution

Feedback and contributions from the community are highly appreciated!

• Tasks: Check our Google Sheets Tasks List and Bugs Backlog on Trello. Unassigned tasks and bugs are open for contribution.
• Report & Suggest: Found a bug or have a feature idea? Open an issue.
• Fork & Pull: Fork the project, make your changes, and submit a pull request to the develop branch.
• Standards: Adhere to the Unreal Engine Coding Standards and Naming Standards when contributing.
• Blueprints & Assets: If contributing blueprint logic or assets, attach screenshots to show what has changed.

📜 License

This project is licensed under the terms of the MIT license. See LICENSE for more details.

We hope you find this project useful and we look forward to your feedback and contributions.