Skip to content

Commit fca6a39

Browse files
committed
docs: add uninstall instructions for BepisLoader
1 parent 89ee80e commit fca6a39

1 file changed

Lines changed: 30 additions & 1 deletion

File tree

src/content/docs/getting-started/installation.mdx

Lines changed: 30 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ sidebar:
55
order: 1
66
---
77

8-
import { LinkButton, Tabs, TabItem } from '@astrojs/starlight/components';
8+
import { LinkButton, Tabs, TabItem, FileTree } from '@astrojs/starlight/components';
99
import Card from '@components/Card.astro';
1010
import CardGrid from '@components/CardGrid.astro';
1111

@@ -94,6 +94,35 @@ BepisLoader is not enabled by default after installation. Mods only load when th
9494
- If you prefer not to edit the ini file, add the command-line argument `--hookfxr-enable` to launch options instead.
9595
- To temporarily disable mods (even if enabled), add the `--hookfxr-disable` flag or set `enable=false` in the ini.
9696

97+
### Uninstalling BepisLoader
98+
99+
To fully uninstall BepisLoader and remove all mods, delete the following files and folders from your Resonite installation directory:
100+
101+
<FileTree>
102+
- BepisLoader.deps.json
103+
- BepisLoader.dll
104+
- BepisLoader.runtimeconfig.json
105+
- hookfxr.ini
106+
- hostfxr.dll
107+
- LinuxBootstrap.sh
108+
- BepInEx/
109+
</FileTree>
110+
111+
Note that the `LinuxBootstrap.sh` file is modified by BepisLoader and must be restored to the original game version by verifying the integrity of game files on Steam.
112+
113+
Also, remove any `--hookfxr-enable` or `--hookfxr-disable` launch flags from your game start parameters.
114+
115+
#### Verify Integrity of Game Files (Steam)
116+
117+
After uninstalling BepisLoader, verifying the integrity of game files is **required** to restore modified files (especially `LinuxBootstrap.sh`) to their original state:
118+
119+
1. Open your Steam Library.
120+
2. Right-click on Resonite and select **Properties**.
121+
3. Navigate to the **Local Files** tab.
122+
4. Click **Verify integrity of game files...**.
123+
124+
Steam will scan your installation and replace any modified or missing files, ensuring a clean, unmodded game state.
125+
97126
## Alternative Mod Loaders
98127

99128
While BepisLoader is the recommended option (and the only one supported on Thunderstore), there are other mod loaders available for Resonite:

0 commit comments

Comments
 (0)