Skip to content

affederaffe/BeatSaberModManager

Repository files navigation

BeatSaberModManager

About

BeatSaberModManager is yet another mod installer for Beat Saber, heavily inspired by ModAssistant.
It strives to look more visually appealing and support both Windows and Linux, while still being as feature-rich as ModAssistant.

Features

  • Windows and Linux support
  • Dependency resolution
  • Installed mod detection
  • Mod uninstallation
  • OneClick™ support for BeatSaver, ModelSaber and Playlists

Installation

  • Download the latest version for you platform from Releases
  • Run the executable

Usage

  1. Run the game at least once before trying to mod the game!
  2. Now check / uncheck the mods you wish to install or uninstall and press Update Mods. Unlike ModAssistant, there is no extra Uninstall button, installed mods that are unchecked will automatically be uninstalled.
  3. Mods are installed to IPA/Pending until the game is run. Boot the game to complete mod installation.

Common issues

I hit install, but I don't see anything in game!
Double check that you followed the Usage instructions correctly. Make sure you're looking in the right place. Sometimes mod menus move as modding libraries/practices change.

I don't see a certain mod in the mods list!
Mod Assistant uses mods from BeatMods and shows whatever is available for download. If you need to install a mod manually, please refer to the Beat Saber Modding Group Wiki.

I hit install but now my game won't launch, I can't click any buttons, I only see a black screen, etc
Please visit the Beat Saber Modding Group #pc-help channels. Check the pinned messages or ask for help and see if you can work things out.

Credits

ModAssistant by Assistant: https://github.com/Assistant/ModAssistant
BSIPA-Linux by geefr: https://github.com/geefr/BSIPA-Linux