How to Install Mods for Tainted Grail: The Fall of Avalon

Modding Tainted Grail: The Fall of Avalon is more confusing than it should be, for one reason: there are two incompatible mod loaders (BepInEx Mono and BepInEx IL2CPP), and installing mods built for the wrong one is the #1 cause of crashes. This guide covers which branch to pick, both Vortex and manual installation, and how to fix the most common errors.

TL;DR

1. Use BepInEx v5 (Mono) unless a mod specifically requires IL2CPP.
2. Extract BepInEx into your game root folder, launch the game once, then drop mod .dll files into BepInEx\plugins\.
3. If the game crashes on launch, you almost certainly mixed Mono and IL2CPP — delete the BepInEx folder and start clean.

Mono vs IL2CPP: Which BepInEx Do You Need?

Tainted Grail shipped with an IL2CPP build, and early mods target BepInEx v6 (IL2CPP). The developers later added a Mono build of the game, and the modding community largely migrated to BepInEx v5 (Mono) because it’s more stable and crashes less.

Rule of thumb: check the mod’s requirements section. If it says Mono, you need the Mono branch — the two cannot coexist in one install. You can grab the IL2CPP branch of BepInEx here if a mod specifically calls for it.

Switching the game to the Mono build

1. In Steam, right-click the game → Properties → Betas.
2. Select the Mono branch from the dropdown. If Steam asks for a code, type IAcceptLowerFPS (the developers gated it because the Mono build performs slightly worse).
3. Let Steam update the game.

Method 1: Installing Mods with Vortex

1. Install the Vortex mod manager, then add the Tainted Grail Vortex extension.
2. Enable the extension, restart Vortex, and activate the game under the Games tab.
3. Vortex installs the correct BepInEx version automatically.
4. Download mods through Vortex, enable them, and click Deploy.

Vortex handles the Mono/IL2CPP choice for you, which makes it the safest option for beginners.

Method 2: Manual Installation

1. Find your game folder: Steam Library → right-click the game → Manage → Browse Local Files. You should see Fall of Avalon.exe.
2. Download BepInEx v5 (Mono) and extract the contents of the zip directly into the game root. After extracting you should have a BepInEx\ folder next to the exe — if you have BepInEx\BepInEx\, you extracted one level too deep.
3. Launch the game once without any mods. This generates the folder structure, including BepInEx\plugins\ and BepInEx\config\.
4. Download a mod — for example Higher Weight Limit or the Cheat Console Enabler — and put its .dll into BepInEx\plugins\. If the zip contains a folder named after the mod (with assets inside), copy the whole folder, not just the DLL.
5. Launch the game. Mod config files appear in BepInEx\config\ after the first run with the mod active.

Fixing Common Problems

Game crashes on launch after installing BepInEx. You’re mixing branches — usually leftover IL2CPP files under a Mono install (or vice versa). Fix: back up BepInEx\plugins and BepInEx\config, delete the entire BepInEx folder, reinstall the correct branch cleanly, then restore your backups.

Mods don’t load at all (no config files generated). BepInEx isn’t hooking the game. Check that winhttp.dll sits next to Fall of Avalon.exe, and verify you’re on the game build matching your BepInEx branch.

A specific mod misbehaves. Open BepInEx\LogOutput.log — every mod logs its startup there. Search for the mod’s name; a missing-dependency or version-mismatch error is usually spelled out. Include this log when asking for help.

Game updated and mods broke. Game patches frequently break IL2CPP mods and occasionally Mono ones. Wait for mod updates, or roll back via Steam’s beta branches if the modder recommends it.

FAQ

Do mods disable achievements? No — Tainted Grail doesn’t block achievements when BepInEx is installed.

Can I use Mono and IL2CPP mods together? No. One game install runs exactly one BepInEx branch. Pick the branch that covers the mods you care about most.

Is modding safe for my save files? Gameplay-tweak mods (carry weight, cheat console, etc.) are generally save-safe, but back up %USERPROFILE%\AppData\LocalLow\Awaken Realms\ before installing anything that changes items or quests.

Where can I find mods for this game? Browse the full Tainted Grail: The Fall of Avalon mod list — new mods are added regularly.