Troubleshooting

This page lists the most commonly reported issues and most common technical questions. It is up to date as of 2025-12-28.

AMD Driver Issues

There are a number of graphical glitches caused by the latest AMD drivers. This can cause sprites to appear black, go invisible, or rotate in unintended ways.

Bytten Studio has been in touch with staff at AMD and AMD has confirmed the issue and that it will be fixed in an update. The solution for now is to downgrade to driver version 25.9.2 which is known to work correctly with Cassette Beasts.

Local co-op

In co-op, the second player takes control of Kayleigh (or whoever the first player's partner character is). In order for that to be possible, you must first unlock Kayleigh as a partner, which is 2 minutes into the tutorial - just follow Kayleigh's instructions.

After Kayleigh has been unlocked:

1. Pause the game
2. Press LB + RB on a controller
3. You can now assign a controller to Kayleigh

Crash

There is only one known crash currently that affects users of laptops with Intel integrated graphics. It is believed to be caused by a buggy driver. If this affects you, see Other Issues.

Save file corruption

This can happen if your computer suddenly lost power, or a storage device was removed unexpectedly while the game was saving.

Save file corruption is hard for games to avoid as it is very hardware / OS / filesystem specific. If your device is prone to sudden power loss, you can turn off autosave in the settings menu.

In some cases it may be recoverable by looking for .bak or .tmp files in the save file directory:

Windows: C:\Users\<username>\AppData\Roaming\CassetteBeasts\

Linux: ~/.local/share/CassetteBeasts/

If you find a .tmp file there, rename the corresponding .json.gz.gcpf file to something else and trim the .tmp extension off the file name.

Low framerate

Cassette Beasts uses Godot as its engine. This has a lot of benefits to a project like this, but one of the downsides is performance on devices with integrated graphics (such as a laptop).

Here are some tips if you're running the demo on a device with integrated graphics:

1. In the settings menu, switch to the 'Low' Graphics Preset.
2. If the game is fullscreen, you can lower the resolution to something smaller than your screen's full size. The game will render at the lower resolution and scale it up to fill your screen. If your screen resolution is 4k, the speedup from rendering at 1080p can be massive!
3. The 'Overworld Shadows' setting is not currently changed by the 'Low' Graphics Preset, but turning shadows off can improve performance further on low-end devices.

On Steam Deck, the game generally runs smoothly with the High graphics quality profile, however some users have reported that dashing quickly around the world leads to stutters / lag. Performance in this situation can generally be improved by changing the World Streaming setting to Lower CPU Usage.

The settings menu can be opened from the main menu. If you've just started a new file, the pause menu is briefly disabled until you've completed the first battle. After that you can press Esc, Tab or Enter to pause and select Settings.

If the tips above don't help you achieve at least 30 FPS, and your computer meets the minimum required specs on the store page, see Other Issues.

Physics

Physics can behave weirdly sometimes, especially when framerate is low. Examples of the weirdness include objects (or the player) being launched into orbit, boxes allowing you to cling onto the edges of cliffs, etc.

To minimise the jank, run the game at the highest framerate the game and your hardware allow.

Other Issues

1. First check that your game is up to date.
2. If you have mods installed, first uninstall them and see if the issue continues.
3. If you own the game on Steam, you can install the Steam Daily branch which frequently updates with fixes we're testing. Note that this branch is not fully tested and will break things from time to time. You should read the guidance on backing up save files carefully.
4. If it isn't caused by a mod, and it isn't fixed on the Steam Daily branch (or you don't own the game on Steam), please report it here: https://rawfury.atlassian.net/servicedesk/customer/portal/1
5. If you need to report a security issue, please do not post about it publicly or on discord, and report it only via the portal provided (or via email).

Include in your report:

1. How you obtained the game (MS Store, Game Pass, Steam, Xbox, Switch eShop, etc.)
2. Which version number is shown on the bottom left of the title screen (e.g. 1.1.0)
3. Your system specs. In the Steam client (if you have it installed, this works regardless of which store you bought the game on), you can generate a system spec report by going to Help > System Information.
4. Log files:
   • Windows: C:\Users\<username>\AppData\Roaming\CassetteBeasts\logs\
   • Linux: ~/.local/share/CassetteBeasts/logs/
5. Save files:
   • Windows (Steam): C:\Users\<username>\AppData\Roaming\CassetteBeasts\
   • Windows (MS Store, Game Pass): C:\Users\<username>\AppData\Local\Packages\RawFury.CassetteBeasts_9s0pnehqffj7t\SystemAppData\wgs\
   • Linux: ~/.local/share/CassetteBeasts/