TES4Edit Cleaning Guide

From the Oblivion ConstructionSet Wiki
Revision as of 22:27, 1 July 2011 by imported>Brumbek (→‎Artefacts of the Ancestors.esp: heading change)
Jump to navigation Jump to search

Introduction

This tutorial is designed to teach modders and mod users how to use TES4Edit to clean mods. Cleaning mods is critical to maintaining compatibility in the modding community and for creating a stable modded game environment. However, TES4Edit is not a simple utility and care must be taken not to damage mods in the process. This tutorial will explain what you need to know in order to clean mods correctly.

This guide is split into two sections. The first section is meant to convey general knowledge and understanding about the entire cleaning process. The second section contains the *actual* instructions on how to clean your mods. You could skip to the second section but it is highly advisable that you read this entire document from start to finish in order to greatly improve your success rate in the cleaning endeavor.

There is also a Glossary at the end of this guide. Several terms used in this guide are community-wide terms, but a number of the other terms have been invented to help explain things. You may wish to skip to the glossary now to get a rough idea of key terms you will encounter.

Lastly, this guide and the cleaning process in general may be intimidating, but cleaning is actually not that hard once you have some understanding. Devote an hour to reading this guide and you'll be well on your way to have a squeaky-clean mod list and a fun, more-stable game environment.

Please Note: Miaximus has written a fantastic guide to using FO3Edit, which is actually an identical program to TES4Edit so most of the stuff in the guide can be applied to Oblivion. If you wish to learn more about actually editing mods using TES4Edit, then I highly recommend reading his guide! The link is:

http://fallout3nexus.com/downloads/file.php?id=8629

Section #1: General Knowledge and Theory Behind Cleaning

Section #1 has three parts:

  1. Why Clean?: This part explains why many mods need to be cleaned
  2. What is Cleaning?: This part explains what it means to ‘clean’ a mod
  3. How to Clean: This part explains the theory about how to clean your mods properly and safely

Please read Section #1 entirely at least once before attempting to clean your mods. Throughout this section, Key Concepts will be given. These are big picture ideas that you need to learn and apply in order to successfully clean your mods. Again, you must understand these concepts or you are likely to get into trouble.

Part #1: Why Clean?

Short answer: Because some mods have dirty edits and/or wild edits (these terms will be explained momentarily) which cause bad things to happen, ranging from incorrect game settings, disabling content, broken quests, and crashing to desktop (CTD). If you run a lot of mods (a subjective amount but perhaps 100 or more) the chance of bad edits causing problems rises exponentially.

Longer answer: When a mod is created, there are two types of bad edits that can occur: dirty/unnecessary edits and wild/undesirable edits. Each type will now be explained.

Type #1: Dirty/Unnecessary Edits

Dirty edits happen two ways. First, a mod edits something that is later changed back to vanilla but the edit is not deleted. The initial edit could have been an accident or a design decision that was later rejected. Second, dirty edits can be due to Construction Set (CS) bugs. Both of these edit types are unnecessary edits and get stored in the mod and do not in any way add to the purpose of the mod and have become known as dirty edits.

For the record, it should also be stated that just because a mod has some dirty edits, this is not always the mod creator’s fault. The CS is known to produce certain dirty edits. The larger the mod is and the more cells it edits, the more CS bugs can occur. Then again, certain dirty edits are due to modder lack of skill, but as just stated, other dirty edits due to CS bugs can happen to the best modders. Vorians says:

The majority of dirty edits removed by TES4Edit automatically exist in the .ESP due to the bugs in the CS. The more cells an .ESP edits, the more dirty records there are likely to be.

Mart's Monster Mod - City Defences.ESP edits cells in every city (except Kvatch and the Imperial City), all around the wall tops, both in the city worldspaces and in the main Tamriel worldspace. That's a lot of edited cells, and thus the reason for so many dirty records. And such dirty records exist through no fault of the mod creator!
Example 1: Dirty Edits in Quest mod overwriting Sneak mod
To illustrate a dirty edit due to altering something but reverting it back to vanilla, say you have a quest mod loaded in the middle of your load order after some other mod that alters how sneaking works in Oblivion. Say the quest mod creator originally was going to change the sneak elements in Oblivion to fit his quest mod. However, after editing the settings, the creator decided the original unmodified (called ‘vanilla’) sneak settings were fine, so he changed them back to the original values. In this case, the earlier loaded sneak mod that changed the sneak elements will be overridden by the quest mod, even though the true intent of the mod author was to not alter the sneak settings and the sneak edits in the quest mod were changed back to Oblivion values.
Incidentally, the correct thing the quest mod creator should have done was to actually delete the sneak edits completely from his mod rather than simply change them back to Oblivion values.
Hopefully you can see that the end result of the above example is that your super-cool sneak mod that changes all sneak attack multipliers to 1,000 times more damage will be overridden by the quest mod and you’ll get lame vanilla sneak attack multipliers. This type of dirty edit is fairly mild in its negative effect, but it still causes problems.
The solution is to clean the quest mod. By cleaning the quest mod, the sneak attack changes will be completely removed so that now the earlier sneak mod will be able to change the settings without the later quest mod overriding it.

Type #2: Wild/Undesirable Edits

Wild edits are edits that a mod creator either accidentally or intentionally makes but are due to lack of knowledge in how to properly mod and actually cause problems and are therefore undesirable. Wild edits are called such partly because they appear haphazard and look very wacky when scrutinized by the most skilled modders.

One of the most common wild edits is when a mod modifies a container and puts some loot in it like 10,000 gold. However, they do this incorrectly so that they accidentally make it so 200 containers around Tamriel all now contain 10,000 gold. If you read the description of the mod, it might say, "Adds 10,000 gold to a container in the Imperial City to help new players." Clearly, the intent was to only edit one container, so this would be a wild edit, and need manual fixing.

To Prevent Crash-on-Exit

Another reason to clean mods is to prevent the common Crash-on-Exit many users experience. With new versions of TES4Edit, an extra cleaning step (discussed in the actual instructions below) allows you to undelete and then disable vanilla references that certain mods remove. This can be hard to understand at first, but it's not good to have vanilla references deleted because other mods that rely on them will get messed up and cause the Crash-on-Exit problem.

Arthmoor further explains:

[When running undelete and disable references] the reference is undeleted, then marked as initially disabled and set to -30,000 Z units for its vertical position. This removes it from view in the CS and also removes the possibility of it being held for rendering by the engine. Newer versions of TES4Edit also add a flag to set these items to the opposite enable state of the player to help ensure the items get disabled properly.

The main purpose is to help reduce Crash-on-Exit since deleted vanilla items lead to that if other mods later try to modify what earlier mods have deleted.

Why Clean? Summary

Both dirty edits and wild edits are problems because Oblivion uses the override system which means that if a certain mod changes a specific game element (game setting, stats, characters, towns, buildings, wilderness, etc.), that mod will override changes to the same game element that any prior mods make. Whatever mod loads last, that mod's settings will take precedence over all prior mods that alter the same settings.

Deleted vanilla references can cause the Crash-on-Exit problem so using the "undelete and disable references" cleaning function is also important.

Please note: this description of Why Clean? is a non-technical description and there is much more to say about it, but for our purposes we only need to know that dirty and wild edits are nasty creatures that need to be vanquished by the shining light of truth that is mod cleaning, poetically speaking.

Part #2: What is Cleaning?

Cleaning very broadly defined is a process that analyzes all the changes a mod makes and determines which edits are actually supposed to be in the mod.

There are two ways to clean: manual and automated. Manual cleaning is used to remove wild edits and automated cleaning is used to remove dirty edits. This guide differentiates between undesirable edits and unnecessary edits to help explain these concepts. Undesirable edits are wild edits and require manual cleaning. Unnecessary edits are dirty edits and can be removed using automated cleaning.

Here is a simple summary to help explain:

  • Dirty Edit = Unnecessary Edit --> Automated Cleaning
  • Wild Edit = Undesirable Edit --> Manual Cleaning

This guide is only giving detailed instructions for automated cleaning. However, the next section will give some broad information about manual cleaning in order to increase your understanding of both manual and automated cleaning.

Method 1: Manual Cleaning

It should be said that manual cleaning is an advanced technique that most users don’t have the knowledge or need to engage in most of the time. Automated cleaning is effective enough for removing dirty edits from a mod, and most users will just have to hope the mods they use don't contain too many wild edits. (See Tips on How to Avoid Dirty/Wild-edit Filled Mods for more information.)

There may be times you want to use a mod even though you know it has wild edits (someone told you, you looked at it yourself in TES4Edit, you divined it). This is where manually editing becomes very important. Manually cleaning is required here because the mod contains edits that are undesirable based on a human judgment call. Automated cleaning will not remove these edits. It's not possible for a computer program to determine what the original author’s intent was and what is desirable. To quote the Governator from Terminator 3: ‘I am a machine, desire is irrelevant.’

Let us hear from one expert, Vorians (display name is already in use) regarding manual cleaning:

The other type of dirty records - those which TES4Edit cannot automatically detect and remove (but will color-code them so you can track them down) are typically accidental edits by the mod creator, for example unintentionally clicking on a rock and moving it a tiny amount when they meant to click on something else. Don't try to manually fix these without first gaining some good understanding of both how TES4Edit works and what the purpose and scope of a mod is - you need to be able to tell whether such an edit is a mistake, or in fact intentional.

It's all a matter of understanding what the mod is MEANT to do, to ensure you can tell a valid edit from a [wild] edit.

Vorians continues and gives an example:

Example #2: Super Sword of Slaying Wild Edit
A mod changes the Silver Sword so that it is now the Super Sword of Slaying, and adds many powerful abilities to the weapon, then places it once at the bottom of a new dungeon. Every single placement of the Silver Sword in the game, including those by any other mod, will now be the Super Sword of Slaying.
Changing the Form ID from 00###### to 01###### and updating the single valid reference will ensure that Silver Swords are all Silver Swords, while the one and only Super Sword of Slaying is still the Super Sword of Slaying. [If you don’t understand this Form ID talk, you aren't ready for manual cleaning so don’t worry and just stick with automated cleaning.]

Again regarding undesirable wild edits, let’s quote another expert, Arthmoor:

TES4Edit will highlight in bright yellow wild edits, but it won't automatically remove them as they aren't identical to masters, but these are edits that should not be made. They're fairly obvious [to people skilled with TES4Edit] with their bright yellow highlights. Knowing what a location should reasonably edit is key to removing these safely [manually].

In conclusion, regarding manual editing, the only way to remove wild edits would be to load the mod in TES4Edit and to have enough knowledge to identify edits that are spurious and do not support the true purpose and scope of the mod. Before engaging in manual editing, you should understand the purpose of the mod and also have an understanding of how every edit the mod makes affects the game.

Method 2: Automated Cleaning

Automated cleaning analyzes every edit a mod makes and compares each one to the default Oblivion environment (by comparing the mod to Oblivion.esm and any other master the mod explicitly relies upon) and removes any edits in that mod that are identical to vanilla Oblivion and the other masters loaded. Again, the purpose of automated cleaning is to make sure no dirty/unnecessary edits exist in a mod. Remember, wild/undesirable edits can still exist, but at least the mod will be cleaner than previously and possibly entirely clean.

An Example of a Mod with Both Dirty and Wild Edits

Just to illustrate how some mods need both automatic and manual cleaning, let's look at a real mod. In defense of the mod, it was one of the first ones released for Oblivion and we didn't have as powerful tools back then.

Example #3: Old Dungeon mod Ruins of Tarnesia
Ruins of Tarnesia is a mod that adds a four level dungeon to Oblivion. It's simple and nice. However, 70% (4,440 edits out of 6,304) of the edits it makes are dirty edits because they are absolutely identical to vanilla Oblivion. This means it will probably override a lot of other modded content loaded before it, especially if you have many mods loaded before it.
How all these dirty edits occurred... who knows. Let's blame it on an early bug-filled version of the Construction Set. Regardless, we need to load this mod up in TES4Edit and remove all the dirty edits. We should also note the file size of the cleaned .esp is more than 15 times less (it was over 3,000kb and is now just over 200kb).
On top of the huge number of dirty edits, Ruins of Tarnesia also makes a large number of wild edits. It has many examples like the prior container example where its goal is to modify only the containers in the Tarnesia dungeon but actually modifies all containers across Tamriel. It's not just containers it does this with. Remember, automated cleaning will not detect and delete these incorrect changes in Ruins of Tarnesia because technically the edits differ from vanilla Oblivion and are therefore not considered unnecessary (identical to master Oblivion.esm).
When you encounter mods with both dirty and wild edits, it's easiest to remove the dirty edits first using the automated method. Next, remove the wild edits manually. But in Ruins of Tarnesia's case, sadly, most users just shouldn’t use this mod given how many wild edits are in it.

Part #3: How to Clean

The number one most important thing you must know before cleaning a mod is what other mods the mod to be cleaned depends upon, which is not always obvious. This will be further explained, but here’s the key concept:

Key Concept #1: Automated cleaning requires knowledge of exactly which other mods a certain mod relies upon (is dependant upon), both explicitly and implicitly.

Vorians repeats many times that when cleaning the user must be sure they are ‘doing it right.’ What does this mean? Key concept #2 tells us:

Key Concept #2: The very essence of ‘doing it right’ is to make sure you load into TES4Edit all files (.esp and/or .esm), in the right load order, that the mod your cleaning relies upon, both explicitly and implicitly.

Four terms will be used now to help explain the details: explicit dependency, implicit dependency, simple .esp, and complex .esp.

An explicit dependency is very easy to discern because you can easily check what files it relies upon in Wrye Bash by looking on the right-hand side where Masters are listed. Moreover, TES4Edit will automatically load any explicit dependencies (can be either .esm or .esp files) when you select a mod with explicit dependencies. The only time it won’t do this is if you don’t have a mod installed that the other mod is dependent upon. This would be a major mistake you’ve made. For instance, if you download a patch to fix landscape issues with, say, Verona House Bloodlines, you better have Verona House Bloodlines installed!
An implicit dependency is more tricky because you won’t see the required files listed in Wrye Bash. The most common implicit dependency is when dealing with the many landscape patches by Vorians and some by Arthmoor. The only way to know what implicit dependencies a mod has is to know what the mod does, which can discovered by reading its readme usually. Here again is why understanding what a mod does is crucial. Specifically, you must understand which mods a patch mod is designed to patch!
A simple .esp is one that relies solely on Oblivion.esm and possibly a master. esm from the mod itself, which would be distributed with the mod itself and be obvious. A simple mod has only explicit dependencies, so TES4Edit will always load the necessary master files when loading the mod.
A complex .esp is one that mods another mod and is meant to be used with one or more other mods. This can also be called a ‘patch’ mod. A complex .esp has both explicit and implicit dependencies, so you must by yourself determine and load the implicit dependencies into TES4Edit.

Complex .esp’s can be broken down into two more types:

A basic complex .esp usually edits two other mods in a minor way. Landscape patch mods are the most common examples of this.
An advanced complex .esp must attempt to patch many mods together in a very in-depth way.

The perfect example of an advanced complex group of .esps is FCOM. It is not recommended to clean FCOM not because it *can’t* be safely cleaned but because to safely clean it you need a LOT of knowledge about the inner workings of FCOM, and few people other than dev_akm are qualified here.

Moreover, dev_akm cleans his stuff well enough already. To prove it dev_akm says:

All recent versions of FCOM were created almost completely with TES4Edit to begin with, so every record override includes some important change to one of the masters. You may find a very small number of override records that do not actually change anything in the master, but this usually only happens in cases where the master was later updated to match a change first made in the FCOM plugins (this happens a lot).

So everyone should stop worrying about FCOM and just not clean it. Instead, you should worry about nuclear war (or the absence of it?) or something.

Example #4: A simple .esp – KvatchRebuilt.esp
Kvatch Rebuilt.esp is a simple .esp because it depends only upon Oblivion.esm and KvatchRebuilt.esm. You would be able to tick KvatchRebuilt.esp in TES4Edit only and have TES4Edit load both the aforementioned .esm files properly, and cleaning would be perfectly safe and simple.

Let us quote Vorians regarding cleaning patch files. His note has been verified as correct by ElminsterEU, the creator of TES4Edit.

It should be perfectly safe to clean a patch as long as you ensure that every ESP that the patch relates to is also loaded in TES4Edit. And I mean all of them, not just those which have to be loaded because the patch is dependent on them. So for example one of my Unique Landscape compatibility patches is only [explicitly] dependent on Oblivion.esm but is for one Unique Landscape mod and one other mod. You must load into TES4Edit the Unique Landscape mod and that other mod (in the correct load order!) before attempting to clean the patch.
Example #5: A complex mod – Landscape patches like the Baddy patch for Entius Gorge
Here is an actual example of what Vorians means using his Unique Landscape compatibility patch for Baddy as an example:
This patch is dependent on Baddy.esp, so if you wanted to auto-clean this ESP, TES4Edit will load Baddy.esp when you load Baddy-EntiusGorge patch.esp. It won't however load xulEntiusGorge.esp as the patch is not [explicitly] dependent on the Unique Landscape ESP. [So the user MUST be sure to tick the UL ESP themselves, when first loading TES4Edit. If you forget to tick the UL ESP, you run the risk of removing IMPORTANT edits when automatically cleaning the mod.]
 
So, the patch has Baddy.esp as a master, making the patch explicitly dependent on Baddy.esp. The filename, readme and entire purpose of the mod makes it clear that xulEntiusGorge.esp is fairly important for the patch to work correctly. So it is implicit that the mod is dependent on xulEntiusGorge.esp even though there is no master entry in the header record.
 
This means that it is obvious to anyone who is actually intelligent enough to be safe using TES4Edit in the first place (did I say that out loud?!) that to do it right, you need to have both Baddy.esp and xulEntiusGorge.esp loaded into TES4Edit (and in the correct load order!) for the automated cleaning to be reliable [not mess things up].
 
Therefore…there is no valid reason to not clean a patch where it is blatantly obvious which other mods it was designed to patch.
Example #6: Another Illustration of the Importance of Loading Implicit Dependencies
DuggeDank provides the following example. Assume Mod A is a great mod but it regrettably makes a few silly changes. For instance, Mod A changes the name of the NPC Baurus to JohnnyBoy but does a lot of other really cool things. So Mod B is created in order to fix (patch) Mod A. Therefore, Mod B changes the name of the NPC Baurus back to Baurus in order to get all the changes from Mod A except the name change.
If you were to only load Mod B without also loading Mod A into TES4Edit, then TES4Edit would notice that Mod B's record of for Baurus is identical to its master Oblivion.esm. Hence, automated cleaning would remove the name change in Mod B because it appears to be unnecessary. This would be bad because now you’d have JohnnyBoy running around your game again.
This is why it is critically important that you load both Mod B and Mod A into TES4Edit in the proper order (Mod B loads after Mod A since it modifies Mod A).

But as ElminsterEU points out:

This problem [the JohnnyBoy issue] only happens if you load JUST Mod B and not Mod A into TES4Edit at the time you do the [automated] cleaning.
If both Mod A and B are loaded, then that record in Mod B would be marked as ‘identical to master but conflict winner,’ in which case the cleaning should not touch it.

To prevent the possibility of Mod B being loaded without Mod A being loaded, Mod B should list Mod A in its master list in which case trying to load Mod B into TES4Edit will always load Mod A as well.

Elminster’s final point is aimed toward mod creators. It is best and safest that any time you release a mod that modifies or relies upon another mod(s), you should list the other mod(s) as a master in the header of your mod if possible. This may not be practical in some cases, but in most cases it makes sense as a goal to aim for.

Lastly regarding Example #5, the much preferred solution to this whole problem would be for the original mod creator of Mod A to delete the JohnnyBoy edit. But this may not happen because for many reasons such as the mod author is long gone, likes the JohnnyBoy change, and/or is criminally insane. This is why sometimes a patch needs to contain typically unnecessary edits to counter the undesirable edits.

Why has so much time been spent on discussing cleaning philosophy instead of actual cleaning instructions? The reason is because the majority of problems you can cause by cleaning come from a lack of understanding rather than mistakes in the actual cleaning process. Also, the actual cleaning process is very simple (but tedious). And here enters our last Key Concept.

Key Concept #3: The true challenge in cleaning is not the logistics of cleaning but the knowledge required to know what files to load into TES4Edit.

Tips on How to Avoid Dirty/Wild-edit Filled Mods

Briefly, several points will be made about how to avoid problem mods that contain many dirty and/or wild edits. The best way to avoid wild edits is to only use mods created by experienced and trusted modders who already make sure to clean their mods before release. However, doing this would greatly limit your mod choices, and there will be certain mods that are too cool to pass up, even if you don't know the expertise of the creator.

Consequently, before using a mod, one strategy is to read comments posted by users on Tesnexus, Planet Elder Scrolls, or the Tesforums thread for that mod. Sometimes this can give you an idea if people are having major problems with the mod. Of course, be careful trusting any comment since many problems users have are due to the users’ mistakes, not the mod itself.

It is also highly advisable to only add one mod at a time to your game. This means download and install a mod and then play for a period of time before adding another mod. This can help determine if the mod you just added is problematic. But now we are delving into the realm of mod conflicts, which is way too large a subject to cover here, so only a few other points will be mentioned.

Adding mods slowly can be helpful, but it in no way is a perfect way to detect mod problems. Sometimes you'll add a mod and you're game will start crashing. You might want to blame the new mod. Maybe you are right. But also, it may be that another mod you are currently using contains either dirty (not if you already cleaned it, mind you) or wild edits, which by itself didn't cause problems (sort of like a dormant virus). However, adding the new mod, which may be totally clean, caused the prior mod to now wreak havoc on your game. The details of this type of scenario won’t be explained here but just know that this type of thing happens often, which makes it challenging to find the real culprit when your game goes wacky.

But truthfully, most users won't ever know if a mod they are using has wild edits in it unless they put in a lot of effort reading about the mod and looking at it in TES4Edit. Therefore, the average user should take the above-mentioned precautionary measures and not worry about things as long as their game runs pretty well and is fairly stable, by whatever definition you wish to use.

Load Order Notes

Besides loading all explicit and implicit mods into TES4Edit in the right load order, the mod you are cleaning should always be the last mod loading in TES4Edit. This is crucial. Never, ever, ever clean a mod that has other mods loaded into TES4Edit after it! This means you cannot load groups of mods together into TES4Edit and clean them in the same TES4Edit session. You must load the proper files as discussed above and clean only the last mod. Then you MUST close TES4Edit and start over with whatever next mod you want to clean. This is why cleaning many mods takes a long time. It is recommended you set aside many hours when you will clean your mods.

Vorians sums up with another ElminsterEU verified statement saying:

Best practice [what you should always do and never do anything different!] when cleaning an ESP is to always only ever load into TES4Edit the files necessary to carry out the cleaning. This means there should be zero files loading after the file you are cleaning.

Now here are some hard and fast rules by the man, ElminsterEU, himself. These rules NEVER change and ALWAYS apply to cleaning.

  • The module you are cleaning must be the last in the load order
  • All modules (which can be both esm's and esp's) that the to-be-cleaned module depends on (no matter if they are in the master list or if the dependency is implicit and indirect as e.g. with some of the FCOM modules) must be loaded in the correct load order

Note that to have the correct load order, you set your order to usual way as if you were playing. So as long as you already have the correct load order (you do, don’t you?), then you don’t need to do anything different for using TES4Edit. Load ordering is not within the scope of this document, but the easiest way to get the correct (mostly) load order is to use Better Oblivion Sorting Software (BOSS).

What Order to Clean Mods In?

It is recommended that you begin cleaning at the top of your load list and just do down the list. This means start with your earliest loading mods (top of the TES4Edit box that appears when you open TES4Edit).

Arthmoor also says to clean the ESM first when you have an ESP dependent upon it. This will happen anyway if you simple start at the top of your load list (the ESM’s will be cleaned first).

Some people also wonder in what order to clean mods that are related to each other, Again, the recommendation is to always work from the top downward.

A Community-Wide Effort

ElminsterEU rightly points out that cleaning mods should be a community-wide effort. The following is adapted from his statement on the subject.

It's NOT a good idea for everyone to just go ahead and clean their full load order and then forget about it.

The problem is twofold. First, to properly clean mods usually requires an understanding of the intent of the mod author. There might be implicit dependencies on other mods which are not part of the master list. Second, and following from the first, depending on how the cleaning was done, people end up with slightly different versions of these modules, which is going to make support in case of problems a nightmare for the mod author.

Also, this would (and currently does) lead to a huge waste of time as different people are cleaning the same mods over and over.

What is needed is more awareness of the issues.

For mod authors:

  1. Clean your mods properly. All of them. You are the one who really knows the intention of your mod. Closely review all changes to make sure they preserve the intent of your mod.
  2. Cleaning mods is NOT just limited to running the automated functions and be done with it. Manually review every override record your module(s) contain to make sure that that's really what you intended to do.
  3. List in your documentation that you HAVE cleaned your mods and which version of TES4Edit you used for it. If there were any indirect dependencies that you had to observe while doing the cleaning, specifically list them and the rational for them.

For mod users:

  1. Check your mods that do not specifically mention being properly cleaned (by basically doing a dry run of the cleaning process).
  2. If any of your mods are dirty, inform the author. The mod authors are the ones that really understand the intention of their mods. They are the ones that are in the best position to properly clean them. And if they only publish properly cleaned mods, the whole community benefits from it.
  3. If a mod has been deserted by its author or the author is unwilling to fix his mess, just leave a short note on the comments and/or in the RELz thread to save other mod users from wasting their time. Remember: stay civil; flaming doesn't help anyone.

Mod quality is a community-wide problem that needs to be properly addressed on a community level. And from the ground up, starting with the mod authors. Everyone doctoring around on the symptoms (by cleaning the mods in their own load order) is just wasting a huge amount of time and effort and actually makes support more difficult because different people will have different versions of the same mod.

This is primarily an awareness problem. Only in very rare cases are dirty mods a skill problem. And even more rarely an attitude problem.

A concentrated community-wide effort is required to raise awareness of these issues, and to make it clear that as a matter of community standards, it's not ok to release sub-quality modules which cluster bomb over everything else.

Section #2: Actual Cleaning Instructions

And now, at last, the actual instructions:

  1. Download TES4Edit created by ElminsterEU.
  2. Unzip the two files in the archive to wherever you please. I use a folder called \Oblivion Tools\.
  3. Make a shortcut for TES4Edit.exe and place it in an easily accessible place because you will be opening, closing, and re-opening TES4Edit as many times as you have mods to clean. I recommend the shortcut go on your Desktop.
  4. Run the TES4Edit executable.
    • Outdated instructions: Before version 2.3.0 or so, you had to rename TES4View.exe to TES4Edit.exe or use the “-edit” tag. You also had to use the “-fixupPGRD” tag. All this is no longer necessary. Just download TES4Edit, and run TES4Edit.exe plain and simple.
  5. A dialog box appears with a complete list of your .esp/.esm files. All your currently enabled plugins will be ticked.
    • Right-click anywhere in the list and pick “Select None.”
    • Now select whatever mod you want to clean and make sure to also select any implicit dependencies (you read the entire first section of this guide and you understand what a implicit dependency is, don’t you?). Explicit dependencies can also be ticked just to help you make sure all required mods are included, but explicitly dependent files don’t actually need to be ticked because they will automatically load anyway. Hit ok.
    • A mod group dialog box might come up. Never tick any boxes for mod groups when cleaning, ever.
  6. Wait for the mod to load. This will take a short while because it has to also load Oblivion.esm, which is large, and possibly other master files if there are any dependencies.
  7. After loading, right-click on the mod you are intending to clean and pick “Apply Filter.”
  8. A big dialog box will open with about a thousand different options. Panic for one second and then calm down. You only care about one single checkbox: "Conflict status inherited by parent". All other main checkboxes need to be deselected. Here is an image. Hit ok.
    300px
  9. Wait for the process to finish. It can take a long time if you’re dealing with a very large or dirty .esm/.esp. This will take a lot of memory also so don’t do other memory-intensive activities when filtering.
  10. Now, right click on the mod you are cleaning and pick “Remove "Identical to Master" records.”
  11. Wait two seconds when the big warning message appears and click “Yes…”
  12. The mod name will turn bold if any dirty edits were found and removed. Check the Messages tab to see what was changed. If you have some technical knowledge about how the mod works, now is a good time to investigate each removed record and/or make a copy of the removal log for later review. If you don't have much technical knowledge about the mod, then you'll have to assume everything was safe to remove, as long as you did it right (check the glossary for a definition of this term). Even if you don't understand all the details, you can still help out by sending a copy of the removal log to the author.
  13. The new versions of TES4Edit allow an additional cleaning step for deleted vanilla references. Right click again on the mod you are cleaning and select “Undelete and Disable References.” If any references were undeleted and disabled you'll get another list of such things on the right side of TES4Edit, but don't worry about the details. Doing this extra step will help prevent one major cause of the game crashing when exiting.
  14. Try to close the program. If there were no dirty edits found or references undeleted and disabled, the program will close properly. That mod is clean in regard to automated cleaning. However, if dirty edits were found, upon trying to close the program a dialog box will come up listing the .esp/.esm you modified. Click “OK.”
  15. Now you’ve cleaned the mod and a cleaned version of the .esp/.esm with the same exact timestamp is in your \Data\ folder ready to be used in game. A backup is also in your \Data\ folder. What I do is clean all my mods and afterward sort the files in \Data\ so that all the backups are together and I cut and paste them to another safe location outside my main \Oblivion\ folder.
  16. If you have some technical knowledge about the mod you just cleaned, now is a good time to compare the changes against the original mod, to make sure you didn't accidentally introduce new problems during the cleaning process. If you kept a copy of the removal log from Step 12, use it as a guide here. Load the same files again and use TES4Edit's Compare to function to check the changes. If you don't have much technical knowledge about the mod you just cleaned, you'll have to skip this step, but you can still help to raise awareness of these issues by sending a copy of the removal log to the author.
  17. Now repeat these directions for every mod you want to clean, starting with the very top of your load order. Never clean more than one .esp/.esm at a time and always make sure the .esp/.esm you are cleaning is the very last file in the list.

I'll update this with screenshots and better formatting soon...but the directions are quite fine as they are methinks.

The guide here has more pretty pictures if you're in to that sort of thing. Read it over too if you still aren't sure about the process.

Review of Key Concepts

Key Concept #1: Automated cleaning requires knowledge of exactly which other mods a certain mod relies upon (is dependent upon), both explicitly and implicitly.
Key Concept #2: The very essence of ‘doing it right’ is to make sure you load into TES4Edit all files (.esp and/or .esm), in the right load order, that the mod you are cleaning relies upon, both explicitly and implicitly.
Key Concept #3: The true challenge in cleaning is not the logistics of cleaning but the knowledge required to know what files to load into TES4Edit.

The astute reader will realize all three key concepts are actually saying the exact same thing.

Quick List of What & What Not to Clean

  • Do NOT clean any FCOM files that come in the FCOM archive.
  • Do NOT clean SM Plugin Refurbish…unless you really understood this guide.
  • Do NOT the unofficial patches (UOP, USIP, UMP). They have already been cleaned.
  • Do clean WarCry & Bob’s Armory.
  • Do clean the official DLC.
  • Do clean just about everything else…

List of Mods Needing Cleaning

This list is NOT comprehensive. It is merely here to point out some of the more popular mods that definitely need cleaning. Any mod not on this list and not on the Clean list may need cleaning.

Cautionary note: Keep unaltered backup copies of your DLC files somewhere safe in case you need to reinstall them. These are much more difficult to replace from an online source!

Note for contributors: If available please state the version number of the mod you found in need of cleaning. And possibly also state how many "Identical to Master" (ITM) records and "Undeleting and Disabling References" (UDR) were found. Thank you. Also, if you make changes, please do try to let us know at either BGS or TES Alliance so we can update the mirrors (they are being kept to raise public awareness combat potential sabotage).

Users of the Better Oblivion Sorting Software utility (BOSS) will now be pleased to hear that it contains a fully up-to-date database of all dirty mods, and will report back to you if any of your plugins require cleaning, but only if you have the original dirty plugin! The dirty mod list you see below is now taken directly from the BOSS Masterlist, and is fully up-to-date with all previous versions.

(DC) Sutch Reborn.esp  [8 ITM, 0 UDR]

1em_Vilja.esp  [11 ITM, 0 UDR, CRC CBB991E4]

24HrArenaAliveV2.esp

300 Feudal Empire.esp
300 Regal Imperial City 2.esp  [0 ITM, 130 UDR]
300_Artifacts.esp
300_Lore_Dialogue_Updated.esp
300_White Stallion 4.esp

A Blades House.esp
Addendum - Diabloblivion.esp  [1 ITM, 0 UDR, CRC D6814DD]
AdenseEpicDungeon.esp
Adonnays Elven Weaponry.esp
AFK_Weye.esp
AlchemistsCave-COBL.esp
AliveWaters - Koi Addon.esp
AliveWaters.esp
Aliyah.esp
allinonebasement_COBLnoCM.esp  [2 ITM, 0 UDR]
Amajor7 Imperial Furniture.esp
AmbientTownSounds.esp
AnavirsPool.esp  [115 ITM, 3 UDR, CRC 3ADED84A]
Apachii_Goddess_Store.esp  [0 ITM, 3 UDR, CRC 6644E61D]
Apachii_Heroes_Store.esp
Arcana Restored.esp  [0 ITM, 3 UDR]
ArchersLodge1.1.esp  [13 ITM, 12 UDR, CRC 208C0818]
Armor_skirts.esp
Armor_skirts_nonlvl.esp
Artefacts of the Ancestors.esp
Artifacts.esp  [0 ITM, 1 UDR, CRC 66B9B580]
Atmospheric Oblivion.esp  [1 ITM, 0 UDR, CRC 9A266EC1]
Auriel's Books.esp
AutoEquip.esp
AyleidArrows.esp  [32 ITM, 77 UDR, CRC 1B13049A]

Bandit Hideouts.esp  [12 ITM, 2 UDR, CRC EB5BF385]
bartholm.esp  [211 ITM, 553 UDR]
BD&R - Deepgrave.esp
Beautiful_Women_NiceOnly.esp
BeldaElysium.esp
Benirus Manor Remade.esp
Better Clocks.esp
BHC_Expanded.esp  [2 ITM, 12 UDR, CRC C73A3567]
Blood&Mud.esp  [36 ITM, 401 UDR]
Blue Destiny's Paladin Armor.esp
Bob's Armory Oblivion.esp  [6 ITM, 0 UDR]
Book Jackets Oblivion.esp  [8 ITM, 234 UDR, CRC 88936850]
BrumaMGRestored-Frostcrag.esp
BrumaMGRestored.esp  [10 ITM, 0 UDR]
BXX_Mines.esp  [40 ITM, 23 UDR]

C&C - The Blackwood Company.esp
Castle_Seaview.esp
CDEP-UnderpallCave.esp  [3 ITM, 246 UDR]
CDEP_FanaCeya.esp  [13 ITM, 122 UDR, CRC 84B74D3F]
cf_Improved_Barter_Gold.esp
Chichester Village.esp  [72 ITM, 161 UDR, CRC A5A89A38]
Choices and Consequences - OOO.esp  [0 ITM, 10 UDR]
Choices and Consequences.esp
Chorrol Jewelry Company.esp
Cliff_BetterLetters.esp
Cliff_CountyNames.esp
ClocksOfCyrodiil.esp
cloudcity mod V1.1.esp  [181 ITM, 50 UDR, CRC D89C1AC6]
Cobl Glue.esp  [0 ITM, 14 UDR]
CompleteMagePack.esp
Crowded Cities 15.esp
Crowded Roads Advanced less crowded.esp
Crowded Roads Revisited.esp  [4 ITM, 0 UDR]
Cryptic Festive Ayleid Dining Set.esp
Cryptic White Rose Ayleid Dining Set.esp
CUO_Bravil.esp  [42 ITM, 729 UDR, CRC A1A0CAA2]
CUO_Bruma.esp  [11 ITM, 5 UDR, CRC 79E62DCD]
CUO_Chorrol.esp  [29 ITM, 468 UDR, CRC A7AF03A3]
CUO_Leyawiin.esp  [47 ITM, 417 UDR, CRC FF5FEEE3]
CV - Templar Fortress.esp  [50 ITM, 892 UDR]
Cybiades.esp  [2 ITM, 0 UDR]
Cyrodiil Border Regions 1.2.esp
cyrodiil transportation network 1.3 wz.esp

Daedric Shrine Ruins.esp  [0 ITM, 753 UDR, CRC 99BD9CB0]
Dark Illusion Armour (HGEC Version).esp  [11 ITM, 1 UDR]
DarkLeatherArmor.esp
DarknessHollows.esp  [22 ITM, 0 UDR, CRC A81A605C]
DBSRebuiltComplete.esp
DeadlyReflex 5 - Combat Moves.esp
DLCBattlehornCastle.esp  [13 ITM, 74 UDR, CRC 7048C609]
DLCFrostcrag.esp  [73 ITM, 94 UDR, CRC 2A7665FB]
DLCHorseArmor.esp  [3 ITM, 0 UDR, CRC BAD48E5D]
DLCMehrunesRazor.esp  [21 ITM, 15 UDR, CRC CB413740]
DLCOrrery.esp  [11 ITM, 2 UDR, CRC 5BC59DB4]
DLCSpellTomes.esp  [40 ITM, 0 UDR, CRC 312156F8]
DLCThievesDen.esp  [5 ITM, 135 UDR, CRC 5DB8CCC]
DLCVileLair.esp  [26 ITM, 1 UDR, CRC 74D2CA6F]
DoTheUnderdark.esp  [22 ITM, 1 UDR, CRC 61246D9A]
DremoraCompanion.esp
DruidsTree.esp
Duke Patricks - Fresh Kills Now Alert The NPCs.esp
dungeon.esp  [4 ITM, 0 UDR, CRC 1937E82F]
Dwarven Mines.esp

Echo_ChapelChant.esp
Edhildils Underdark.esp  [8 ITM, 0 UDR, CRC 1BCA0F29]
EiAmod.esp
Emarion Equipment.esp
emperorface.esp
Enhanced Daedric Invasion.esp
Enhanced Quest Roleplaying.esp
EverHaus3.esp  [49 ITM, 22 UDR, CRC 10F16EB7]
ExtendedAleswellEV.esp
ExtendedBlankenmarchEV.esp
ExtendedBleakerswayEV.esp
eyja.esp

Fairies.esp  [62 ITM, 0 UDR]
Feudal Empire 300.esp
FightersGuildContracts.esp  [28 ITM, 9 UDR, CRC BB0D71D0]
First Person Messages.esp
Francesco's Optional Chance of Stronger Enemies.esp  [3 ITM, 0 UDR]

GatewayRealm.esp
GatewayRealmUL.esp
Gift of Kynareth.esp  [0 ITM, 3 UDR]
Giskards Tales From the Tomb.esp  [1 ITM, 24 UDR, CRC 90F0F66]
GlenvarCastle.esp
Grandmaster of Alchemy.esp
GTAesgaard.esp  [107 ITM, 8 UDR, CRC 94A96B7D]
GTAesgaard_2.esp  [13 ITM, 12 UDR]

hackdirtabyss.esp  [3 ITM, 8 UDR, CRC E8CA2F00]
Harvest [Flora] - DLCFrostcrag.esp  [CRC ADFEEDB5]
Harvest [Flora] - Shivering Isles.esp  [CRC 5003A29]
Haunted_House_v1.5.esp  [13 ITM, 5 UDR, CRC C61B8314]
HauntedHouse.esp  [38 ITM, 5 UDR, CRC 2F2F9619]
HauntedLairMod.esp
HeartoftheDead.esp
Hentai Mania.esp
HentaiMania2(Hentai).esp
HentaiMania2.esp
Heroes of Cyrodiil.esp
HoarfrostCastle.esp  [4 ITM, 730 UDR]
Holy Cathedral.esp  [104 ITM, 1 UDR, CRC B294E4F]
HouseMapMarkersOnlyBought.esp

Illusionary Summons.esp
Immersive Travelers.esp  [8 ITM, 0 UDR]
IOM - Arena.esp
Ivellon.esp  [9 ITM, 13 UDR, CRC 645E2C6D]

KDQ - Rural Line Additions.esp  [2 ITM, 0 UDR, CRC A93FE8B0]
kingdomofAlmar.esp  [177 ITM, 31 UDR, CRC 72392FC9]
Knight of Skeleton.esp
KnightlyArmory.esp
Knights.esp  [121 ITM, 257 UDR, CRC F1F478FA]
Kvatch Rebuilt.esp  [26 ITM, 4 UDR, CRC 34A9FAC9]
KvatchAftermath.esp  [5240 ITM, 390 UDR, CRC 8997D4F1]
KvatchRising.esp  [220 ITM, 3 UDR, CRC 6C91CBEB]

Legendary Abilities-Reflect MOJ.esp  [5 ITM, 0 UDR]
Legendary Abilities-Shield MOJ.esp
LetThePeopleDrink-Cobl.esp  [9 ITM, 152 UDR]
LetThePeopleDrink-fountainonly-Cobl.esp  [6 ITM, 93 UDR]
LetThePeopleDrink-fountainonly.esp  [6 ITM, 93 UDR]
LetThePeopleDrink.esp  [9 ITM, 152 UDR]
Living Economy - Items.esp
lorecreatures.esp  [36 ITM, 1 UDR]
Lost Paladins of the Divines.esp  [6 ITM, 3 UDR]
LostSpires_TheOrderofNibenay_patch.esp
LostSwordOfTheAylied.esp
Lyn-StoriesFromTheSeaMod.esp
Lynges_Thieves_Highway-10256.esp

Mad Mike's Crypts of Cyrodiil.esp  [16 ITM, 0 UDR, CRC 560DE988]
Mage'sSkyHouse.esp  [79 ITM, 3 UDR, CRC CEC8800F]
Malevolent.esp
MannimarcoComplete.esp
MannimarcoRevisited.esp  [CRC E2BE41DA]
MD Saddlebags V3.0.esp
MidasSpells.esp
Mighty Umbra.esp
Mimics!.esp  [0 ITM, 8 UDR, CRC 7F582015]
MIS Low Wind.esp  [2 ITM, 0 UDR, CRC F343D8EA]
MIS.esp
MODAssassinsCreed2_Revisited.esp
moDem's City Life.esp
Moriarcis.esp
Morrigan Swords Axes and Shield by Jojjo v1_1.esp
Mounted_Spellcasting.esp
mrSiikasBetterPorts_CorvetteExpansion.esp
MTCRiverShackv1.2.esp  [94 ITM, 5 UDR, CRC 47777B7D]
Museum.esp  [4 ITM, 0 UDR, CRC E3CC13A8]
MvCQuellArkadiensEV.esp  [0 ITM, 8 UDR, CRC B9CE0619]

Nagrons Berg-Pagode.esp  [5 ITM, 17 UDR, CRC B0C916AC]
NakedNord.esp  [18 ITM, 0 UDR]
Nanaelas Heartbreak.esp
Nascosto Isles 3.esp
New Frostmourne Sword by Jojjo v1_0.esp
New Potions by Tealpanda.esp
NEW SHEOTH PALACE LOD FIX-TESSource.esp
New_Sheoth_Palace_LOD_fix-10076.esp
Nicoroshi Creations DW heavy.esp  [1 ITM, 20 UDR, CRC 99B70AED]
Nicoroshi Creations DW Light.esp  [5 ITM, 135 UDR, CRC 3F5B9AB5]
NNWARE Series 1.esp  [20 ITM, 11 UDR]
NNWARE2.esp  [11 ITM, 0 UDR]
No psychic guards v1.2.esp
Northern Front.esp

Oblivifall - Ambiant Dungeon SFX.esp  [1 ITM, 0 UDR, CRC CBB991E4]
OBSE-Storms & Sound SI.esp  [45 ITM, 0 UDR]
Origin of the Mages Guild.esp  [173 ITM, 383 UDR, CRC 440FF00]

P1DseeYouSleep.esp  [7 ITM, 0 UDR]
pale_rider's Paladin Equipment_unenchanted_eng.esp
PearlFarm.esp  [12 ITM, 0 UDR, CRC 590DE30D]
PersonalPackGuars.esp
PhoenixEquipment.esp
PJs Spell Compendium - Spell Requirements.esp
Portable Campsite.esp

Qarl's Harvest 1.1.esp  [8 ITM and 105 UDR]
QQuix - Rock, rock, rock your ship - V3.esp  [12 ITM, 0 UDR]

Rainbows.esp  [CRC 71BDDEC0]
Realistic Water.esp  [3 ITM, 0 UDR]
Reaper's Esmeralda's Desert Manor.esp  [48 ITM, 32 UDR, CRC DB57B73]
Reaper's Waterfront.esp  [14 ITM, 60 UDR]
rebornaylieds.esp
Region Revive - Lake Rumare.esp
Return Of Shadows.esp
Reznod_Mannequin.esp
ROHJ2.esp
Roleplaying Dialogues.esp
RomancingAhnassi.esp
RTT.esp  [32 ITM, 3 UDR]
Ruin.esp
Ruins of Tarnesia.esp  [4440 ITM, 1 UDR]

Salmo the Baker, Cobl.esp  [34 ITM, 0 UDR]
Sauron_Armor_Chest.esp
SB IC Palace Tower Light Mod v1.1 - Constant Yellow Light.esp  [2 ITM, 0 UDR]
Secure Guild Chest.esp
SeductiveIdles.esp  [3 ITM, 0 UDR]
SentientWeapon.esp
Shadow Ranger.esp  [19 ITM, 2 UDR]
ShadowfangKeep.esp  [313 ITM, 2 UDR, CRC A970802F]
Shdw_Armor Set_Sotonhorian.esp
Sheogoraths_Accords_of_Madness.esp  [98 ITM, 71 UDR, CRC C7AFC21D]
ShiveringIsleTravellers.esp
sir_balin_mod.esp
SK_Berserk_v0.6.esp
SkyrimObservatory.esp  [14 ITM, 7 UDR, CRC 5ADC0013]
Slof's Horses Base.esp
SM Plugin Refurbish - Battlehorn.esp
Solace.esp
Sonia.esp
SoT_TheOrderofNibenay.esp
Spells and Enchanting at guilds.esp
Spirit's Edge.esp
Star's Fury.esp
StokerWolff.esp
Storms & Sound.esp
Suliin V1.2.esp
SunderedKeep.esp
sunk ships.esp  [135 ITM, 34 UDR]

T-HMO.esp
T.I.E4MODS.esp
T.I.E4MODSOOO+FCOM.esp
Tales from Elsweyr Anequina.esp  [0 ITM, 224 UDR]
TalosBridgeGateHouse.esp  [15 ITM, 31 UDR]
TamrielTravellers4OOO.esp
tda_Armoury.esp
tda_WitchKingHelm.esp
The Ayleid Steps.esp  [0 ITM, 1 UDR, CRC B0311481]
The Crimson Queen.esp
The Imperial Water - BETTER CITIES.esp
The Lost Spires.esp  [CRC 5B6ADFB3]
The Mystery of the Dulan cult.esp  [4569 ITM, 16 UDR]
The Temple of Medusa.esp  [37 ITM, 0 UDR, CRC CC093DE]
TheElderCouncil.esp  [274 ITM, 192 UDR, CRC 763FC748]
TheElderCouncil_TempleOfTheOne.esp  [15 ITM, 0 UDR, CRC 5BEE0900]
TheForgottenShields.esp
TheNecromancer.esp  [108 ITM, 178 UDR, CRC 6798B41]
TheOubliette.esp  [32 ITM, 0 UDR, CRC 2F16C1C5]
Thermae.esp  [21 ITM, 39 UDR, CRC AAD7EC09]
TheStorytellersBrotherQuest.esp
thievery.esp
Thieves Arsenal.esp
Tombstone Epitaphs.esp
TOTF.esp
TR_Stirk.esp  [CRC BAEEF8CF]
TRoN.esp
Tyrael Companion.esp

UFF & RM Gold and Silver Daedric Armor.esp
UnderdarkSaga.esp
Ungarion1TheWelkyndSword.esp
Unholy Cathedral.esp  [431 ITM, 149 UDR, CRC 840C67F8]

Valenwood Improved.esp  [173 ITM, 0 UDR]
Valley_View_Estate.esp
Vampire Hunting - Order Of The Virtuous Blood.esp
VAs Better Gold with no Menu Icon.esp  [0 ITM, 1 UDR]
VaultsofCyrodiil.esp  [15 ITM, 58 UDR]
Verwen Brewery UL_AY_AC Compatable.esp  [0 ITM, 1 UDR]
VHBloodlines 1.2.esp
Villages1.1.esp  [24 ITM, 19 UDR, CRC 71F17D9E]
Vin Swords.esp
Visually Enhanced Arena.esp

WAC - Birds&Insects.esp  [11 ITM, 0 UDR]
Watchtower.esp  [8 ITM, 16 UDR, CRC 11D3867A]
Waterfront Shack.esp  [1 ITM, 8 UDR]
WatersEdgeImproved.esp  [30 ITM, 14 UDR, CRC 53A73FA1]
Wayshrines Improved.esp  [13 ITM, 0 UDR]
WeaponsOfTheNine.esp
Wellspring Vale COBL.esp  [2 ITM, 134 UDR]
West Roads.esp  [5 ITM, 10 UDR]
Weye.esp
Windfall.esp
Witch's Throne.esp  [12 ITM, 14 UDR, CRC 6F1BEFB0]
witchkingsword.esp
WOTFH_1.3.esp

Your_Personal_Museum_Updated-9300.esp

300_White Stallion 4.esp Special Cleaning Instructions

Requires custom TES4Edit work to fix errors or it can’t be saved. It's too complicated to list here, but it has to do with editing REFR:00092EC9 so that it uses the Upper version of the door and moving the door into the correct position. Copy the coordinates from REFR:020014BE then delete REFR:020014BE. This also applies to the renamed Feudal Empire version.

While we're talking about White Stallion/Fuedal Empire, this mod also has a LOT of errors in the AI Packages. They currently have no faction assignments and need to be updated. You can open the mod in the Construction Set and go to AI Packages and find all the ones with null parameters. Change those to have the following two conditions:

Target no, GetFactionRank, LeyawiinFaction, >=, 0.00 AND Target no, GetFactionRank, KnightsWhiteStallion, >=, 0.00

Artefacts of the Ancestors.esp Special Cleaning Instructions

This mod contains two cells that share the same FormID (DELETEDHdADungeon and DELETEDHdAHaus, with FormID XX000CE8). This will cause TES4Edit to error when you attempt to open the plugin to clean it. There are two methods to correct this:

1. Open the plugin in the Construction Set with Construction Set Extender installed and give one of the cells a new FormID. This is not recommended unless you are a highly experienced modder, though.

2. Use TESSnip to remove one of the duplicated cells. Instructions follow:

Once, you have opened the plugin in TESSnip, locate the CELL records DELETEDHdADungeon and DELETEDHdAHaus (Fifth GRUP bunch down in the CELL GRUP, first Sub-Group). As you will be able to tell, these cells have identical FormIDs, and at least one of them needs to go. Given the prefix of the Forms, it is very likely that neither was ever meant to be seen in game, but this is something that really cannot be told at a cursory glance. Anyways, deleting at least one of these cells will fix the error.

This will allow you to edit the plugin in TES4Edit and clean things up.

Waterfront Shack.esp Special Cleaning Instructions

Contains NULL Refs that must be deleted manually. These are the refs:

XX000EF9 XX000EF8 XX000EF7 XX000EFE XX000EFB XX000EFA XX000EF6 XX000EF5 XX000EF3 XX000EF2 XX000EEF XX000EEE XX000EE9 XX000EE8 XX000EE7

List of Mods Already Clean

1AzuSeraphimSet.esp

AFK_Weye.esp
Alchemy Book.esp
Alir'sArmor.esp
All Natural.esp
All Natural SI.esp
All Natural - Real Lights.esp
Alluring Potion Bottles v3.esp
Alyeid Loot Extension.esp
Andragorn_Weapons_Armors.esp
Anduril Reforged.esp  [Version 1.31]
ArmamentariumArtifacts.esp
Armamentium female.esp
Armory of the Silver Dragon.esp
Arren.esp
Artifacts - ArmaCompleteAddon.esp
ArtifactsFemaleArmor.esp
AsharasCMPartners.esp
AT2 01-Shiki Armor Set.esp
AT2 02-Shiki Armor Set.esp
Atmospheric Oblivion.esp
attack and hide xxx v2.1.esp
AudaciousMagery.esp

Bedrolls-OBSE.esp
Better Cities (all files)
BetterCoins.esp
BlackLuster.esp
BookCollisionTest.esp
BrinaCrossVillage.esp
BrinaCrossVillage - COBL.esp
Brina Cross - Unique Forts Patch.esp

C&C - The Blackwood Company - OOO.esp
Camping.esp
CapesandCloaks.esp
Castle Redwort.esp
Chapel Shop.esp
ChaseCameraMod.esp
Cobl Races TNR.esp  [Version 1.53]
Cobl Races TNR SI.esp  [Version 1.53]
Cobl Si.esp  [Version 1.63]
CM Partners.esp
CybiadesDungeon.esp

DACompilation_GO_SI_APN.esp
DA Sprint.esp
DAValeriaCuteElf.esp
Deadly Reflex Bow Sway.esp
Detect Life Shader [New].esp
DragonKnightArmor0.9.esp
Dread Knight Armor.esp
DropLitTorchOBSE.esp
DS Flaming Arrows.esp
Dungeon Actors Have Torches 1.6 CT.esp
DZ_Hide_Grass.esp

Egress.esp
ElsweyrAnequina.esp [Reports of ITM and UDR are all false positives. The mod is clean.]
Enhanced Economy.esp  [Version 5.1] Author: TheNiceOne
Enhanced Grabbing.esp
Enhanced Hotkeys.esp  [Version 2.1.1] Author: TheNiceOne
Enhanced Seasons.esp
Enhanced Vegetation xxx.esp
Enhanced Water v2.0 HD.esp
Enhanced Water v2.0 HD - SI Addon.esp
Enhanced Water v2.0 HDMI.esp
ES4_Alchemists Reference.esp
Ethereal - Eyes.esp
EVE_KhajiitFix.esp
EVE_KnightsoftheNine.esp
EVE_ShiveringIslesEasterEggs.esp
EY_BM_Armory.esp
Exterior Actors Have Torches 1.3 CT.esp

FastEquipping.esp  [Version 1.01]
FineWeapons for OOO.esp
FormID Finder4.esp
Fort Akatosh Redux.esp
Francesco's Optional Chance of More Enemies.esp  [SI version]
Francesco's Optional Chance of Stronger Bosses.esp  [SI version]
Francesco's Optional Leveled Guards.esp  [SI version]

Get Wet.esp
Get Wet - just droplets.esp
GGValeria2_0.esp
Ghost Rider Helmet.esp
GrimbotsSpellTomes.esp
Guards of Cyrodiil Redux.esp

Harvest [Flora] - DLCVileLair.esp
HeartOftheDead.esp  [Version 6.5]
Hemingweys Capes.esp
Higher Thieves' Guild Fence Amounts.esp
HUD Status Bars.esp  Author: TheNiceOne

icPlayerHome.esp  [no version number] Author: Stroti
Immersive Interiors.esp
Immersive Interiors - Lights.esp
ImmersiveWait.esp
ImpeREAL City Unique Districts – xxx (v2.8.0)
ImpeREAL Empire - Unique Castles (all plugins)
ImpeREAL Empire - Unique Castles - All the Castles -OCC.esp
ImpeREAL Empire - Unique Castles - All the Castles -OCR.esp
ImpeREAL Empire Unique Cities - Sutch.esp
ImpeREAL Empire - Unique Forts.esp
Imperial Furniture Renovated.esp

Kragenir's Death Quest.esp
KDCircletsOOOOptimized - Loot Only.esp
kuerteeCleanUp.esp
KvatchRankFix.esp
Kyoma's Journal Mod.esp

Lich King's Helm v1_0.esp
LoadingScreens.esp
LoadingScreensAddOn.esp
LoadingScreensSI.esp
Loths Blunt.esp (as of 3.0.1+)
Loth's Blunt Weapons for Npcs.esp  [Version 3.0.1]

Mage Equipment.esp
MaleBodyReplacerV4.esp
Map Marker Overhaul.esp  Author: TheNiceOne
Map Marker Overhaul - SI additions.esp  Author: TheNiceOne
MergedMaps.esp
MiniMap.esp
MIS New Sounds Optional Part.esp
MMM-Cobl.esp  [Version 1.73]
Moonshadow Elves - Sc.esp
Morrigan Armor Set v1_0.esp
Morrowind Robes and Dresses for HGEC.esp
Mystery of the Dulan Cult.esp (Better Cities replacer plugin)

Natural_Habitat_by_Max_Tael.esp
Nicos  Scimitars Back.esp
Night Knight Armor.esp
Nightshade_Armor.esp
NNWARE Rhyelia Emero.esp
No More Annoying Messages.esp

Oblivifall - Losing My Religion.esp [v1.4]
Oblivion XP.esp
OL_MyBrumaFireplace.esp
Old Crow Inn (as of version 1.5)
OOO 1.32-Cobl.esp  [Version 1.32]
Open Better Cities
OTEP - Aleswell.esp

P1DkeyChain.esp
Plate of the Shadow.esp
PowerAttack Voicemod.esp
PowerAttack Voicemod - The Shivering Isles.esp
ProgressMBSP.esp [v2.00]
ProgressSBSP.esp [v1.00]
ProgressRBSP.esp [v1.00]
ProgressRacial.esp [v1.00]
PTRoamingNPCs.esp

Quest Award Leveller and DLC patches
Quest Log Manager.esp

RealisticForcexxx.esp
RealisticMagicxxx.esp
Real Lava 1.3.esp
RealSleep.esp
ReneersNotesMod.esp
Reznod Mannequin.esp
RingwraithArmorSteel.esp
RustyItems for OOO.esp

Saerileth.esp
Script Effect Silencer.esp
Side's Sailing Ships.esp
Slof's Oblivion Robe Trader.esp
ShadowWatcher_HGEC_v2.esp
Shivering OOO.esp
SM_COBL.esp  [Version from Supreme Magicka 0.90b6 download]
SM_DeadlyReflex.esp  [Version from Supreme Magicka 0.90b6 download]
SM_DLCSpellTome.esp
SM_EnchantStaff.esp
SM_MMM.esp
SM_OOO.esp
SM_Scrolls.esp
SM_SigilStone.esp
SM_ShiveringIsles.esp  [Version from Supreme Magicka 0.90b6 download]
Smite of Order.esp
SPB Mercenary Armors.esp
Spell Delete.esp
StarX Vampire Deaths.esp
StarX Vanilla Vampires Revised.esp [Later versions have removed the NULL refs.]
StealthOverhaul.esp
StopDarkBrotherhood.esp
Sundered Keep.esp [v1.16]
SupremeMagicka.esp  [Version 0.90b6]
Syc_AtHomeAlchemy.esp
Symphony of Violence.esp

talkwithyourhands2.esp
Tamriel Resource Pack.esp
TamrielTravellerAdvscript.esp
TamrielTravellers Cosmetics Cobl or RBP.esp
TamrielTravellersItemsCobl.esp
TamrielTravellersItemsnpc.esp
The Blade of the Haunted
The Power Attack Voice Mod
Toaster Says Share Faction Recruitment.esp
Toggleable Quantity Prompt.esp
trfjBladeMasterSword.esp
trfjSolarisStaff.esp
trfjSpiderGreatsword.esp
TRN One of the Gang
Tyrael Armor.esp

UFF & RM Black Plate Armor.esp
Underworld Armor.esp
Unique Landscapes mods (all of them)
Unofficial Oblivion Patch.esp  [Version 3.3.3]
Unofficial Official Mods Patch (all plugins)
Unofficial Shivering Isles Patch.esp  [Version 1.4.0]
Update My Statue.esp

VanityCameraSmoother.esp
VASE - Cyrodiil for MMM.esp
VASE - Vanilla SI.esp
Viconia.esp
Villages1.1.esp [Version 1.1b is clean. Not recommended to use previous versions, which are still dirty.]
Visual Health Indication, Cobl.esp
VOILA.esp

Warglaives by Jojjo v1.0.esp
Weapon Expansion Pack for Oblivion Enthusiasts.esp 
Willful Resistance.esp
WindowLightingSystem.esp  [Version 5.3.5]

XiaNewAmuletsV1.esp
X.Races.Comp.esp

za_less_NPC_conversations.esp

Arthmoor's mods...such as...

Cyrodiil Travel Services
Faregyl Village
New Roads and Bridges Revised
Open Cities
Open Cities New Sheoth
RAEVWD Cities.esp
RAEVWD Imperial City.esp
RAEVWD New Sheoth.esp

Also note: since this is a wiki and anybody can edit it, the original author of this article cannot verify that the mods on the list are all truly clean. But most are, probably, maybe.

List of Mods You Should NOT Clean

There are a very small number of mods out there that contain "dirty edits" intentionally. One reason for this is to sort of do a preemptive strike to combat against truly "dirty" mods that might cause problems. There are other reasons too. The bottom line is do NOT clean the mods below.

ArmamentariumArtifacts.esp

Bashed Patch.esp
(NOTE: It is safe to run undeletes on this, but do not remove ITM records)

BG2408's mods (LAME, RBP, Integration)
EXCEPTION: bgIntegration.esp contains a single deleted reference, but do nothing beyond addressing that.

FCOM (None of the .esp/.esm files should be cleaned)

Mart's Monster Mod - City Defences.esp (author says to not clean)
Mart's Monster Mod - Gems & Gem Dust.esp (author says to not clean)
Mart's Monster Mod - Hunting & Crafting.esp (author says to not clean)

Oblivion WarCry EV.esp  [Version 1.09] (do not clean core FCOM mods)

Oscuro's_Oblivion_Overhaul.esm (do not clean core FCOM mods)
Oscuro's_Oblivion_Overhaul.esp (do not clean core FCOM mods)

Personality Idles - Modified version.esp (author confirmed that cleaning breaks functionality)

SM Plugin Refurbish (Battlehorn and ThievesDen, specifically, but this goes for all the plugins) 
[contains dirty dialogue edits that are intentional for mod functionality, do not clean]


SupremeMagicka.esp  [Version 0.90b6] (Do not clean beyond what the author cleaned already) 

Glossary

Vanilla Oblivion: This refers to the default Oblivion experience (settings, locations, items, ect) when running no mods at all.

Dirty/Unnecessary edit: This edit is caused either by accidental editing or CS bugs (unknown phantom edits). This edit is identical to vanilla Oblivion and is not part of a patch-type mod, and is therefore totally unnecessary. This edit can be empirical proven to be worthless. Automated cleaning will remove all dirty/unnecessary edits.

Wild/Undesirable edit: This edit alters the vanilla Oblivion environment, but the change is not consistent with the purpose and intent of the mod in question. This edit causes problems and is determined to be undesirable by making a judgment call based on comparing the mod creator’s purpose and intent to the actual mod edits. Automated cleaning will not remove this type of dirty edit. These edits require manual cleaning.

Explicit dependency: This is another .esm or .esp file that the mod in question lists as a master in its header. All you need to know for cleaning purposes is that TES4Edit will always load the explicit dependencies for you.

Implicit dependency: This is another .esm or .esp that the mod in question doesn’t list as a master in the header but nonetheless is required for the mod in question to do its job. You must know enough about the mod in question to know which mods it implicitly requires.

Simple .esp: An .esp that relies solely on Oblivion.esm and possibly a master. esm from the mod itself, which would be distributed with the mod itself and be obvious. A simple mod has only explicit dependencies, so TES4Edit will always load the necessary master files when loading the mod.

Complex .esp: An .esp that mods another mod and is meant to be used with one or more other mods. This can also be called a ‘patch’ mod. A complex has both explicit and implicit dependencies, so you MUST determine and load the implicit dependencies into TES4Edit.

Basic Complex .esp: An .esp that usually edits two other mods in a minor way. Landscape patch mods are the most common examples of this.

Advanced Complex .esp: To fit this category an .esp must attempt to patch many mods together in a very in-depth way. This would be FCOM. It is not recommended to clean FCOM not because it *can’t* be safely cleaned but because to safely clean it you need a LOT of knowledge about the inner workings of FCOM, and nobody but dev_akm is qualified here. Plus dev_akm cleans his stuff well enough already.

Do it right: Making sure you load all files that the mod you are cleaning relies upon (.esp or .esm) into TES4Edit in the correct load order, including both explicit dependencies and implicit dependencies. The file you are cleaning must always be the last one loaded. Never clean more than one plugin at a time. If you need to clean multiple files, you'll have to restart TES4Edit for each and every one of them.

Correct cleaning load order: The same load order that is correct for playing the game. The file you are cleaning must ALWAYS be the last file loaded in TES4Edit, and all other required files must be loaded in the same optimal order you use for playing.

Closing Remarks/Credits

You actually read all of this? +5 to OCD for you.

But seriously, none of this would be possible without ElminsterEU, who has put an enormous chunk of his personal spare time into the making of this wonderful program. All kudos should go to him. And if you are in position of doing so, don't forget to endorse the file at TESNexus.

Just so you know, I, Brumbek, wrote most of this guide, so any errors are mine most likely. You may contact me on the bethsoft forums if you have any input or other comments.

I also want to think all the other contributors to this, specifically Vorians, Arthmoor, dev_akm, and many others. I also want to thank all the little people I stepped on in order to become Master of the Universe.