Troubleshooting

From Cassette Beasts

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 issues in various different versions of AMD graphics drivers.

  1. Some versions from 2024 cause the game to be unable to launch or to crash on launch. This was fixed by AMD in a patch.
  2. Versions 25.10.2 from October 2025 onwards cause sprites to appear black, go invisible, or rotate in unintended ways.

On the 21st of January 2026, AMD released version 26.1.1, which contains a fix ("Fixed issues: Player sprites may not render correctly while playing Cassette Beasts on Radeon™ RX 7000 series and Radeon™ RX 9000 series graphics products.")

We are currently asking affected players to install AMD drivers version 26.1.1, and reboot afterwards. If the game still has issues after that:

  1. Clear the shader cache in %localappdata%\AMD\ (it'll be named something like GLCache), and try again
  2. Contact Bytten Studio via Discord or email - the sooner we know, the sooner we can report this back to AMD.
  3. Downgrade to version 25.9.2, which is known to work correctly with Cassette Beasts.

Intel Integrated Driver Issues

Intel integrated GPU drivers are known to cause a crash. The crash occurs when you enter a house in the place that the triangle man sends you to.

Unfortunately, Intel refuses to issue a fix (or even investigate), because they consider the hardware it affects "legacy hardware" and no longer support it. If you're able to confirm this crash affects you on supported hardware, I would encourage you to post on the github issue to let them know: https://github.com/IGCIT/Intel-GPU-Community-Issue-Tracker-IGCIT/issues/1323

For now, affected players can install Lerycide's mod to replace the shader that triggers the crash with a blank texture:

Game Freezes When Launched (Epic Games Version)

A handful of players have reported that the game freezes when launched from the Epic Games Launcher. We don't fully understand the cause of this issue yet, but whitelisting EpicGamesLauncher and EpicWebHelper in Windows Defender for both public and private networks resolves it.

Game Unable to Save (Epic Games Version on Heroic Games Launcher)

Using the Heroic Games Launcher to play the Epic Game Store version on Linux / Steam Deck is not officially supported. Until Epic adds Linux support, the only officially supported way to play the game on Linux is to use the Steam version.

Some users have reported that creating a folder named "CassetteBeasts" (case sensitive, no spaces) in the directory "~/.var/app/com.heroicgameslauncher.hgl/data/" allows the game to save.

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

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/
Retrieved from "http://wiki.cassettebeasts.com/index.php?title=Troubleshooting&oldid=12175"