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.

43 lines
1.6 KiB

6 years ago
6 years ago
6 years ago
  1. [![Build status](https://ci.appveyor.com/api/projects/status/fql702mky0d5bcky?svg=true)](https://ci.appveyor.com/project/nike4613/beatsaber-ipa-reloaded)
  2. # IPA
  3. Illusion Plugin Architecture (Reloaded) - let's you inject code into Unity projects.
  4. ## How To Install
  5. 1. Download a release (https://github.com/nike4613/IPA-Reloaded/releases)
  6. 2. Extract the contents into the game folder
  7. 3. Drag & drop the game exe onto **IPA.exe**
  8. 4. Start the game as usual (the generated shortcut is optional)
  9. **Optional:**
  10. To verify it worked, start the game with the `--verbose` flag. If a new console window opens with debug info, then you're good.
  11. ## How To Uninstall
  12. 1. Drag & drop the game exe onto **IPA.exe** while holding <kbd>Alt</kbd>
  13. 2. Done
  14. ## How To Develop
  15. 1. Create a new **Class Library** C# project (.NET 4.6)
  16. 2. Download a release and add **IPA.Loader.dll** to your references
  17. 3. Implement `IBeatSaberPlugin` or `IEnhancedBeatSaberPlugin`
  18. 4. Build the project and copy the DLL into the Plugins folder of the game.
  19. See [Developing](https://github.com/nike4613/IPA-Reloaded/wiki/Developing) for more information.
  20. ## How To Keep The Game Patched
  21. 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.
  22. ## Arguments
  23. `IPA.exe file-to-patch [arguments]`
  24. - `--launch`: Launch the game after patching
  25. - `--revert`: Revert changes made by IPA (= unpatch the game)
  26. - `--nowait`: Never keep the console open
  27. - See `-h` or `--help` for more options.
  28. Unconsumed arguments will be passed on to the game in case of `--launch`.