Wrye Bash: An Oblivion Modding Guide

Introduction

Greetings, citizen. You've entered the insanely stupid and convoluted world of Tamriel. For some godforsaken reason you're in prison, someone is being racist to you while you're there and someone's rung the devil's doorbell because he and the legions of hell are just about to answer, but don't panic: it's your turn on the communal braincell. Welcome to the world of Elder Scrolls: Oblivion, and the endless insanity that is its modding scene. Meet Wyre Bash, the hallmark of not just Oblivion modding, but the torchbearer for countless modding communities since Sean Bean's beautiful voice hit the 1080 screen. As you can infer, I'm very sentimental for this thing, being the very first piece of software I ever learned. What makes Wyre special is not just its ability to get mods in, but to arrange them in a way that won't make you want to make a master level destruction spell to use solely on yourself. It manages your load order, installs mods through its own archive format, and builds a Bashed Patch that quietly resolves conflicts between mods that would otherwise fight each other. If you have ever installed a handful of Oblivion mods and watched your game crash on the title screen, this guide is for you.

Why Bother?

Oblivion was never built to expect the volume of mods its community would eventually throw at it. Oblivion can barely handle you loading the interior map without crashing. Oblivion can't handle it when you spawn 10,000 watermelons at once. In fact, Oblivion can't handle anything, it's notoriously broken. Bugs aside, this gives the poor thing a fighting chance against the vile machinations of internet perverts and lore-perfectionists. See, mods don't always get along. They weren't always made with eachother in mind, and that leads to Mod Conflicts. Two mods that each seem fine on their own can still overwrite each other's changes, duplicate the same leveled list entries, or load in the wrong order and silently break scripts. Wrye Bash exists because manually untangling that mess by hand is not a reasonable way to spend an evening and god damn it, this is Elder Scrolls Oblivion not baby's first attempt at installing Gentoo. In an ironwood nutshell, Bash automates the tedious parts and gives you a single place to see what your load order is actually doing.

For this guide, I will be demonstrating Oblivion's most famous mod by far. This is Oscuro's Oblivion Overhaul or OOO. Overhaul mods, as their name suggests, completely redo the game. They add new plotlines, locations, enemies, enemy spawn rates, NPCS, items, weapons and while they're at it, ways to experience pain. Of course, not everything kills you, but when something wants to get you it will obliterate you and the world of Cyrodill finally earns its keep in the stories of its denizens. As if being british wasn't suffering enough, we were playing this shit as young as six years old. But like the freak I am, I came to enjoy its insane difficulty. When I beat up Lord Volymr, I felt like a fucking beast, I felt like saying bad morning to the teacher. After getting my own copy at 10 and spending countless years on vanilla playthroughs, I never forgot the joy and terror it brought me.

Next Page

What Is Wrye Bash

Wrye Bash is a mod management utility originally built for Oblivion and later extended to other Bethesda titles. It is not a mod itself, it is a tool that sits alongside your game and your mod files, and gives you control over three things: which plugins are active and in what order, which loose files and archives get installed into your Data folder, and how conflicting records between plugins get merged.

It is different from a simple mod organiser in one important way: it can actually read the contents of your plugin files and understand what they change, which is what lets it build a Bashed Patch later on.

Back to Index

Installation

  1. Download the latest release from the Wrye Bash Nexus page. Get the standalone installer unless you already know you want the Python source version.

  2. Run the installer and point it at your Oblivion installation folder. It will usually find this automatically if Oblivion is installed through Steam or GOG.

  3. Make sure you also have the Oblivion Script Extender (OBSE) installed. Wrye Bash does not require it to run, but most of the mods you will be managing with it do.

  4. Launch Wrye Bash once before installing anything else. On first run it will scan your existing plugins and build its internal database. This can take a minute or two depending on how much you already have installed.

Next Page

BAIN Installers

BAIN (Bash Installer Archive Network) is Wrye Bash's own installer system. Instead of manually unzipping mods into your Data folder and hoping nothing overwrites something you needed, you drop the mod archive as-is into your Bash Installers folder and let Wrye Bash handle placement, uninstalling, and conflict detection.

Setting It Up

  1. Open Wrye Bash and switch to the Installers tab.

  2. Drop your downloaded mod archives (.7z, .zip, .rar) directly into the Bash Installers folder it points you to. Do not extract them first, BAIN reads the archive directly.

  3. Right-click an archive in the Installers tab and choose Install, or double-click it. BAIN will show you a preview of what files it is about to place before committing to anything.

Last Page

Why Use BAIN Over Manual Installs

Because every install goes through BAIN, uninstalling a mod is a single click and it cleanly removes exactly what it added, nothing more. If two mods try to install the same file, BAIN tells you about the conflict and lets you choose the install order, rather than silently letting whichever mod you unzipped last win.

Install Order

BAIN installers have their own internal order, separate from your plugin load order. Drag installers up and down the Installers tab list to control which one wins when two mods provide the same file. Lower in the list means it installs later and overwrites earlier entries.

Next Page

The Bashed Patch

This is the feature that makes Wrye Bash indispensable rather than just convenient. Many Oblivion mods edit the same underlying records, leveled lists being the classic example. If two mods both add new creatures to the same leveled list, only one of those edits will normally survive, whichever mod loads last simply overwrites the other's changes. The Bashed Patch fixes this by merging those changes together instead of letting one silently clobber the other.

Creating One

  1. In the Mods tab, right-click in the plugin list and choose New Bashed Patch.

  2. Give it a name (the default is fine) and let Wrye Bash add it to your load order. It should load near the very end, after your other content plugins.

  3. Double-click the new Bashed Patch entry to open its build options.

Last Page

Building It

  1. In the Bashed Patch dialog, tick the merge options relevant to your mod list. Leveled Lists is the one nearly everyone wants enabled.

  2. Click Build Patch. Wrye Bash will scan your active plugins, merge the applicable records, and write the result into the Bashed Patch plugin.

  3. Rebuild the patch any time you add, remove, or reorder plugins. It is not a one-time step, treat it as part of your normal install routine.

A Note on Merging Plugins

Separately from the Bashed Patch, Wrye Bash can also fully merge small, simple plugins directly into the patch itself, freeing up a plugin slot. This is different from leveled list merging and works best on small mods with no scripts. Tick a plugin's Merge checkbox in the Mods tab if it is eligible.

Next Page

Load Order Basics

Wrye Bash's Mods tab shows your full plugin list with load order, and colour-codes rows to flag problems: missing masters, dirty edits, and mods that would benefit from being merged or patched. As a general rule, master files and overhaul mods go near the top, and anything meant to override or patch other content goes near the bottom, with your Bashed Patch last of all.

Troubleshooting

Wrye Bash won't detect my game : point it manually at your Oblivion install folder from the Preferences menu.

A plugin shows a red masters warning : it depends on a plugin you don't have active or installed. Enable the missing master or remove the dependent plugin.

My game crashes after building a Bashed Patch : rebuild the patch after any load order change, and check the BashBugDump log if the crash persists, it often names the offending plugin directly.

Last Page

Conclusion

Wrye Bash rewards a bit of up-front setup with a mod list that actually holds together. BAIN keeps your installs clean and reversible, and the Bashed Patch quietly resolves the kind of conflicts that would otherwise mean picking between two mods you wanted to run together. For a heavily modded Oblivion setup, it is less an optional extra and more the tool everything else depends on.

Further Reading

TitleDescription
Wrye Bash (Nexus)The official Wrye Bash download page for Oblivion.
Wrye Bash DocumentationThe maintained documentation site covering every tab and feature in depth.
Oblivion Script ExtenderRequired by most script-heavy Oblivion mods, install alongside Wrye Bash.
r/oblivionmodsA community forum for troubleshooting load orders and mod conflicts.