DaNike
/
BeatSaber-IPA-Reloaded
mirror of https://github.com/bsmg/BeatSaber-IPA-Reloaded.git
1
1
Fork 0
Code Issues 0 Projects 0 Releases 78 Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
240 Commits
9 Branches
219 MiB
 
 
 
 
Tree: 54a3fb616b
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '54a3fb616b'
${ noResults }
 ZIP  TAR.GZ
DaNike 54a3fb616b More performance improvements for the logger 5 years ago
CollectDependencies Fixed unix newlines with the dependency collector 6 years ago
Doorstop@7aa5cc6ca4 Added a few comments to explain myself 6 years ago
IPA Performed some cleanup 6 years ago
IPA.Injector Added a few comments to explain myself 6 years ago
IPA.Loader More performance improvements for the logger 5 years ago
IPA.Tests Finished migration to new locations 6 years ago
Libs Started rewrite of loader 6 years ago
MSBuildTasks Updated package Newtonsoft.JSON 6 years ago
Refs Updated solution ReSharper settings 5 years ago
.gitignore Added a rate limiter of sorts to StandardLogger 5 years ago
.gitmodules Fixed submodule to reference the correct repo 6 years ago
BSIPA.sln Updated to use ReSharper 6 years ago
BSIPA.sln.DotSettings Updated solution ReSharper settings 5 years ago
LICENSE Add files via upload 6 years ago
README.md Updated README.md to include build instructions 5 years ago
appveyor.yml Updated version to reflect subproject 6 years ago

README.md

BSIPA Build status

Beat Saber IPA - The mod injector tailored for Beat Saber

How To Install

  1. Download a release (https://github.com/nike4613/BeatSaber-IPA-Reloaded/releases)
  2. Extract the contents into the game folder
  3. Run IPA.exe
  4. Start the game as usual

A console window should open before the game starts if the installation was successful.

To disable this console window, pass --no-console to the game.

How To Uninstall

  1. Drag & drop the game exe onto IPA.exe while holding Alt
    • Or run ipa -rn in a command window

Arguments

IPA.exe file-to-patch [arguments]

  • --launch: Launch the game after patching
  • --revert: Revert changes made by IPA (= unpatch the game)
  • --nowait: Never keep the console open
  • See -h or --help for more options.

Unconsumed arguments will be passed on to the game in case of --launch.

How To Develop

  1. Create a new Class Library C# project (.NET 4.6)
  2. Download a release and add IPA.Loader.dll to your references
  3. Implement IBeatSaberPlugin or IEnhancedBeatSaberPlugin
  4. Build the project and copy the DLL into the Plugins folder of the game.

See Developing for more information.

How To Keep The Game Patched

BSIPA will automatically repatch the game when it updates, as long as winhttp.dll is present in the install directory.

Building

Prerequisites

  • Microsoft Visual Studio 2017 or later
  • Tools for C/C++ (MSVC)
  • .NET 4.6 SDK and .NET 4.7.1 SDK

Building

  1. Clone with git clone https://github.com/nike4613/BeatSaber-IPA-Reloaded.git --recursive
  2. Create a file, bsinstalldir.txt in the solution root. Do NOT create this in Visual Studio; VS adds a BOM at the begginning of the file that the tools used cannot read. It should contain the path to your Beat Saber installation, using forward slashes with a trailing slash. e.g.
C:/Program Files (x86)/Steam/steamapps/common/Beat Saber/
  1. Open BSIPA.sln in Visual Studio.
  2. Choose the configuration x64
  3. Rebuild all. Any time you make a change, ALWAYS Rebuild All.

When building a Debug build, all referenced assemblies from Beat Saber will be copied from the install directory provided in bsinstalldir.txt into Refs/. Any new references should reference the copy in there. When building for Release, it just uses the files already in Refs/