Troubleshooting

A level copied by hand shows up in the list after a new scan. A level from a newer version needs a game update, and a .7z archive needs repacking into zip. A forgotten password cannot be recovered. Discord shows your activity only in a Steam build, with the Discord app running

Didn't find your problem? Where to report it - Help and bug reports

A level is not in the list

• Copied by hand. The level folder must sit directly in levels, Installation. After copying, press Scan again
• A Workshop item. The Steam build shows only your subscriptions. Settings → General → Show All Found Content adds the folders found on disk. They are marked Not subscribed
• Nothing shows at all. The levels folder may be unreachable. In that state the storage cleanup in Other does not run and says The level scan found nothing, so this cleanup was refused

A level does not load

The loading screen shows the stage: Reading level, Checking level, Loading resources, Building level

• A file from a web address. A level can take a file from a link instead of keeping it in its folder. General → Resource Web Timeout is how many seconds the game waits for such a file
• A damaged level. A level in Json is text, it can be read by eye. A damaged Blob is refused whole. More - The level folder and backups
• An error window. It has Copy, Save Report and Open Reports Folder. The report goes to the reports folder. Attach it to a bug report in bullet-hero/releases, Help and bug reports
• Level needs more objects per frame than this device allows. This is not a loading error. The level plays, but part of it is not drawn. More - Level budget

"Update required"

An older version of the game does not open files from a newer one. Update the game

A card marked Newer version or From a newer version of the game is the same refusal. It shows before the level is even opened

Settings or statistics from a newer version

In this case the game runs on defaults. Until it is closed it saves nothing of its own, and the newer files stay untouched. This is anonymous mode, Settings. With --suppress-game-saves there is no Overwrite data button

Level statistics from a newer version are not shown. Playing the level overwrites them, unless saves are turned off

Why the game refuses

Every change to the file format gets a new generation number. A build does not read a file of a newer generation, so that it does not read it wrong

A protected level

Before opening, the game asks for a Password. The password is asked once per session and kept only in memory

Only the content is encrypted: objects, keyframes, themes. The title, cover and media stay readable, so the card shows even without the password

Deleting a protected level does not need the password

An archive is refused

A renamed archive is not a problem: the game recognizes the format by the file's bytes. Which archives are accepted - Playing levels

Discord does not show what I am playing

• Not a Steam build. Only the Steam builds show your activity in Discord
• Discord is closed. The Discord desktop app must be running on the same computer. Started it after the game? The status appears on the next screen change
• Activity is hidden. In Discord: User Settings -> Activity Privacy -> share your detected activities
• A level of your own shows no name. By design: only a Workshop level or one that ships with the game is named, and the editor never names its level. Why - Game privacy policy › Discord Rich Presence