Breakbeat

A Vertical Scrolling Rhythm Game (VSRG), similar to osu!mania and heavily inspired by Stepmania, written in C++ using the OpenGL specificiation and various other libraries.

Contains charts converted from osu!mania.

Gameplay

8mb.video-1jq-dUpJVTok.mp4

Support

• Only works for Windows 64bit and 32bit
• Need a graphics card that supports opengl 3.3+
• Might not work for some integrated graphics cards due to bindless textures in use

Instructions (Releases)

Dependencies (Releases)

• Microsoft Visual C++ Redistributable 2015–2022
  Download Redistributable

Steps

1. The .exe is available in the Releases section.
2. Download and extract the breakbeat.zip in the release. The zip contains the binary .exe.
3. The charts.zip in the release contains independent chart files. Extacting breakbeat.zip alone will render the breakbeat.exe without ready charts.

• This is what the game chart selection screen will look life you have no charts:

4. To have ready to play charts, download charts.zip in the Releases sections, extract them and place them in the game folder.

• With ready made charts in the game folder, the chart selection screen should now look like this:

Instructions (Build)

Dependencies (Build)

• CMake (version 3.30+)
  Download CMake

• Microsoft Visual C++ Redistributable 2015–2022
  Download Redistributable

• MSVC Build Tools (needed to compile with CMake)
  Download Build Tools

Build Steps

1. Install the Microsoft C++ Redistributable 2015–2022, CMake, and MSVC Build Tools if not already installed.

2. In your desired folder, clone the repo by opening a terminal and run:

git clone https://github.com/TomObungu/breakbeat.git
cd breakbeat

3. In the terminal in the repo folder, run:

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --config Release

5. The executable breakbeat.exe will appear in the project root alongside the .dll files. Run it directly.
6. If you have Visual Studio installed, the .sln file will be in the build folder. Opening it will allow viewing of source code.

Installation Issues

• If you recieve an error such as MSVCP140.dll is missing then it means you do not have Microsoft Visual C++ Redistributable 2015-2022.

Known Bugs

• The text in the settings menu will show trailing zeros after the decimal point whilst editing scroll speed
• Creating a new chart in the chart editor may not always let you place notes in the chart nor will the grid lines show up
• Sometimes pressing enter twice whilst editing settings crashes the game
• Playing another chart after finishing a chart entirely will cause the chart to never advance to the scores page
• Trying to load into another chart after finishing a chart may cause the chart to text to be black and the song to not load
• The difficulty calculation of beatmaps is not accurate