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.

89 lines
4.3 KiB

  1. ---
  2. uid: articles.start.user
  3. ---
  4. # Installing BSIPA
  5. > [!NOTE]
  6. > This guide assumes that you are starting completely fresh.
  7. 1. Grab a release from the GitHub [Releases page](https://github.com/beat-saber-modding-group/BeatSaber-IPA-Reloaded/releases).
  8. Make sure to download one of the `BSIPA-*.zip`s, as `ModList.zip` contains the Beat Saber mod for showing your mods in-game, not the loader itself.
  9. > [!NOTE]
  10. > The specific ZIP you need to download varies on the game you will be patching. For example, if you are patching Beat Saber, you will need the file
  11. > `BSIPA-x64-Net4.zip`. This is because Beat Saber is a 64 bit game running .NET 4. If you are patching Muse Dash, however, you nee the file
  12. > `BSIPA-x86-Net3.zip`.
  13. >
  14. > [!TIP]
  15. > There are a few tricks for figuring out which file you need. If the game has a folder called `MonoBleedingEdge` in the install directory, then you
  16. > need one of the `Net4` builds. To determine *which* build to use, right click on the game executable, go to the `Compatability` tab, check the
  17. > `Run this program in compatability mode for` checkbox, and look and see if the dropdown has any Windows XP emulation options. If it does, the
  18. > application is 32 bit, and you need to get one of the x86 builds. Otherwise, get one of the x64 builds.
  19. >
  20. > Make sure to uncheck that checkbox before leaving the menu.
  21. 2. Extract the zip into your game installation directory. There should now be a folder named `IPA` and a file named `IPA.exe` in
  22. the same folder as the game executable.
  23. For example, if you are installing BSIPA in Beat Saber, it might look like this after extraction:
  24. ![What your game directory may look like after extracting BSIPA](../images/install-extracted.png)
  25. 3. Run `IPA.exe` by double clicking it. A console window should pop up, and eventually, a gold message asking you to press a key
  26. will appear. Here is an example of a successful installation:
  27. ![A successful installation](../images/install-successful.png)
  28. > [!NOTE]
  29. > In some cases, this may fail, something like this: ![A failing installation](../images/install-failed.png)
  30. >
  31. > In these cases, try dragging the game executable over `IPA.exe`.
  32. After installing, your game directory should look something like this:
  33. ![A properly installed BSIPA](../images/install-correct.png)
  34. > [!NOTE]
  35. > At this point it is recommended to run the game once before continuing, to ensure that things are installed correctly.
  36. >
  37. > The first run should create a `UserData` folder with `Beat Saber IPA.json` and `Disabled Mods.json`, as well as a
  38. > `Logs` folder with several subfolders with their own files. If these are created, then the installation was very
  39. > likely successful.
  40. >
  41. > [!TIP]
  42. > If you are not installing BSIPA on Beat Saber, you probably want to go to the config at `UserData/Beat Saber IPA.json`
  43. > and set both of the following to `false`:
  44. >
  45. > ```json
  46. > {
  47. > ...
  48. > "Updates": {
  49. > "AutoUpdate": false,
  50. > "AutoCheckUpdates": false
  51. > },
  52. > ...
  53. > }
  54. > ```
  55. 4. From here, just place all of your plugins in the `Plugins` folder, and you're all set!
  56. Many plugins will come in a zip such that the root of the zip represents the game install directory, so all you may have to
  57. do is extract the plugin into the game installation folder.
  58. > [!NOTE]
  59. >
  60. > For some reason, by default, Wine does not load DLLs in quite the same way that Windows does, causing issues with the injection.
  61. > To make the injection work with Wine, `winhttp` has to have a DLL override set to `native,builtin`. This can be set either through
  62. > Protontricks, or with the following `.reg` file.
  63. >
  64. > ```reg
  65. > REGEDIT4
  66. > [HKEY_CURRENT_USER\Software\Wine\DllOverrides]
  67. > "winhttp"="native,builtin"
  68. > ```
  69. >
  70. > For Steam there's a per-game Wine prefix under `compatdata`. In this case `SteamLibrary/steamapps/compatdata/620980/pfx/user.reg`.
  71. > Changes to this file will likely be ovewritten when the game updates or if local files are validated through Steam.
  72. Thats really all you have to do! The installation should persist across game updates for as long as `winhttp.dll` is present in
  73. the game directory, though your plugins will be moved to a different folder when it does update so things don't break horribly.