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.
12 Commits
9 Branches
334 MiB
 
 
 
 
Tree: 1527065b4c
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '1527065b4c'
${ noResults }
BeatSaber-IPA-Reloaded/README.md

1.5 KiB
Raw Blame History

IPA

Illusion Plugin Architecture (Reloaded) - let's you inject code into Unity projects.

How To Install

  1. Download a release (https://github.com/russianGecko/IPA-Reloaded/releases)
  1. Extract the contents into the game folder
  2. Drag & drop the game exe onto IPA.exe
  3. Start the game as usual (the generated shortcut is optional)

Optional: To verify it worked, start the game with the --verbose flag. If a new console window opens with debug info, then you're good.

How To Uninstall

  1. Drag & drop the game exe onto IPA.exe while holding Alt
  2. Done

How To Develop

  1. Create a new Class Library C# project (.NET 2.0 to 3.5 (for LINQ))
  2. Download a release and add IllusionPlugin.dll to your references
  3. Implement IPlugin or IEnhancedPlugin
  4. Build the project and copy the DLL into the Plugins folder of the game

Note: You can use Console.Write() with the --verbose flag for debugging your plugins.

How To Keep The Game Patched

When patching, IPA automatically creates a shortcut that keeps everything up-to-date. This simply makes sure that your DLLs remain patched even after an update.

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

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