Documentation

On this page

FAQ

Bullet Hero is a free hybrid of a rhythm game and bullet hell. No account is needed, and there is no server yet. Players make levels in the built-in editor and pass them on as a folder or an archive

The game

What is Bullet Hero?

A hybrid of a rhythm game and bullet hell. A level is music and shapes that move to it. You steer a small square, and it has to survive to the end of the track

Bullet Hero is built as an engine for the genre. So most levels are made by players in the built-in editor. More - Game

Is the game free?

Yes. The game has no purchases, no ads and no paid content. More - Licensing: the essentials in three minutes

Where can you get it?

Every build and store - Download

The game is released, version gv 1.3.0. The builds are unsigned

Does it need an account or the internet?

No. There are no accounts and no server, and the game sends nothing anywhere

The internet is needed only by one kind of level: one that loads a file from its author's web address. More - Installation

Where are the levels stored?

In the levels folder inside the game's data folder. To open it: Settings → General → Open Game Folder. More - Installation

Playing levels

How do you play a level someone sent you?

Put the folder into levels and press Scan again in the level list. An archive (.zip, .tar.gz) opens through the editor, with the Level Archive generator. More - Playing levels

The game says the level is from a newer version. What now?

Update the game. An old version does not open files from a newer one, so that it never reads them wrongly. More - Troubleshooting

Can a forgotten level password be recovered?

No. The key is not stored anywhere: not in the game, not in the file, not with anyone. More - Troubleshooting

Can the game play a level by itself?

Yes, the Bot condition on the level screen: Reflex Bot v1 or Warm Bot v1. A bot has the same controls as you, and it can lose too. More - Bots

Editor in the main menu, then Editor Settings, then Create Level. Copy a track into the level folder, set the tempo (bpm), place an object with two keyframes and run a playtest. More - Your first level: the route

Which music files work?

ogg, mp3 and wav, nothing else. flac, aiff and tracker modules do not load

ogg is the best choice. It is 8-10 times smaller than wav and, unlike mp3, adds no silence to the start. More - Preparing the track

Can I use any song?

Nothing is checked on your own disk. The licence of the music matters when a level is offered to a service, and there are no such services yet. More - Licensing: the essentials in three minutes

By hand, as a folder or an archive. A Steam build can also publish a level to Steam Workshop. There is no official server yet. More - How to share a level by hand, Publishing

The project

Are there online leaderboards or a level catalogue?

Not yet. The official server and community servers are in development. More - Servers

Why is the game's code closed?

I have personal reasons for it. When development stops for good, every repository will become open, and the bullet-hero organization may be handed over to someone else

The SDK, the documentation and the future server are open already. More - Welcome

Found a bug?

Report a bug in the game in bullet-hero/releases. Bring questions to Discord. Where to write and what to attach - Help and bug reports

All the project's links - Links and community

FAQ