Beat Banger Wiki

Appearance

Table of Contents ​

  1. Mod Versions
  2. Modern Installing
  3. Traditional Installing
  4. Mac Installing
  5. Installation Issues

Mod Versions ​

Mods are tagged by version on the Beat Banger website and Discord. Always choose mods that match your game version.

If you need to find mods, check out the 💾download mods .

  • Important: The 💓 Release version is the recommended and supported version of Beat Banger. Most mods are made for this version, available on Steam and Itch.io.

Using the Release version ensures the best compatibility and access to new features.

  • 💓 Release: For the paid version of Beat Banger on Steam and Itch.io.
  • Warning: Mods will not work if you select the wrong version for your game.

Modern Installing ​

Modern installs are for the 💓 Release version.

Methods:

  • Use the built-in mod browser in the Release version to download mods directly.
  • Find mods by consulting the 💾download mods page. Copy the .zip download link and paste it in the Beat Banger mods screen.
  • Find mods by consulting the 💾download mods page. Drag the zip file into the Beat Banger mods screen.

Note: If the built-in mod browser or drag-and-drop methods do not work, you can always install mods manually. Download the mod archive, extract it, and place the extracted mod folder directly into the mods directory for your platform:

  • Windows: %appdata%\Godot\app_userdata\Beat Banger\mods
  • Mac: ~/Library/Application Support/Godot/app_userdata/Beat Banger/mods
  • Linux/Steam Deck: ~/.local/share/godot/app_userdata/Beat Banger/mods

This ensures compatibility if automatic methods fail.

Traditional Installing ​

Steps:

  1. Extract the mod files using an archival utility such as 7zip or the built-in OS extractor.
  2. Drag and drop the extracted mod folder into %appdata%\Godot\app_userdata\Beat Banger\mods.

Your mods file path should look like:
.../mods/YourModFolder/act.cfg
(not .../mods/YourModFolder/AnotherFolder/act.cfg)

Tip: You can use the "Open Mods Folder" button in-game to quickly access the mods folder, or paste the above path into Windows File Explorer.

Linux/Steam Deck mod path: ~/.local/share/godot/app_userdata/Beat Banger/mods The "Open Mods Folder" button in-game also works on Linux and Steam Deck.
Note: On Steam Deck, you must be in Desktop Mode to access the mods folder and install mods.

Mac Installing ​

  1. Go to your steamapps folder.
  2. Right-click Beat Banger and select "Show Package Contents".
  3. Inside the MACOS folder, find the /data folder.
  4. Create a new folder named mods in the same directory as the data folder (so you have both data and mods inside the MACOS folder), and copy your mod files into the mods folder.

Mac mod path: ~/Library/Application Support/Godot/app_userdata/Beat Banger/mods
You can also use the "Open Mods Folder" button in-game to access this location.

Installation Issues ​

Version Mismatch ​

Check mod version tags. Release mods usually contain a Video folder.

Wrong Mods Folder ​

Use %appdata%\Godot\app_userdata\Beat Banger\mods (Windows), not the Steam folder.
The "Open Mods Folder" button in-game will take you to the correct location.

"act.cfg not in root folder" Error ​

If you see an error saying "act.cfg not in root folder," it means the mod files are inside an extra folder or not structured correctly.

How to fix:

Method 1: Manual Install

  • Open the mod archive and look for the folder that directly contains act.cfg and the other mod files.
  • Make sure there is only one folder holding all the mod files (including act.cfg), and that this folder is what you drag into your mods directory.
  • The structure should be:
    .../mods/YourModFolder/act.cfg
    (not .../mods/YourModFolder/AnotherFolder/act.cfg)

Method 2: Re-zip the Mod

  • Unzip (extract) the mod archive to a temporary location on your computer.
  • Open the extracted folder and ensure all the mod files, including act.cfg, are inside a single folder (not nested within another folder).
  • If the files are nested, move all files and folders up so they are directly inside one folder.
  • Select this single folder (the one containing act.cfg), right-click it, and choose "Send to > Compressed (zipped) folder" (Windows) or "Compress" (Mac/Linux) to create a new zip archive.
  • When you open the new zip, you should immediately see the folder containing act.cfg at the root of the archive (not another folder inside).