Wrye Bash is a powerful mod management utility for TES IV: Oblivion and TES V: Skyrim. Its features include:
Wrye Bash can appear daunting at first. To help make it more manageable, the documentation has been split into a few readmes that are targeted towards different usage requirements.
A companion to the General Readme, this document details those features that were omitted from the aforementioned readme. These features are often more specialised, advanced or complicated, and many area geared more towards mod authors than mod users. This readme is also more technical and goes into more depth on how Wrye Bash functions. It assumes the reader has previously read the General Readme.
Note that the People and PM Archive tabs are hidden by default. You can toggle the visibility of the tabs in Wrye Bash's main tab bar by right-clicking the tab bar and checking or unchecking the options in the context menu displayed.
As a quick note that doesn't really belong anywhere else, Wrye Bash's title bar contains some useful information. The title is formatted as:
Wrye Bash [Bash Version] [Install Type] [Game Modifier], Cbash v[CBash Version]: [Save Profile] [Version Indicator]
The square bracketed information is:
[Bash Version]: This is the version number for the version of Wrye Bash running. Useful when troubleshooting.
[Install Type]: If the Python version is running, this will read
Python. If the Standalone version is running, it will read
(Standalone). See the Installation section for more information.
[Game Modifier]: If the option is selected in the Settings menu, this will display
for Skyrimdepending on the game it is being run for.
[CBash Version]: This is the version number for the version of CBash included with the Wrye Bash install. Useful when troubleshooting. See the Setting Up A Bashed Patch section for more information.
[Save Profile]: This is the name of the save profile Wrye Bash is currently using. By default it is
[Version Indicator]: This is only displayed when Wrye Bash is running for Oblivion. It indicates the version of Oblivion.esm currently being used. This is related to the Oblivion.esm Swapping feature.
Wrye Bash can be installed in any folder, but if it is installed outside of the game's folder, then the OblivionPath bash.ini option must be adjusted.
To do so:
Mopyfolder and save it as
Alternatively, you can launch Wrye Bash with the -o argument, quoting the path as the argument's parameter. Note that backslashes must be doubled as Python treats a single backslash as an escape character. For example,
"Wrye Bash Launcher.pyw" -o "C:\\Games\\Oblivion\\" if you are running Wrye Bash for Oblivion.
If you are installing the Python version of Wrye Bash and wish to install the Python dependencies separately, the following must be installed.
Note that the 32-bit versions are required even if you are on a 64-bit operating system.
The Installers tab is split into three main sections: on the left is the Package List, and the right is split between the Information Tabs at the top and the Comments field at the bottom. The Information Tabs and Comments sections display information specific to the currently selected package. Much of the contents of the Information Tabs depends on the install status and order of the package. The information tabs are detailed in the table below.
|General||Shows summary info and the files to be installed, as determined by sub-package, esp/m, voice filtering, etc.|
|Matched||Shows files which are identical to current Data directory files.|
|Missing||Files which are missing from the Data directory.|
|Mismatched||Files which are present in the data directory, but which aren't identical to the selected package's version of those files.|
|Conflicts||Shows which other packages will conflict the current package and for what files. Note that if a given file is mismatched, but the mismatch isn't due to other packages, then it won't appear. This report can be modified to show inactive conflicts and lower order conflicts by enabling the Show Inactive Conflicts and Show Lower Conflicts options respectively.|
|Underriden||Shows packages which should be overridden, but are not, due to install order errors. This can be corrected by running Anneal or Anneal All.|
|Dirty||Shows files which the selected package previously installed, but which now should be removed or altered due to a reconfiguration of the package. Dirty files can be cleared by running Anneal or Anneal All.|
|Skipped||Shows which files in the selected package were skipped by Bain.|
The Comments field is provided as an area in which notes may be kept on packages. It is useful for keeping track of what packages do, what your favourite install options are, etc.
BAIN skips the installation of some files and directories. The types of files skipped are:
Skippedpanel on the right.
Skippedpanel on the right.
Script Extender (OBSE, SKSE) plugins (.dll, .dlx extensions) may be installed through BAIN if the following conditions are met:
SKSE\Plugins(for Skyrim) or a subfolder of the same.
When attempting to install a specific Script Extender plugin for the first time, Wrye Bash will display a warning dialogue and ask you to confirm or deny the plugin's installation. Thereafter you can uninstall and install the plugin as you like without seeing the warning. These additional requirements are due to the significant (though currently theoretical) dangers of installing executable files.
The list of allowed and disallowed Script Extender plugins can be imported and exported using the Import list of allowed/disallowed OBSE plugin dlls and Export list of allowed/disallowed OBSE plugin dlls options in Wrye Bash's Settings menu.
If a mod author is building a mod that supports BAIN, manual and OMOD installs, they can use the Omod Info... option in the package context menu to create or update the OMOD config file.
If a mod author wishes to include a screenshot for use by the OMOD, they simply need to copy the screenshot saved as a JPEG to the OMOD Conversion Data folder and rename it to
screenshot with no file extension.
An OMOD installation script may also be created by creating a text file named
script.txt and writing the script in any text editor. Testing is still best done in OBMM though.
The OMOD config file is the only true requirement for an OMOD to be created from OMOD Conversion Data. The screenshot and installation script can be used to enhance an OMOD. Note that the
info.txt file that OMODs create when exporting Conversion Data in OBMM is unnecessary, and is provided for purely informational purposes.
BCFs are effectively automated archive converters, converting an existing archive or several archives into a new layout. They can be used to make BAIN-incompatible archives compatible, or make compatible archives easier to install. As they don't contain any files that are found in the existing archive(s), the only copyright/permissions that apply are those that the BCF creator stipulates, which generally makes distribution easier. BCFs are also usually much smaller, only containing new files that it adds (commonly
package.txt and ini file tweaks) and a
BCF.dat that tells Wrye Bash how to reorganise the archive(s).
To create a BCF:
[Game] Mods\Bash Installers\Bain Converters. It is recommended that you copy/paste the result log into your readme for your BCF.
Some points of interest regarding BCFs:
-BCF-*.7z(where the * is a wildcard matching any character string).
[Game] Mods\Bash Installers\Bain Converters\--Duplicates.
The tables below detail the full list of context menu commands available in the Installers tab.
|Column Header Context Menu|
|Sort By||Sort By Active||Active installers will be sorted to the top.|
|Projects First||If this is checked, then project packages will be sorted to the top of the list.|
|Package||Sort packages by package name.|
|Order||Sort packages by install order.|
|Modified||Sort packages by date modified.|
|Size||Sort packages by size.|
|Files||Sort packages by number of files they contain.|
|Columns||Package||Display the Package (name) column.|
|Order||Display the Order column.|
|Modified||Display the (date) Modified column.|
|Size||Display the Size column.|
|Files||Display the (number of) Files column.|
|Open...||Opens the Installers directory in Windows Explorer.|
|Refresh Data||Re-scans the Data directory and all project directories. This is done once per run of Wrye Bash, when the Installers tab is first opened. If you manually alter the directories after that, you should run this command to update BAIN to reflect the changes.|
|Full Refresh||This does a full refresh of all data files. Notably this will recalculate CRCs for all files (ordinarily CRCs are only calculated for files that seem to have changed). Running this command will likely take 5-15 minutes.|
|Add Marker...||Creates a marker for organising your packages. The |
==will be added for you.
|Create New Project...||Displays a dialog that allows you to create a new project and select some starting files for it.|
|Monitor External Installation...||When you absolutely cannot install a mod via BAIN, you can put BAIN into Monitor Mode using this command. It will scan the Data folder before and after you install the mod, then provide an option to create a Project from the changes it detects.|
|List Packages...||Displays a list of projects and archives and copies the list to your clipboard. This is useful for posting your package order on forums, eg. when troubleshooting an install.|
|Anneal All||Installs any missing files for active installers and corrects all install order errors.|
|Unhide...||Opens a dialogue window allowing you to select which hidden packages to unhide.|
|Uninstall All Packages||Uninstalls all the packages in the package list.|
|Clean Data||Removes files from the Data folder that are not from one of the following sources:
|Avoid At Startup||Toggles Bash to avoid the Installers tab on startup, thus avoiding unnecessary data scanning. Unless you're spending a lot of time in the Installers tab, you should enable this.|
|Enabled||This enables/disables Bain itself. Preferred setting: Enabled (checked).|
|Auto-Anneal||Toggles the auto-anneal process on/off. Preferred setting: enabled.|
|Auto-Anneal/Install Wizards||Toggles whether or not to automatically install/anneal a package when finished with its wizard.|
|Auto-Refresh Projects||Toggles the auto-refreshing of projects on/off. Preferred setting: enabled.|
|Skip BethSoft Content||Toggles whether or not refreshing the Data directory will also scan Bethsoft BSAs, ESPs, and ESMs. Disabling this option will cause a significant increase in refresh time if the timestamps on the Bethsoft BSAs are changed. However, enabling this setting is the only way to allow BAIN to install Vanilla ESPs, ESMs, and BSAs. Preferred setting: disabled.|
|Auto-Apply Embedded BCFs||If checked, archives that contain Bain Conversion Files will have them automatically applied when BAIN refreshes.|
|BSA Redirection||Uses Quarn's BSA redirection technique to avoid bugs with the engines texture getting system. This is compatible with both OBMM and Quarn's original BSA redirection approaches.|
|Clean Data Directory||If this is checked, then any empty subfolders of the Data directory will be deleted. This reduces some clutter (especially after uninstalling packages). Removing unused data directories also improves game performance.|
|Show Inactive Conflicts||If checked, then the conflicts report will show conflicts with inactive as well as active mods. Usually only active conflicts are of interest, however sometimes it's useful to review all conflicting packages.|
|Show Lower Conflicts||If checked, then the conflicts report with show conflicts with lower order packages. If you're only interested in higher order conflicts, the uncheck this to remove some clutter from the report.|
|Show BSA Conflicts||If checked, the contents of BSAs are compared and any conflicting resources found are displayed in the conflicts list.|
|Wizard Icon Overlay||If checked, installers with a Wizard will have a magic wand image displayed over their icons.|
|Skip OBSE Plugins||Oblivion only. If this is checked, files to go in the Data\OBSE\Plugins folder will not be installed.|
|Skip SKSE/Script Dragon Plugins||Skyrim only. If this is checked, files to go in the Data\SKSE\Plugins or Data\asi folder will not be installed.|
|Skip Screenshots||If checked, then files from a Data\Screenshots directory will be skipped.|
|Skip Images||If checked, image files will be skipped.|
|Skip Docs||If checked, document files will be skipped vice being swept to the Docs\ directory.|
|Skip DistantLOD||If checked, then DistantLOD files in packages will be ignored. Useful if you're using Tes4LodGen to generate DistantLOD files.|
|Skip LOD Meshes||If checked, landscape LOD meshes will be skipped.|
|Skip LOD Textures||If checked, landscape LOD textures will be skipped.|
|Skip LOD Normals||If checked, landscape LOD normals will be skipped.|
|Auto-name String Translation Files||Skyrim only. If checked, string translation files will be renamed so that they are loaded for the language Skyrim is currently run for, unless there are existing translation files for that language.|
|Package Context Menu|
|Open...||Opens the selected package(s) in the file system.|
|Duplicate...||Makes a duplicate of the selected package(s).|
|Delete||Deletes the selected package(s). Deleted packages are not sent to the Recycling Bin, they are permanently deleted.|
|Open at||Google...||Attempts to perform a Google search for the selected package's name.|
|TES Nexus...||Attempts to open the selected package's page on TES Nexus. This command assumes that the trailing digits in a package's name is the package ID at the site.|
|Skyrim Nexus...||Attempts to open the selected package's page on Skyrim Nexus. This command assumes that the trailing digits in a package's name is the package ID at the site.|
|TES Alliance...||Attempts to open the selected package's page on TES Alliance. This command assumes that the trailing digits in a package's name is the package ID at the site.|
|Planet Elderscrolls...||Attempts to open the selected package's page on Planet Elderscrolls. This command assumes that the trailing digits in a package's name is the package ID at the site.|
|Hide...||Hides the package in the list, and moves it to the |
|Rename...||Renames the selected package or marker.|
|Refresh||Refreshes all info for the selected package(s). Since BAIN refreshes package information whenever Wrye Bash regains focus after losing it (ie. you select another program's window, then switch back to Wrye Bash), this is only useful if a package has been changed and it has Don't Refresh selected, or the Auto-Refresh Projects option is disabled. Note that scanning a project for changes takes much longer than scanning an archive for changes.|
|Move To...||Moves the selected package(s) to the specified position.|
|Has Extra Directories||BAIN only recognises a limited set of subdirectories of the Data folder, and skips any unrecognised subdirectories. Checking this option will cause BAIN to install unrecognised subdirectories.|
|Override Skips||If this is checked, Bain will not skip over files that would normally be skipped due to the Skip XX options.|
|Skip Voices||If this is checked, Bain will skip over any voice files in the package. This is useful if the voice files are empty and/or the user prefers not to use them. If this option is used, then the user should also use Elys' Universal Silent Voice extension to prevent dialog subtitles from fading too rapidly.|
|Don't Refresh||When refreshing Projects, this package won't get refreshed. The package will only get refreshed on a Full Refresh, or by manually selecting Refresh.|
|Wizard||Runs the Wizard for the package, if it has one.|
|Auto Wizard||Runs the Wizard for the package, if it has one, selecting the default options.|
|View Wizard...||Opens the wizard.txt for viewing.|
|Open Readme||If BAIN detects a readme in the selected package, it will be opened.|
|Anneal||Installs missing files and corrects install order errors.|
|Install||Fully installs the package except for files that would be overriden by later packages.|
|Install Last||Moves the package to the end of the order list and installs it.|
|Install Missing||The same as Install, except that it only installs missing files – i.e. it will not override any currently existing files.|
|Uninstall||Uninstalls the package. If Auto-Anneal is active (the default) then files from earlier packages that were previously overriden will be installed as required.|
|Conversions||Create...||Archives only. Creates a new Bain Conversion File.|
|Apply->[BCF]||[BCF] is the name of a Bain Conversion File listed in the Apply submenu. Selecting a BCF applies it to the selected package.|
|Unpack To Project(s)...||Archives only. Unpack the archive to a project.|
|Pack to Archive...||Projects only. Packs the project to an archive. It defaults to .7z, but also supports .zip.|
|Package For Release...||Projects only. Just like "Pack to Archive" except it doesn't archive the following: thumbs.db, desktop.ini, and any folder that begins with "--".|
|Sync From Data||Projects only. Synchronize the project with files from the Data directory. This is essentially the reverse of "Install" for projects since it copies from the Data directory to the project rather than the other way around.|
|Copy Conflicts to Project||Copies all files that conflict with the selected package into a new project. Useful for comparing conflicting resources.|
|Omod Info...||Projects only. Allows you to read/write omod configuration info.|
|List Structure...||Generates a list of the files and directories in a package. Useful for posting package structure on forums, eg. when troubleshooting an install.|
|Sub-Package Context Menu|
|Select All||Selects all the sub-packages in the list.|
|Deselect All||Deselects all the sub-packages in the list.|
|Toggle Selection||Deselects currently selected sub-packages, and selects currently deselected subpackages.|
|List Sub-packages||Generates a forum-formatted list of sub-packages in the package, highlighting checked packages with |
|Esp/m Filter Context Menu|
|Select All||Selects all the plugins in the Filter list.|
|Deselect All||Deselects all the plugins in the Filter list.|
|List Esp/ms||Generates a forum-formatted list of plugins in the Filter list, highlighting checked plugins with |
|Rename...||Rename the selected plugin. Renamed plugins are displayed in the Filter list with a |
|Reset Name||Resets the selected plugin's name to its default name.|
|Reset All Names||Resets all renamed plugins to their default names.|
Exclusion groups can be used to help flag plugins that are incompatible. Incompatible plugins can be placed into exclusion groups, and when more than one plugin in a group is present, the plugins will be highlighted in orange.
An exlusion group may be defined or added to by renaming a plugin, putting the exclusion group name first, then a comma, then the plugin's original name. Eg.
Group, My plugin.esp. If plugins share the same exclusion group name, they will be members of the same exclusion group.
Note: The usage of exclusion groups is not recommended. Renaming plugins will cause them to become unrecognised by features such as BAIN or utilities such as BOSS that expect plugins to have the names they are distributed with. Renaming plugins will also break any plugins that are dependent on them.
The plugin details panel contains the following:
|File Name||The filename of the selected plugin. Note that changing this does not change the filename in the Masters Lists of any dependent plugins.|
|Modification Time||For Oblivion, this affects the load order of the selected plugin. For Skyrim, it has no effect, except that if it is changed for a plugin obtained from Steam Workshop, it will cause the plugin to be redownloaded as Steam Workshop uses modification time to detect file versions.|
|Author||Who made the selected plugin.|
|Description||Commonly used for a short description of what the selected plugin does, plus the version number and any Bash Tags the author sets.|
|Masters List||The plugins (.esm or .esp) that the selected plugin depends on, and their indices (positions in load order). Plugins' entries in the Masters List may be renamed to reflect name changes of the plugins themselves. Renaming can be done by left-clicking the plugin entry and editing in the column display, or right-clicking the plugin and selecting |
Change To...then selecting the replacement plugin. Do not use this to change a plugin's masters to unrelated plugins, as this will cause file corruption.
|Bash Tags||This field lists any Bash Tags that are assigned to the selected plugin. Right-clicking will display a list of Bash Tags and allow you to add or remove tags by checking or unchecking them.|
Wrye Bash uses CSV files for many of its plugin data related features. CSV files are a very widely supported type of spreadsheet file, and once exported may be edited in programs like Microsoft Excel, LibreOffice Calc or even in text editors such as Notepad or Notepad++.
CSV files are used by the Import/Export... commands as this allows much easier editing of record data in large batches or in systematic manners than in the Construction Set. The data may be exported, edited in the CSV, then imported again. The following notes apply to CSV files.
0x, so such lines can be used for comments.
Nonethen all the script effects for that effect will be ignored.
CSV files can also be used when building the Bashed Patch, for a number of options. The Bashed Patch builder will automatically detect the presence of any CSV files in the
Data\Bash Patches folder and have the correct filename ending. These filename endings are:
|Import Type||Required Filename Ending|
|Replace Form IDs||Formids.csv|
|Import Spell Stats||Spells.csv|
The tables below detail the full list of context menu commands available in the Mods tab.
|Column Header Context Menu|
|Load||All||Activates all the plugins in the mod list.|
|None||Deactivates all the plugins in the mod list.|
|Save List...||Saves the current load order to a new load list.|
|Edit Lists...||Allows the deletion and renaming of load lists.|
|[Load List]||[Load List] is the name of a load list, which are listed below the separator in the Load submenu. Clicking a load list will apply it, deactivating any plugins that are not listed as active in it.|
|Sort By||This submenu allows you to choose by which column the plugin list is sorted. This is equivalent to clicking on a column header. You can also choose to sort by |
Type, which will place .esms before .esps regardless of the sorting criteria, or by
Selection, which places selected plugins before unselected plugins regardless of criteria.
|Oblivion.esm||Oblivion only. This submenu relates to Oblivion.esm Swapping.|
|Columns||This submenu allows you to choose which columns are visible in the mod list.|
|File||New Bashed Patch...||Creates a new Bashed Patch plugin. Useful if you accidently delete your current one or wish to have more than one.|
|New Mod...||Creates an empty plugin.|
|Open...||Opens the Data folder in Windows Explorer.|
|Unhide...||Opens a dialogue window allowing you to select which hidden plugins to unhide.|
|List Mods||This outputs a BBCode-formatted load order, including version information, activation status and major load order errors. It can be useful for debugging a broken load order. If the 'c' keyboard key is pressed when this command is selected, the CRCs of plugins will also be displayed in the output.|
|List Bash Tags||This outputs a BBCode-formatted list of all the Bash Tags applied to the plugins in your load order, and where/how the Bash Tags were specified. It can be useful for debugging a broken load order.|
|Auto-Ghost||The game engine has a bug where it reads all the plugins in the Data folder, and this can affect performance when the number of plugins is around 300+. Auto-Ghosting adds a |
.ghostextension to all inactive plugins automatically to prevent the game engine reading them, and so helping to avoid the performance drop. When a ghosted plugin is activated, the
.ghostextension is removed, allowing it to function as normal. Note that other utilities will not recognise ghosted plugins, so there are options available for individual plugins to control which get ghosted.
|Lock Load Order||Oblivion only. This prevents other utilities from altering plugin modification times. More accurately, it detects changes to modification times when Wrye Bash is focussed (ie. on top of all other program windows) and reverses those changes.|
|Debug Mode||Activates debug output. Only a few commands will display any debug output, but it may be useful for troubleshooting.|
|TES4Edit Expert||If checked, this option runs TES4Edit with the |
|Remove Dummy Masters...||Removes all dummy master files created using Create Dummy Masters... on a plugin.|
|Check mods against BOSS's dirty mod list||BOSS's masterlist contains information on dirty plugins that can be used by Wrye Bash to highlight these plugins in the mod list. Checking this setting tells Wrye Bash to use this information if BOSS is installed.|
|Plugin Context Menu|
|File||Create Dummy Masters...||Creates an empty plugin for each missing master a mod has. This is useful for allowing TES4Edit to open a 'Filter' patch without having all of the required masters. These dummy plugins can later be removed using the Remove Dummy Masters command.|
|Backup||Creates a backup of the selected plugin in |
|Duplicate...||Creates a duplicate of the selected plugin in the Data folder.|
|Snapshot...||Creates a snapshot copy of the selected plugin in |
|Delete||Permanently deletes the selected plugin, and any backups of it, but not snapshots.|
|Hide||Moves the selected plugin to the |
|Redate...||Change the modification time of the selected plugin. If more than one plugin is selected, then all the plugins will have their modification times altered, with the first in the list being set to the specified time and the rest at one minute intervals from that time.|
|Sort||Set the load order of the selected plugins, sorting them alphabetically.|
|Revert To Backup||Reverts the selected plugin to the last backup made of it.|
|Revert To First Backup||Reverts the selected plugin to the first backup made of it.|
|Revert To Snapshot...||Reverts the selected plugin to a selected snapshot.|
|Group||Set a group for the selected plugin(s). This group is not an Exlusion Group, but is instead a leftover from a feature known as BALO that has been disabled, as it was superceded by BOSS. Some references to these groups still remain, but they provide no functionality other than to place hidden plugins in group folders provided those folders already exist.|
|Rating||A purely cosmetic feature, this allows you to assign different rating values to plugins.|
|Details...||Displays a list of the records in the selected plugin, similar to the Details view in the Construction Set.|
|List Masters...||Outputs a list of the selected plugin's masters.|
|Readme...||Attempts to open the selected plugin's associated readme in the Doc Browser.|
|List Bash Tags...||Outputs a BBCode-formatted list of all the Bash Tags applied to the selected plugin, and where/how the Bash Tags was specified. It can be useful for debugging a broken load order.|
|Create BOSS Report...||Outputs the plugin filename, CRC, and ITM/UDR count for easy reporting of the plugin to an official BOSS thread.|
|Copy Mod Info...||Outputs a report on the selected plugins(s) with the info from the currently displayed columns.|
|Don't Ghost||Displayed if a single plugin is selected. Don't ghost this plugin when it is inactive, even if Auto-Ghost is enabled.|
|Ghost||Displayed if a single plugin is selected. Ghost this plugin when it is inactive even if Auto-Ghost is disabled.|
|Ghosting||Allow Ghosting||Displayed if multiple plugins are selected. Unchecks Don't Ghost for the selected plugins.|
|Disallow Ghosting||Displayed if multiple plugins are selected. Checks Don't Ghost for the selected plugins.|
|Invert Ghosting||Displayed if multiple plugins are selected. Toggles the status of Don't Ghost for the selected plugins.|
|Mark Mergeable...||Scans the selected plugin(s) to determine if they are mergeable or not. Wrye Bash does this automatically, but this command reports why mods are unmergeable.|
|Mark Mergeable (CBash)...||Oblivion only. Does the same thing as Mark Mergeable..., but uses CBash to scan the plugins. A Bashed Patch built using CBash can merge more plugins, so the results between the two Mark Mergeable commands will differ.|
|Rebuild Patch...||Rebuild the selected Bashed Patch using the Python patcher.|
|Rebuild Patch (CBash *Beta*)...||Oblivion only. Rebuild the selected Bashed Patch using the CBash patcher.|
|List Patch Config...||Displays a summary of how the selected Bashed Patch is configured.|
|Export Patch Config...||Exports the configuration of the selected Bashed Patch to a file.|
|Export||Cell Block Info...||Oblivion only. Exports a list of cell block Editor IDs and their coordinates in the selected plugin to a CSV file.|
|Editor Ids...||For advanced mod authors only. Exports the Editor IDs of the records in the selected plugin to a CSV file.|
|Groups...||Exports the selected plugin's groups to a CSV file.|
|Factions...||For advanced mod authors only. Exports the factions defined for actors in the selected plugin to a CSV file, which can be imported to a plugin or used in the Bashed Patch's Import Factions option.|
|Names...||Exports the names of the objects in the selected plugin to a CSV file. All the records displayed in the Construction Set's Objects Window are supported - cells and dialogue are not. As well as being useful for the usual large-scale changes, this command is useful for translators. The CSV file can also be used in the Bashed Patch's Import Names option.|
|NPC Levels...||For advanced mod authors only. Exports NPC level info from the selected plugin to a CSV file. Only NPCs which are dynamically levelled (ie. offset from the player's level) will be exported.|
|Map Markers...||Oblivion only. Exports information about the map marker data in the plugin.|
|Prices...||Exports the prices of objects in the selected plugin to a CSV file.|
|Relations...||For advanced mod authors only. Exports the faction relationships in the selected plugin to a CSV file. This does not export race relationships. The CSV file can also be used in the Bashed Patch's Import Relations option.|
|Ingredients...||Exports alchemy ingredient record data from the selected plugin to a CSV file.|
|Scripts...||Exports the scripts in the selected plugin to a series of text files. The scripts may then be edited in the text files and re-imported. Warning: Do not change the first three lines of each text file exported when editing unless you know what you're doing.|
|Sigil Stones...||Exports the stats of sigil stones from the selected plugin to a CSV file.|
|Spells...||Exports spell stats in the selected plugin to a CSV file. The CSV file can also be used in the Bashed Patch's Import Stats option. There are two modes of export, Basic and Detailed. The spell stats exported in Basic mode are as follows.
|Stats...||Exports stats for the following record types in the selected plugin to a CSV file. The CSV file can also be used in the Bashed Patch's Import Stats option.
|Import||Editor Ids...||For advanced mod authors only. Imports the Editor IDs for records in the selected plugin from a CSV file. As well as updating the Editor IDs of records themselves, this also updates any Editor IDs referenced in normal (non quest stage or dialogue) scripts to reflect the changes. Note: You may have to recompile any altered scripts in the Construction Set.
If you wish to update script references after the Editor IDs were changed, edit the CSV file and add another column after the eid column and give the old Editor IDs in the new column. E.g.
|Groups...||Imports groups for the selected plugin from a CSV file as created by the Export Groups command.|
|Factions...||For advanced mod authors only. Applies to the selected plugin the factions defined for actors in a CSV file previously exported using Wrye Bash.|
|Names...||Imports names for objects from a CSV file into the selected plugin. Only records that already exist in the plugin will have their names changed, no records will be added.|
|NPC Levels...||For advanced mod authors only. Imports NPC level info from a CSV file into the selected plugin. This does not affect Creature levels or leveled lists, nor does it affect the levels of NPCs in existing saves, for which Update NPC Levels must be used. As well as the format exported by Export NPC Levels, an older format is supported:
|Map Markers...||Oblivion only. Imports map marker data from a CSV file into the selected plugin.|
|Prices...||Imports the prices of objects from a CSV file into the selected plugin.|
|Relations...||For advanced mod authors only. Imports faction relationships from a CSV file into the selected plugin.|
|Ingredients...||Imports alchemy ingredient record data from a CSV file into the selected plugin.|
|Scripts...||Imports scripts from a series of text files into the selected plugin. Note: You must recompile any altered or new scripts in the Construction Set.|
|Sigil Stones...||Imports the stats of sigil stones from a CSV file into the selected plugin.|
|Spells...||Imports spell stats from a CSV file into the selected plugin. Only records that exist in the plugin will have their spell stats change, no records will be added. The spell stats supported are those exported by Export Spell Stats..., and importing uses the same Basic and Detailed mode distinctions.|
|Stats...||Imports stats from a CSV file into the selected plugin. Only records that exist in the plugin will have their stats change, no records will be added. The object stats supported are those exported by Export Stats....|
|Face...||This command relates to Face Importing.|
|FormIDs...||For advanced mod authors only. It is useful if you want to replace the records in one master with equivalent records in another master. This command replaces the Form IDs in a plugin according to a CSV file that acts as a Form ID mapper. An example of such a file is |
If you've completely swapped from one base plugin to another, you may wish to remove the old dependency. This can be done using TES4Edit's
Note: You can also use TES4Edit to change the Form IDs using its
|Mod Cleaning||Don't check against BOSS's dirty mod list||Overrides the setting in the column header context menu for the specific plugin(s) selected.|
|Scan for Dirty Edits||Oblivion only. Scans the selected plugin for Identical To Master records and deleted references, outputting counts of the dirty edits found. The dirty edit counts may differ from the output provided by TES4Edit as that includes other "junk" records in the ITM count. Wrye Bash does not count these junk records as they are non-harmful.|
|Scan for UDR||Skyrim only. Behaves as the above Scan for Dirty Edits, but only for deleted references.|
|Remove World Orphans||Some plugins have a mild form of corruption where exterior cells of new worldspaces in an esp master of the plugin are included in the plugin even if they are not edited, but the parent worldspace is not included, creating "orphaned" cells. This command removes these "orphans".|
|Nvidia Fog Fix||Systems with Nvidia graphics cards can suffer a black screen bug when interior cell fog distances are set to 0. This command scans the selected plugin(s) and sets any zero-valued fog distances to 0.001. It is advised that mod authors use this on their mods before release.|
|Undelete Refs||This is an experimental feature for advanced mod authors. If you're trying to undelete references, you should probably use TES4Edit instead. Deleted references can cause crashes. This command undeletes references and disables them instead. However, the undeleted reference does not contain the missing data caused by deletion. TES4Edit can add this data back in.|
|Add Master...||Add a master to the list of masters for the selected plugin. Warning: For advanced mod authors only. You should only use this if you know exactly what you're doing.|
|Copy To Esm/Esp||Creates a .esp copy of a .esm or vice versa.|
|Decompile All||Undoes the effect of a |
Compile Allperformed in the Construction Set. It will not do anything to the game's master file.
|Esmify/Espify Self||The distinction between esp and esm plugins is not dependent on their file extensions, but by a bit in the file. This command toggles that bit so that .esp files behave as .esm files and vice versa. It is useful for creating and editing plugins with .esp files as masters, which cannot be done in the Construction Set otherwise. Esm files cannot be edited in the Construction Set as esp files, so this command is disabled for them. Warning: Make sure to toggle any plugins back before playing the game, otherwise savegames will get confused, possibly causing bugs and corruption.|
|Esmify/Espify Masters||This works as Esmify/Espify Self does, but toggles a plugin's masters rather than the plugin itself.|
|Version 0.8||Resets the file version number of the selected plugin so that it can be edited in an older version of the Construction Set, which is required when making certain changes due to bugs in the latest Construction Set. Warning: It is possible that this may cause data loss.|
You can have multiple Bashed Patches, though one is generally enough per save profile or character. The only requirement for Wrye Bash recognising a plugin as a Bashed Patch is that its
Author field is set to
BASHED PATCH, so you can name a Bashed Patch whatever you want.
As the Bashed Patch commonly has .esp files as masters, viewing and editing it can be more complicated than for the average plugin. If you wish to view its contents, it is easiest to use TES4Edit, which can also be used to edit most types of data in plugins. To edit it using the Construction Set or Creation Kit (required when editing scripts), you'll need to first use the Esmify Masters command on it. Be sure to use
Espify Masters before attempting to play the game.
Wrye Bash uses a tagging system to determine what mods can and should have which records available for importing into the Bashed Patch. These Bash Tags are specified by mod authors in the header descriptions of their plugins, or are applied using data from three sources:
Bash Patches\Leveled Lists.csvfile. This file contains a small list that is useful if BOSS is not installed.
Bash Patches\taglist.txtfile. This is a stripped-down version of the BOSS masterlist as it was when the version of Wrye Bash installed was released.
Bash Tags may also be set manually, by right-clicking a plugin's Bash Tags field in the Mods Tab sidebar and checking or unchecking tags in the list displayed. If you wish to revert to automatic tagging, choose
Automatic in the right-click list. If you are a mod author, you may wish to use
Copy to Description for your mod's plugins before releasing it to ensure that users have the tags applied automatically.
Note: A Bash Tag should only be applied when it is important that the plugin's change to whatever the Tag relates to is preserved. If a change your plugin makes is not important to the functioning of your mod, do not add a Bash Tag for it. Doing otherwise negates the purpose of the Bash Tag system.
|Bash Tags Available For All Games|
|Tag||Used When The Mod||Specific Record Types/Changes Supported|
|Deactivate||Should be deactivated.||N/A|
|Delev||Deletes entries from Leveled Lists.||Removal of entries from the leveled list entries of Leveled Creature (LVLC) (Oblivion only), Leveled Actor (LVLI) (Skyrim only), Leveled Item (LVLI) or Leveled Spell (LVSP) records.|
|Filter||Does not require all its masters to be installed to function. See the Merge Filtering section for more information.||N/A|
|NoMerge||Should not be merged even though it is technically mergeable.||N/A|
|Relev||Relevels items in Leveled Lists.||Re-levelling of entries from the leveled list entries of Leveled Creature (LVLC) (Oblivion only), Leveled Actor (LVLI) (Skyrim only), Leveled Item (LVLI) or Leveled Spell (LVSP) records.|
|Bash Tags Available For Oblivion Only|
|Tag||Used When The Mod||Specific Record Types/Changes Supported|
|Actors.ACBS||Modifies creature or NPC ACBS configuration.||The following NPC (NPC_) or Creature (CREA) subrecords:
|Actors.AIData||Modifies creature or NPC AI data.||The following NPC (NPC_) or Creature (CREA) subrecords:
|Actors.AIPackages||Modifies creature or NPC AI packages list.||Addition or removal of AI Packages in NPC (NPC_) or Creature (CREA) records.|
|Actors.AIPackagesForceAdd||Adds to creature or NPC AI package list. This tag forces the addition of packages even if they are removed by later-loading plugins tagged with Actors.AIPackages.||Addition of AI Packages in NPC (NPC_) or Creature (CREA) records.|
|Actors.Animations||Modifies creature or NPC special animations lists.||The Animations (KFFZ) subrecord in NPC (NPC_) or Creature (CREA) records.|
|Actors.CombatStyle||Modifies creature or NPC assigned combat styles.||The Combat Style (ZNAM) subrecord in NPC (NPC_) or Creature (CREA) records.|
|Actors.DeathItem||Modifies creature or NPC death items.||The Death Items (INAM) subrecord in NPC (NPC_) or Creature (CREA) records.|
|Actors.Skeleton||Modifies creature or NPC skeletons.||The following NPC (NPC_) or Creature (CREA) subrecords:
|Actors.Spells||Modifies creature or NPC spell lists.||Addition or removal of spells in NPC (NPC_) or Creature (CREA) records.|
|Actors.SpellsForceAdd||Modifies creature or NPC spell lists. This tag forces the addition of spells even if they are removed by other plugins tagged with Actors.Spells.||Addition of spells in NPC (NPC_) or Creature (CREA) records.|
|Actors.Stats||Modifies creature or NPC stats.||The following NPC (NPC_) or Creature (CREA) subrecords:
|Body-F||Modifies female body mesh/texture definitions.||The following Race (RACE) subrecords:
|Body-M||Modifies male body mesh/texture definitions.||The following Race (RACE) subrecords:
|Body-Size-F||Modifies female body weight/height definitions.||The following Race (RACE) subrecords:
|Body-Size-M||Modifies male body weight/height definitions.||The following Race (RACE) subrecords:
|C.Climate||Modifies cell climates.||The following Cell (CELL) subrecords:
|C.Light||Modifies cell lighting or fog.||The following Cell (CELL) subrecords:
|C.Music||Modifies cell music type.||The Music (XCMT) subrecord in Cell (CELL) records.|
|C.Name||Modifies cell names.||The Name (FULL) subrecord in Cell (CELL) records.|
|C.Owner||Modifies cell ownership.||The following Cell (CELL) subrecords:
|C.RecordFlags||Modifies the off-limits or dangerous flags.||Any Cell (CELL) record flags not covered by the other Cell-related Bash Tags.|
|C.Water||Modifies cell water type or level.||The following Cell (CELL) subrecords:
|Creatures.Blood||Modifies the creature blood subrecords.||The following Creature (CREA) subrecords:
|Eyes||Adds eyes to races.||The Eyes (ENAM) subrecord of Race (RACE) records.|
|Factions||Changes creature or NPC factions.||Addition or removal of a faction, or change of faction rank in NPC (NPC_) or Creature (CREA) records.|
|Graphics||Is a graphics replacer.||The following subrecords:
|Hair||Adds hairs to races.||The Hairs (HNAM) subrecord of Race (RACE) records.|
|IIM||Is to be used in Item Interchange Mode. See the Item Interchange Mode section for more information.||N/A|
|Invent||Changes inventories.||Addition, removal or change in count/number of an item in NPC (NPC_), Creature (CREA) or Container (CONT) records.|
|InventOnly||Deprecated. Use Invent in conjunction with IIM instead.||N/A|
|Merge||Obsolete. This tag is ignored.||N/A|
|MustBeActiveIfImported||Must be active to function correctly even if it is imported into the Bashed Patch.||N/A|
|Names||Changes the names of things.||The Name (FULL) subrecord in the following record types:
|NpcFaces||Modifies NPC faces.||The following NPC (NPC_) subrecords:
|NpcFacesForceFullImport||Modifies NPC faces, and you wish to import the unmodified subrecords as well as the modified subrecords.||See NpcFaces for the list of supported subrecords.|
|NPC.Class||Changes the classes of NPCs.||The Class (CNAM) subrecord of NPC (NPC_) records.|
|Npc.EyesOnly||Modifies NPC eyes.||The Eyes (ENAM) subrecord of NPC (NPC_) records.|
|Npc.HairOnly||Modifies NPC hair.||The Hair (HNAM) subrecord of NPC (NPC_) records.|
|NPC.Race||Modifies NPC races.||The Race (RNAM) subrecord of NPC (NPC_) records.|
|Relations||Changes faction relationships.||The relations of Faction (FACT) records.|
|Roads||Modifies road records.||The Road (ROAD) subrecord of Worldspace (WRLD) records.|
|R.AddSpells||Adds spells to racial spell list(s). Either R.ChangeSpells or R.AddSpells should be used for a plugin, not both.||Additions to the spell list of Race (RACE) records.|
|R.Attributes-F||Modifies racial attributes for females.||The following Race (RACE) subrecords (ATTR):
|R.Attributes-M||Modifies racial attributes for males.||The following Race (RACE) subrecords (ATTR):
|R.ChangeSpells||Modifies racial spell list(s) (beyond adding spells). Either R.ChangeSpells or R.AddSpells should be used for a plugin, not both.||Additions or removals to the spell list (SPLO) of Race (RACE) records.|
|R.Description||Modifies race descriptions.||The Description (DESC) subrecord of Race (RACE) records.|
|R.Ears||Modifies race ears.||The following Race (RACE) subrecords:
|R.Head||Modifies race heads.||The following Race (RACE) subrecords:
|R.Mouth||Modifies race mouths.||The following Race (RACE) subrecords:
|R.Relations||Modifies race relationships.||The faction list (XNAM) of Race (RACE) records.|
|R.Skills||Modifies race skill bonuses.||The skill boosts (DATA) of Race (RACE) records.|
|R.Teeth||Modifies race upper or lower teeth.||The following Race (RACE) subrecords:
|ScriptContents||Should not be used. Can cause serious issues.||N/A|
|Scripts||Modifies item, NPC or object scripts.||The Script (SCRI) subrecord in the following record types:
|Sound||Replaces sounds.||The following subrecords:
|SpellStats||Modifies spell stats.||The following Spell (SPEL) subrecords:
|Stats||Modifies item stats.||The following subrecords:
|Voice-F||Modifies female voice definitions.||The male voice (VNAM) of Race (RACE) records.|
|Voice-M||Modifies male voice definitions.||The female voice (VNAM) of Race (RACE) records.|
|Bash Tags Available For Skyrim Only|
|Tag||Used When The Mod||Specific Record Types/Changes Supported|
Merge filtering is an advanced option that allows records in a merged mod to be selectively filtered according to the current load order. For example, a patch mod could be created to rebalance weapons from several different weapon-adding mods. This feature would allow the patch to be used even if you didn't use all the mods, and the Bashed Patch would just apply the bits for the mods you do use. This saves the need for a separate patch plugin for each mod.
Merge filtering has requisite conditions that must be fulfilled for a plugin to take advantage of it, and some limitations. These conditions and limitations are:
Item Interchange Mode is a 'hack' (a horribly inelegant and inconsistent implementation of a feature that nonetheless works) to support Vacuity's Item Interchange mod.
Activation of the mode for a plugin relies on the following conditions:
Item Interchange Mode has the following effects:
Tweak... section has a table below that details the options found within it.
|Bigger Nords and Orcs||Adjusts the Orc and Nord race records (including mod added races named Orc/Nord) to be taller/heavier - to be more lore friendly. Three choices available - MMM settings, RBP settings or standalone Bigger Nords and Orcs settings.|
|Merge Eyes From Similar Races||Merges eye lists from similar races ie RBP Khajiit eyes to Elsweyr Khajiits etc.|
|Merge Hairs From Similar Races||Merges hair lists from similar races ie RBP Khajiit hair to Elsweyr Khajiits etc.|
|Playable Eyes||Sets all eyes to be playable.|
|Playable Hairs||Sets all hairs to be playable.|
|Races Have All Eyes||Gives all races all eyes - although Googly Eye scanning/removal takes place after this so the final patch will not have all eyes for all races.|
|Races Have All Hairs||Gives all races all hairs.|
|Sexless Hairs||Sets all hairs to be useable by both male and female characters.|
|As Intended: Boars||Adds the Bethesda Boar Resistances spells to all boars (found by the UOP team, based off of a mod made by Tejon).|
|As Intended: Imps||Adds the Bethesda Imp Resistances spells to imps (found by the UOP team, based off of a mod made by Tejon). May choose to apply to all imps, only full size imps, or only implings.|
|Irresponsible Creatures||Sets responsibility to 0 for all/specified creatures - so they can't report you for crimes.|
|Mayu's Animation Overhaul Skeleton Tweaker||Sets NPC skeletons paths to match that required for MAO to work. Requires Mayu's Animation Overhaul or it will almost certainly cause CTDs.|
|No Bloody Creatures||Nulls the blood records of all creatures; acts like 'Mart's Monster Mod - No Blood.esp' except it is universal and doesn't work with MMM (MMM uses a different system - it won't cause any harm if used with MMM, it will just have pretty much no effect).|
|Quiet Feet||Removes all/some 'foot' sounds from creatures; on some computers can have a significant performance boost.|
|Real Walk for female NPCs||Changes all female NPCs to use Mur Zuk's Real Walk. Requires Mur Zuk's Real Walk animation file.|
|Redguard FGTS Nuller||Sets Redguard NPC FGTS subrecords to null; for use with Better Redguards.|
|Sexy Walk for female NPCs||Changes all female NPCs to use Mur Zuk's Sexy Walk. Requires Mur Zuk's Sexy Walk animation file.|
|VadersApp's Oblivion Real Bodies Skeleton Tweaker||Changes all (modded and vanilla) NPCs to use diverse skeletons for different look. Not compatible with MAO. Requires VadersApp's Oblivion Real Bodies.|
|Vanilla Beast Skeleton Tweaker||Sets any NPCs using the vanilla non-beast skeleton path (skeleton.nif) to use the beast skeleton patch (skeletonbeast.nif). This avoids bugs when a mod changes the race of an NPC to a beast race without setting the skeleton path to the beast path, in which case the tail will appear to extend forever and weird stuff like that.|
|All Armor Playable||Modifies non-playable armors to make them playable, unless the armor satisfies one of the following conditions:
|All Clothing Playable||Modifies non-playable clothes to make them playable, unless the clothing satisfies one of the following conditions:
|Armor Shows Amulets||Modifies playable armor to show amulets.|
|Armor Shows Rings||Modifies playable armor to show rings.|
|Bow Reach Fix||Some of the bows in Oblivion (and a few in user mods) have a reach of zero. Due to a bug in the Oblivion engine, if these bows are equipped by an NPC, the game will crash. This patch changes bows with zero reach to have reach of 1.|
|Clothing Shows Amulets||Modifies playable clothing to show amulets.|
|Clothing Shows Rings||Modifies playable clothing to show rings.|
|DarNified Books||Tweaks book colours and fonts for use with DarNified UI.|
|Default Icons||Sets a default icon for any records that don't have any icon assigned.|
|Disable Wind||Sets wind speed for all weathers to 0; this means that bushes and trees don't move in the wind since there isn't any. May help on machines with low end graphic cards.|
|Faction Crime Gold Multplier Fix||Fix factions with unset crimeGoldMultiplier to have a crimeGoldMultiplier of 1.0.|
|Harvest Chance||Sets the harvest chance of all flora to the desired chance.|
|Magic: Script Effect Silencer||Script Effects will be silenced and have no graphics.|
|No Light Fade Value Fix||Sets the fade values on all lights to a default of 1.0 if not already set.|
|No Light Flicker||Turns off flickering effects for lights. May help on machines with low end graphic cards.|
|Number of uses for pre-enchanted weapons and Staffs/Staves||The charge amount and cast cost will be edited so that all enchanted weapons and staffs have the amount of uses specified. Cost will be rounded up to 1 (unless set to unlimited) so number of uses may not exactly match for all weapons.|
|Nvidia Fog Fix||Ensures that cells have at least one non-zero fog value. For avoiding the Nvidia fog-related black screen. This feature is based on Quarn's Nvidia Black Screen Fix.|
|Reweigh: Arrows||Reweighs arrows to a maximum weight.|
|Reweigh: Ingredients||Reweighs ingredients to a maximum weight.|
|Reweigh: Potions (Maximum)||Reweighs potions to a maximum weight. This does not affect potions with script effects or with current weight >= 1.0. Thus it should not affect alcoholic beverages or scripted "potions" like HTS water skins. Note that this is similar to, but not the same as, the Reweigh Potions command for savegames, which reweighs user created potions rather than mod created potions.|
|Reweigh: Potions (Minimum)||Reweighs potions to a minimum weight.|
|Reweigh: Staffs/Staves||Reweighs staves to a maximum weight.|
|Right Hand Rings||Makes rings behave more consistently by making all rings prefer to be on the right hand. With this tweak activated, rings will only equip to the left hand if the right hand has a ring, but the left hand does not. You can use this to make one ring permanently equipped - just equip it to the left hand and it will stay on until you specifically unequip it.|
|Set Sound Attenuation Levels||The sound attenuation levels will be set to tweak%*current level, thereby increasing (or decreasing) the sound volume (lower attenuation = higher volume).|
|Set Sound Attenuation Levels: Nirnroots Only||The sound attenuation levels will be set to tweak%*current level, thereby increasing (or decreasing) the sound volume (lower attenuation = higher volume). This one only affects Nirnroots.|
|Skyrim-style Weapons||Sets all one handed weapons as blades, two handed weapons as blunt.|
|Uniform Groundcover||Eliminates the random variation in groundcover (grass, vines, shrubs, etc). Tall groundcover will still be taller than short groundcover, but there will be less variation in size. May help on lower end machines.|
|Gloves Show Rings||Prevents gloves from hiding rings.|
|Max Weight Amulets||Sets the maximum weight of amulets in the game. Amulets with higher weights will have their weight set to this value.|
|Max Weight Hoods||Sets the maximum weight of hoods in the game. Hoods with higher weights will have their weight set to this value.|
|Max Weight Rings||Sets the maximum weight of rings in the game. Rings with higher weights will have their weight set to this value.|
|Robes Show Amulets||Forces all robes to show amulets.|
|Robes Show Pants||Allows you to wear pants/skirts/greaves with robes. This is useful for armor and enchantment. Not recommended because graphics clipping is common.|
|Unlimited Amulets||Allows you to wear an unlimited number of amulets. Not recommended because it is unbalancing and it prevents amulets from displaying (i.e., they won't appear around your or NPC's necks).|
|Unlimited Rings||Allows you to wear an unlimited number of rings. Not recommended because it is unbalancing and it prevents rings from displaying (i.e., they won't appear on your or NPC's fingers).|
|Body Part Codes||This determines what code will be used for tweaking armor and clothes covering various body parts. There are two versions. Each code letter is assigned in order to: Amulets, Rings, Gloves, Helmets, Tail items, Robes (upper+lower body), Chest, Pants/Greaves, Boots/Shoes, Shields.|
|Armor||Tweaks names of armors to make them sort more easily in inventory. There is a choice of formats and whether you want armor rating to be shown.|
|Clothes||Tweaks names of clothes to make them sort more easily in inventory. There is a choice of formats.|
|Lore Friendly Names: Dwarven -> Dwemer||Changes nearly any usage of the word Dwarven to use Dwemer instead in order to better follow lore.|
|Notes and Scrolls||Tweaks names of notes and scrolls to make them sort more easily in inventory. There is a choice of formats and whether you want enchanted scrolls at top (~) or the bottom (.) of list. (Note that the "~" will not display in the inventory.)|
|Potions||Tweaks names of potions to make them sort more easily in inventory. There is a choice of formats.|
|Proper English Names: Dwarfs -> Dwarves||Renames any instances of dwarfs to dwarves|
|Proper English Names: Staffs -> Staves||Renames any instances of staffs to staves.|
|Spells||There is a choice of formats and whether you wish the school (e.g. D) and spell level (e.g. D2) to show.|
|Weapons||There is a choice of formats and whether you want damage to be shown.|
|Actor Strength Encumbrance Multiplier||Actor strength * this multiplier = actor encumbrance capacity.|
|AI: Conversation Chance||Chance of NPCs engaging each other or the player in conversation in exteriors.|
|AI: Conversation Chance - Interior||Chance of NPCs engaging each other or the player in conversation in interiors.|
|AI: Max Active Actors||The maximum number of actors for AI to be processing at once. Must be higher than Combat: Max Actors.|
|AI: Max Dead Actors||The maximum number of dead actors allowed before Oblivion begins to remove them.|
|AI: Max Smile Distance||Maximum distance for NPCs to start smiling.|
|Arrow: Litter Count||Shot arrows will be automatically removed from the world if their number exceeds the Arrow Litter Count.|
|Arrow: Litter Time||The period of time after which shot arrows will be automatically removed from the world.|
|Arrow: Recovery from Actor||Your chance of recovering an arrow shot into an actor (including arrows shot into player).|
|Arrow: Speed||Speed at which a full power arrow travels.|
|Bounty: Attack||The bounty for attacking a "good" npc when observed.|
|Bounty: Horse Theft||The bounty for horse stealing.|
|Bounty: Theft||The bounty for stealing as a fraction of the item's value.|
|Camera: Chase Distance||Changes the maximum distance the chase camera can be moved away from the player. Very useful for creating a bird's eye view – but also a little bit unbalancing for that reason.|
|Camera: Chase Tightness||Tightens up the 3rd person chase camera. Highest setting (x 3.0) essentially locks camera behind player.|
|Camera: PC Death Time||This is how long the camera lingers on the player after player's death before the reload menu appears. (Even at "Unlimited", you can hit escape to force reload menu to appear.)|
|Cell Respawn Time||Time that must pass after you've last visited a cell before the creatures, npcs and items in it respawn. Default is 3 days. Note that setting to longer durations will result in larger savegames.|
|Combat: Alchemy||By default, you cannot craft alchemy items in combat. Disallowing it encourages you to be ready for battle ahead of time.|
|Combat: Max Actors||The maximum number of actors that the engine will process in combat.|
|Combat: Max Ally Hits||The maximum number of hits on an ally allowed in combat before the ally will attack the hitting character.|
|Combat: Maximum Armor Rating||The maximum armor rating that you can get. Default: 85.|
|Combat: Recharge Weapons||By default, you can recharge weapons during combat. Disallowing that encourages you to be ready for battle ahead of time.|
|Combat: Repair||By default, you cannot repair items in combat. Disallowing it encourages you to be ready for battle ahead of time.|
|Companions: Max Number||Sets the maximum number of companions that will follow the player.|
|Compass: Disable||Disables POI's (Points of Interest), Quest Markers, or both on the compass. This may not work with some UI mods, and make some quests very hard to complete.|
|Compass: POI Recognition||Distance at which Points of Interest become visible on the compass. Default is 12,000 units. Lowest setting (x 0.25) is just a little farther than unvisited locations will be "found."|
|Cost Multplier: Enchantment||The cost multiplier factor for enchanting, OOO default: 120, vanilla default: 10.|
|Cost Multplier: Recharge||The cost multiplier factor for recharging.|
|Cost Multplier: Repair||The cost multiplier factor for repairing.|
|Cost Multplier: Spell Making||The cost multiplier factor for spellmaking.|
|Crime: Alarm Distance||The distance from the player that NPCs will be alerted to crimes.|
|Crime: Pickpocketing Fine||The fine for pickpocketing.|
|Crime: Trespass Fine||The fine for trespassing.|
|Drag: Max Moveable Weight||The max weight that can be dragged.|
|Essential NPC Unconciousness||Time for which an essential NPC stays unconscious after being knocked out.|
|Fatigue from Running/Encumbrance||Fatigue cost multiplier for running or encumbrance.|
|Greeting Distance||Distance at which NPCs will greet the player.|
|Horse Turning Speed||Default Horse turning speed is rather slow. This allows you to increase it by 1.5 or 2.0 times normal speed.|
|Inventory Quantity Prompt||Number of items in a stack at which point Oblivion prompts for a quantity.|
|Jump Higher||Increases the maximum allowed jump height. Note that this may allow you to jump over city walls and so end up with graphical strangeness.|
|Leveled Creature Max Level Difference||Maximum difference to player level for leveled creature.|
|Leveled Item Max Level Difference||Maximum difference to player level for leveled items.|
|Magic: Bolt Speed||Speed at which at which magic bolts (projectiles) travel.|
|Magic: Chameleon Refraction||Turns off the refraction effect for chameleon, but leaves the incremental transparency effect on.|
|Magic: Max NPC Summons||Sets the number of summons a NPC may have active at one time.|
|Magic: Max Player Summons||Sets the number of summons the player may have active at one time. Normally less than Max NPC Summons.|
|Master of Mercantile Extra Gold Amount||The extra barter gold all vendor's have for a master of mercantile.|
|Msg: Auto Saving||Sets the message on autosaving to blank or either "." or "Hmm..." or a custom value entered by user.|
|Msg: Equip Misc. Item||Sets the message on equipping a misc item to blank or either "." or "Hmm..." or a custom value entered by user.|
|Msg: Harvest Failure||Sets the message on flora harvest failure to blank or either "." or "Hmm..." or a custom value entered by user.|
|Msg: Harvest Success||Sets the message on flora harvest success to blank or either "." or "Hmm..." or a custom value entered by user.|
|Msg: Horse Stabled||Sets the message on stabling a horse on fast travel to blank or either "." or "Hmm..." or a custom value entered by user.|
|Msg: Loading Area||Sets the message when background loading area to blank or either "." or "Hmm..." or a custom value entered by user.|
|Msg: No Fast Travel||Sets the message when attempting to fast travel when it is prohibited to blank or either "." or "Hmm..." or a custom value entered by user.|
|Msg: Not Enough Charge||Sets the message on attempting to use an enchanted item with insufficient charge to blank or either "." or "Hmm..." or a custom value entered by user.|
|Msg: Quick Load||Sets the message on quick loading to blank or either "." or "Hmm..." or a custom value entered by user.|
|Msg: Quick Save||Sets the message on quick saving to blank or either "." or "Hmm..." or a custom value entered by user.|
|NPC Blood||Sets a few gmsts to use either user specified blood textures or no blood.|
|Training Max||Sets the training limit per level allowed by trainers.|
|UOP Vampire Aging and Face Fix.esp||Duplicate of the UOP component that disables vampire aging (fixes a bug). Use instead of 'UOP Vampire Aging & Face Fix.esp' to save an esp slot.|
|Warning: Exterior Distance to Hostiles||Sets the minimum distance a hostile actor has to be from the player to allow the player to sleep/fast travel/etc. in exteriors.|
|Warning: Interior Distance To Hostiles||Sets the minimum distance a hostile actor has to be from the player to allow the player to sleep/fast travel/etc. in interiors.|
|Crime: Force Jail||The bounty level at which the player cannot pay the fine but has to go to jail.|
|Thieves Guild: Quest Attacking Penalty||Sets the penalty cost for attacking while completing a Thieves Guild quest.|
|Thieves Guild: Quest Killing Penalty||Sets the penalty cost for killing while completing a Thieves Guild quest.|
|Thieves Guild: Quest Stealing Penalty||Sets the penalty cost for stealing while completing a Thieves Guild quest.|
|Timescale||Sets the game's timescale.|
The following CSV files are supplied with Wrye Bash and are can be used when building your Bashed Patch.
|Default CSV Files|
|Replace Form IDs||P1DCandles_Formids||Replaces the Form IDs of various candles to reference equivalents supplied by P1D's Candles For Kleptos.|
|TI to Cobl_Formids||Replaces ingredients added by Tamrielic Ingredients with equivalents added by Cobl.|
|Import Names||Guard_Names||Based on Flak's Complete Names Project, this CSV file gives unique names to guards, legion soldiers, couriers and a few other NPCs and creatures with generic names. It covers both vanilla Oblivion and Oscuro's Oblivion Overhaul.|
|OOO_Potion_Names||Renames the alcoholic beverages back to vanilla names for those that don't like OOO's method of renaming them.|
|Random_NPC_Alternate_Names||Does the same as Random NPC Names above, but using different names.|
|Random_NPC_Names||Gives unique names to generically named NPCs and renames some others from the following mods:
|Rational_Names||Renames various items in the game to have more rational names. Based on Rational Names 2, minus the GMST settings for soulgem names, and expanded to cover the Shiveriing Isles, Oscuro's Oblivion Overhaul and a few more mods.|
|Cobl Exhaustion||Assorted_Exhaust||Defines power exhaustion levels for greater powers from Oblivion, the Orrery DLC and Cobl.|
|Kmacg94_Exhaust||Defines power exhaustion levels for greater powers from Race Balancing Project, Oblivion WarCry, Oscuro's Oblivion Overhaul and several other mods.|
|Morph Factions||Bash_MFact||Used with Wrye Morph to provide faction morphing.|
The leveled list patcher is slightly odd in comparison to the others: it's effectively an
Import... patcher, but its options are decided automatically by default.
First, a bit of background. When different plugins alter the same leveled list, only the last loaded plugin's changes get applied. This tends not to be what is wanted. The leveled list patcher circumvents the issue by instead merging all the changes made to leveled lists and having this merged set of changes applied.
The leveled list merging is dictated by related Bash Tags, and functions as follows.
Delevtagged plugins can remove entries from leveled lists. Any items present in such a plugin's masters but not in the plugin itself will be removed.
Relevtagged plugins can relevel an existing entry (ie. change its levels and/or counts in the list), and can also override previous deletions of entries from leveled lists. However, it does not prevent a later-loading
Delevtagged plugin from then removing an entry again.
Relevtagged mods simply combines the effects of the
It's best to simply ensure that your plugins have the correct tags and leave this section on automatic. To add plugins to or remove plugins from the list, uncheck the
Automatic checkbox, and use the
Remove buttons. The latter will remove the currently selected plugin.
To manually override the Delev/Relev Bash Tags for a plugin, right-click it in the section list and check or uncheck the relevant options as desired. To return to the automatic setting, select the
Auto option in the right-click menu.
The Saves tab allows you to manage many aspects related to your game's saves. Save files are found in the
My Games\[Game]\Saves directory and have the file extension
.ess. When you quicksave or autosave, the game backs up the previous quick/autosave by replacing the file extension with
.bak. This backup may be restored by restoring its original file extension.
If you have Pluggy and/or the game's Script Extender installed, each of your save files will have a corresponding
cosave containing the Pluggy/OBSE/SKSE-specific data. These cosaves have file extensions
.skse for Pluggy, OBSE and SKSE respectively.
The Saves tab is divided into two sections: the main panel lists your save files and displays some of their details in its columns. The Save Details panel on the right displays some more information relating to the currently selected save file. It comprises of the following sections:
|File Name||This is the filename of the save. Changing it here will rename the save file.|
|Player Info||These three lines give the player character's name, their level, days have passed in-game, hours played and current location.|
|O/P Flags||These two flags appear to the right of the player info, and indicate the presence of cosave files: O is for OBSE cosaves, and P is for Pluggy cosaves.|
|Screenshot||The screenshot embedded in the save file, taken at the moment of saving.|
|Masters List||The plugins that the save file depends on, and their load order.|
Masters in the list can be renamed if the corresponding plugin has been renamed. To rename a master, either left-click it and edit it in the column display, or right-click it and select
Change To...to select the desired replacement plugin from the Data directory.
Masters can also be disabled if they have been removed and are preventing your save from loading, as may sometimes happen, by right-clicking them and selecting
Disable. Note that logical errors may still occur that prevent the removal of the plugin dependency, but this will let the game try to remove the dependency.
|Notes||This section can be used to keep notes on the save file.|
Save profiles are like player accounts, in that they consist of a load order plus a set of save files. They can be used to allow safe and easy switching between different characters than may use different combinations of mods, or between different stages of the same character's life (where different mods have been used in each stage). They can also associate different versions of Oblivion.esm with different save profiles, using Oblivion.esm Swapping.
To create or modify save profiles, use the Edit Profiles... command in the
Profile submenu of the column header context menu. You can create a new save profile using
Add, delete the selected existing save profile using
Remove and rename the selected save profile using
Rename. The central text field can be used to store notes on the selected save profile.
To select a save profile, select it from the list visible in the
Profile submenu of the column header context menu.
To assign save files to a save profile, use the Move To or Copy To submenus in the save file context menu. This will also assign any related cosave files.
Faces may be imported from saves to saves or plugins, or from plugins to saves. This allows you to preserve a character's appearance should you wish to restart a character, to roleplay as a particular character, or to turn your character into an NPC that may be encountered during playing, among other uses.
To import a face to a save:
Importbutton to finish.
To import a face to a plugin:
Filemenu of the plugin context menu in the Mods tab.
Some notes on the usage of Face Import:
Data\Docs\Images\[EditorID].jpg, where [EditorID] is the Editor ID of the face. The size of the image box is 250x210 pixels. Wrye Bash will scale down any image supplied to fit the box.
Change To...command to select the source cosmetic ESP.
|Good. Exactly synced with the current load order.|
|Good. Compatible with the current load order. However, the current load order includes some plugins that are not used by this save game.|
|Good, but not in sync with the current load order. Use Load Masters to sync load order to this save.|
|Some plugins have changed order. the game and the Construction Set/Creation Kit will adjust for this when loaded. However, if some of the plugins that you depend made conflicting changes to the same item, a different plugin may now dominate because of the reordering.|
|A master is missing. You should check to make sure that you have not inadvertently renamed or removed the plugin.|
|Column Header Context Menu|
|Sort By||This submenu allows you to choose by which column the save list is sorted. This is equivalent to clicking on a column header.|
|Oblivion.esm||Oblivion only. This submenu relates to Oblivion.esm Swapping. It allows you to swap the active version of Oblivion.esm.|
|Profile||Edit Profiles...||This submenu allows the creation, editing and removal of save profiles.|
|[Profile]||[Profile] is the name of a save profile, which are listed below the separator in the Profile submenu. Clicking a save profile will activate it.|
|Columns||This submenu allows you to choose which columns are visible in the save list.|
|Open...||Opens the saves folder in Windows Explorer.|
|Unhide...||Opens a dialogue window allowing you to select which hidden save files to unhide.|
|Save Context Menu|
|File||Backup||Creates a backup of the selected save file in |
|Duplicate...||Creates a duplicate of the selected save file in the saves folder.|
|Delete||Permanently deletes the selected save file and any backups of it.|
|Hide||Moves the selected save file to the |
|Revert to Backup||Reverts the selected save file to the last backup made of it.|
|Revert to First Backup||Reverts the selected save file to the first backup made of it.|
|Rename...||Rename the selected save file.|
|Re-number Save(s)...||Allows the re-numbering of the selected save file(s). If more than one file is selected, the first will be renumbered to the given number and the others will be numbered in increments of one from the given number.|
|Move To||This submenu allows you to specify a save profile to move the selected save(s) to from the active save profile.|
|Copy To||This submenu allows you to specify a save profile to copy the selected save(s) to, so that it is present in both the active and specified save profiles.|
|Load Masters||Synchronizes activated plugins to savegame's masters.|
|List Masters...||Lists savegame masters in load order and copies the list to the clipboard. Version numbers are displayed if detected.|
|Diff Masters...||If two savegames are selected, then this will compare the masters of the new save to those of the older save. If one savegame is selected, then this will compare the currently active plugins to the masters of the selected savegame. The comparison details masters that have been removed and added in the newer save since the older save, or removed and added in the load order since the selected save.|
|Statistics||Oblivion only. This produces a set of various technical statistics for the selected savegame. The following information is produced:
|.obse Statistics||Oblivion only. This is similar to Statistics above, but reports statistics for the .pluggy and/or .obse cosave files associated with the selected save.|
|Delete Spells...||Oblivion only. This allows you to delete unused spells from your spell list in the selected save. Warning: This cannot be undone. Most spells may be repurchased or recreated, but quest and other special spells will likely have to be added using the console.|
|Rename Player...||Oblivion only. Renames the player's character in the selected save.|
|Set Number of Uses for Weapon Enchantments...||Oblivion only. Allows you to set the number of casts available to any enchanted weapon you created in-game, or that has otherwise been recorded in your savegame.|
|Import Face...||Oblivion only. Relates to Face Importing. This command allows you to import a face for the save file's player character (and possibly some NPCs) from another save file or from an NPC in a mod.|
|Rename Enchanted...||Oblivion only. Allows you to rename any enchanted items that you have created in-game for the selected save.|
|Rename Potions...||Oblivion only. Allows you to rename any potions that you have created in-game for the selected save.|
|Rename Spells...||Oblivion only. Allows you to rename any spells that you have created in-game for the selected save.|
|Reweigh Potions...||Oblivion only. Potions created in-game are given a weight that is somewhat arbitrarily selected and potentially high. This command may be used to set all created potions to have a specific weight. Potions created after the use of this command with new names, new effects or new durations will not be affected.|
|Update NPC Levels...||Oblivion only. Updates the level information for NPCs stored in the selected savegame to reflect the active load order's NPC level settings. This is required because although NPC levels are set via plugins, once an NPC is encountered its level is stored in the save file, which overrides the plugin levels.|
|Export Screenshot...||Allows you to save the image used as the save file's screenshot as a JPEG.|
|Remove Bloat...||Oblivion only. This is an experimental command. It is recommended that saves are backed up before using it on them. It attempts to determine how much bloating there is in the selected save file and then optionally remove it. If the command reports a large number of created objects, there could be a problem with one of your mods, and such mods should be removed or updated. There are two common types of bloat:
|Repair Abomb||Oblivion only. |
Abomb Animation Slowingis a slowing of animations that typically occurs around 225 hours into the game, though it may occur earlier or later. This is an engine bug, and this command avoids its effects by resetting a related counter (TesClass Abomb counter is reset to 0x41000000).
|Repair Factions||Oblivion only. Attempts to repair the damage caused by a bug in Update NPC Levels that was introduced in v105 and fixed in v116 of Wrye Bash. This also optionally updates NPC factions to reflect the faction changes by mods. Do not use this function unless you know you have to. It is better to revert to a recent save.|
|Repair Hair||Oblivion only. Oblivion has a bug that will cause a crash if your PC's hair comes from a mod that has been removed and you then run showRaceMenu. This command resets your hair to the default for that race and gender, so you can then use showRaceMenu to select a new hair again if you wish.|
The Screenshots tab allows you to preview any screenshots taken in-game using the built-in Print Screen functionality. These screenshots are saved as bitmap files (.bmp). Selecting a screenshot from the list on the left will display it on the right. Screenshots can be converted from bitmaps into a few other formats using context menu commands.
|Column Header Context Menu|
|Open||View the screenshot directory in Windows Explorer.|
|Next Shot||Set the name and number of the next screenshot.|
|JPEG Quality||Set the quality of JPEGs created during conversion.|
|Screenshot List Context Menu|
|Delete||Deletes the selected file(s).|
|Convert||Converts the selected files to one of the following formats: JPEG, PNG, BMP, TIFF. If a file of the conversion format already exists with the same name as a file to be converted, the conversion will not take place for that file.|
|Rename||Renames the selected file(s). If multiple files are selected, they will be numbered sequentially. If a file already exists with the same name as a file's resulting name, that file will not be renamed.|
You can hide specific launcher icons, preventing them from being displayed, by right-clicking them and selecting
Hide... or by inserting a semicolon before their path in the
sPhotoshopPath=;C:\Program Files\Adobe\Photoshop 7.0\Photoshop.exe.
You can hide some of the toggle buttons using the
bShowTes4... options in the
Tool Options in the
You can unhide launchers hidden through the right-click option using the Settings menu. See the Settings Menu for more information.
Custom launcher buttons may be added by putting a shortcut to the application you wish to have a launcher for in the
Mopy\Apps directory. Wrye Bash will then use the following information from the shortcut:
If you want to have a custom icon for a launcher, place a PNG image with the same name as the shortcut, appending the icon size, in the same folder. For example:
Note: 24x24 icons taken from shortcuts do not work well, so if you are using this size, be sure to include a custom icon. Icon size displayed can be adjusted in the
bash.ini or the Settings menu.
The PM Archive tab can be used to archive, view and search Private Messages from the official Bethesda Softworks forums. Due to forum updates, messages archived since the 13th of March 2010 cannot be imported into Wrye Bash. As such, the tab is only available for legacy support of those with messages archived before then.
Warning: This feature is both experimental and outdated. Keep a separate backup of any archives you import into Wrye Bash.
To import PM archives into Wrye Bash, follow the instructions below:
07.11.06 archive.html. It doesn't matter what the name is after the date.
Import Archives...then select the archive files you wish to import.
PMs may be searched using the bar at the bottom of the window, by entering in the search text then clicking the
Search button or hitting return on your keyboard. Messages may be sorted by any of the columns by clicking a column header. Selecting multiple messages will display them all at once in the order they are listed.
|Search||Search for the text entered into the search text box. Messages will be searched in the subject, author and text fields, and a filtered list of matching results will be displayed at the top of the window. Search may also be initiated by pressing the return keyboard key.|
|Clear||Clears the search box, removing the filter from the PM list and so displaying all archived PMs again. Search may also be cleared by emptying the search text box and pressing the return keyboard key.|
|PM List Context Menu|
|Delete||Deleted the selected message(s).|
|Import Archives...||Import one or more PM archive files.|
The People tab functions as a simple database that can be used to keep notes on various people (eg. why you blocked a forum user, or what a good mod someone made).
People are listed in the column on the left, and the large text box on the right can be used for writing notes on the selected person. Notes are saved automatically as you type them, but otherwise the text box behaves as a simple text editor such as Notepad.
The Karma column displays the karma level you have set for them. Karma is a simple way of rating your disposition towards a person. The Header column displays the first 75 characters of text in a person's notes. Clicking a column header will sort by that column.
|Person has +5 karma.|
|Person has +3 or +4 karma.|
|Person has +1 or +2 karma.|
|Person has 0 karma.|
|Person has -1 or -2 karma.|
|Person has -3 or -4 karma.|
|Person has -5 karma.|
|Column Header & Person Context Menus|
|Add...||Add a new person record to the list.|
|Delete||Delete a person record from the list.|
|Import...||Import a person record from an exported person record file.|
|Export...||Export a person record to a person record file. Exported person records are text files that contain the person's name and any notes you have on them. It doesn't export karma.|
|Columns||This submenu allows you to choose which columns are visible.|
|Karma||This submenu allows you to set a karma level for a person, ranging from +5 to -5.|
The Settings menu is where Wrye Bash's global settings may be accessed. The Settings menu can be opened by clicking on the Settings button in the status bar. The Settings menu's items are detailed in the table below.
|Backup Settings...||Backs up all the parts of Wrye Bash that can be changed by the user to a location of the user's choosing. The backed up items are:
|Restore Settings...||Restores your settings from a backup of your choice. This will force a restart of Wrye Bash to ensure the new settings take effect.|
|Save Settings||Normally, Wrye Bash saves its settings to disc only on closing. Use this to force a save right now.|
|Export list of allowed/disallowed OBSE plugin dlls||This will save the Good/Bad OBSE dll definitions to a text file, either for editing or for backup purposes.|
|Import list of allowed/disallowed OBSE plugin dlls||This will import the list of Good/Bad OBSE dll definitions from a text file previously exported using Export list of allowed/disallowed OBSE plugin dlls.|
|Colors...||Brings up the Colors dialog. This dialog can be used to change the colors that Wrye Bash uses to communicate various bits of information.
The drop-down list is used to select the item for which you want to change the color. The square box next to the drop-down list opens a color picker, allowing you to choose a new color. The function of the other buttons is described in the table below.
|Tabs||This submenu allows you to choose which of the main tabs are displayed (eg. Installers, Mods, Saves, INI Edits, Screenshots, People, PM Archives) by checking and unchecking the tabs listed in it.|
|Status Bar||Icon Size||Choose between 16x16, 24x24, or 32x32 Status Bar icons.|
|Unhide Buttons||Unhide Status Bar buttons that you have hidden.|
|Show App Version||Shows the versions of applications in their launchers' tooltips.|
|Language||This submenu lists the languages for which translations of Wrye Bash exist.|
|Plugin Encoding||This submenu allows you to select the encoding that Wrye Bash assumes plugin descriptions to be written in. The |
Automaticoption is selected, Wrye Bash attempts to detect the encoding from the contents of the description. If a plugin description is being displayed incorrectly, try selecting another encoding from this list.
|Game||This submenu lists the games that Wrye Bash supports and detects as being installed. Selecting a game will close Wrye Bash and re-open it for the selected game.|
|Use Alternate Wrye Bash Name||If checked, displays in the title bar |
Wrye Bashwhen running for Oblivion and
Wrye Smashwhen running for Skyrim. If unchecked, the title bar will contain
Wrye Bash for [Game]instead.
|Debug Mode||Opens up a window to which debugging information is written.|
|Dump Translator||Generates a new translation file for your locale. See Internationalisation for more information.|
|Colors Dialog Buttons|
|All Defaults||Returns all colors to their default setting. Apply All must still be used for the changes to take effect.|
|Default||Returns the current item to its default color. Apply must still be used for the change to take effect.|
|Apply All||Applies all changes you have made to the colors since last opening the Colors dialog.|
|Apply||Applies any change to the current item's color.|
|Export...||Exports the current color scheme to a text file.|
|Import...||Imports a color scheme from a text file previously exported. Apply All must still be used for the changes to take effect.|
|OK||Closes the dialog. Does not apply any changes made.|
The Doc Browser allows you to quickly and easily scan through your mods' documentation. The supported document types are: text files, HTML files and MHT files (HTML archives). To display the Doc Browser, double click any plugin in the main list of the Mods tab.
When you double-click a plugin, Wrye Bash will open the Doc Browser and attempt to determine which document to associate with it. If it can determine one, it will display it. Otherwise, a blank page will be displayed. To associate a document with a plugin, use the
Set Doc... button in the Doc Browser. To disassociate a document with a plugin, use the
Forget Doc... button in the Doc Browser.
You can also rename an associated document using the
Rename Doc... button to select a new name and/or location. The document will be renamed and/or moved to this location.
You can edit a document by clicking the
Edit Doc... button. The document can then be edited in the viewing window. To finish editing, click the
Edit Doc... button again. Changes are automatically saved when you select a new plugin, close the Doc Browser or finish editing.
A document can be opened in its default external editor by clicking the
Open Doc... button.
A new document can be created for a plugin by clicking the
Set Doc... button and choosing a new filename. This creates a document using a blank template that you can then edit. The default template is
Data\Docs\My Readme Template if it exists, or if not,
Data\Docs\Bash Readme Template.txt. The latter is written in Wrye wiki text format, which will be displayed as HTML when the Doc Browser is not in edit mode.
To view a different document, select a different plugin in the list on the left of the Doc Browser or in the Mods tab.
Some notes on Doc Browser behaviour:
Data\Docsis the standard location.
The Mod Checker checks your active and merged plugins for errors, and provides warnings for any found, as well as configuration recaps and suggestions. It can be opened by clicking the Mod Checker button in the status bar.
At the top of the report is the Active Mod Files section, which lists your load order. It also displays any warnings that are applicable beneath the plugin(s) that they are applicable to. These warnings are either regardinng missing masters or delinquent masters.
The next section of the report details the output of any rulesets installed. These are text files that contain a set of instructions that tell the Mod Checker what to look for and what to say in the report if anything is found. Currently the only ruleset distributed by Wrye Bash is for Cobl. Rulesets are stored in
Data\Bash Patches and end in
Rules.txt. Information on ruleset syntax can be found at UESP: Wrye Bash Mod Checker.
The rest of the report details any plugin groups that have been set up. Each group's section contains the following information:
|Mod Checker Buttons|
|Forward/Back Arrows||The Mod Checker report may contain links to other pages. These two buttons allow navigation between pages viewed, similar to the forward/back buttons in a web browser.|
|Mod List||Toggles the display of the Active Mod Files list.|
|Rule Sets||Toggles the display of the headers for the rulesets installed, even if they produce no other output.|
|Notes||Toggles the display of plugin group notes.|
|Configuration||Toggles the display of plugin groups' configurations.|
|Suggestions||Toggles display of the suggestions produced by plugin groups.|
|Version Numbers||Toggles display of version numbers where found for the plugins in the Active Mod Files list.|
|CRCs||Toggles display of the CRCs for the plugins in the Active Mod Files list.|
|Scan for Dirty Edits||Toggles the scanning of plugins for dirty edits. Effectively runs Scan for Dirty Edits on each of the plugins in the Active Mod Files list and displays the results in the Mod Checker's report.|
|Copy Text||Copies the text of the report to the clipboard. Useful for posting on forums.|
|Update||Forces a refresh of the report.|
Oblivion.esm swapping is a feature that allows mod authors to switch between different versions of Oblivion.esm on the fly. This is useful as it allows mod authors to make plugins that are totally SI-independent (as the Shivering Isles patches Oblivion.esm instead of using a new plugin). It can also be used to avoid the need for a fully patched Oblivion to run a plugin, but this usage is not recommended. If you want a plugin to work on older versions of Oblivion, use the Version 0.8 command on it.
The main requirement for swapping to work is that you have the necessary copies of the different Oblivion.esm files. This is only possible if you copy and rename Oblivion.esm before installing Shivering Isles. There are three accepted versions of Oblivion.esm in addition to the latest SI one. These are determined by their file size:
You can then swap between the different versions of Oblivion.esm using the Oblivion.esm submenu in the Mods tab column header context menu. Your currently active version will be checked, select another to swap them. You can also perform the same swapping in the Saves tab column header context menu, but in addition to the swapping this will also mark the selected version as the preferred version to use with the current Save Profile. If you then switch to another save profile and back to this one, Oblivion.esm will be swapped automatically.
Wrye Bash displays the current version of Oblivion.esm in its version indicators. The main indicator is in the title bar of the main Wrye Bash window, but there are also indicators placed after Oblivion.esm in the Mods tab plugin list, and after Oblivion.esm in the Masters tab for plugins and savegames. The three possible indicators are:
The following keyboard shortcuts work almost everywhere in Wrye Bash.
|Auto-sizes the columns to fit what is displayable.|
The following table lists all command-line arguments Wrye Bash supports.
|Specifies the game Wrye Bash should try to manage. Use this argument if more than one game Wrye Bash supports is installed.|
|Useful if bash is crashing on startup or if you want to print a lot of information (e.g. while developing or debugging).|
|Disables import of Psyco.|
|enables CBash and uses CBash to build the bashed patch.|
|disables CBash and uses python code to build the bashed patch.|
|Specify the user language overriding the system language
||All path arguments must be absolute paths and use either
forward slashes (/) or two backward slashes (\\). All of these can
also be set in the ini (where you can also use relative paths) and
if set in both cmd line takes pecedence.
|Specifies the game directory (the one containing the game's
exe). Use this argument if Bash is located outside of the game
directory, and the ||User Directory Arguments
||These arguments allow you to specify your user directories
in several wasy. These are only useful if the regular procedure for
geting the user directory fails. And even in that case, the user is
probably better off installing win32com.
|Specify the user's personal directory. (Like "C:\\Documents
and Settings\\Wrye\\My Documents") If you need to set this then you
probably need to set |
|Specify the user profile path. May help if HOMEDRIVE and/or HOMEPATH are missing from the user's environment.|
|Specify the user's local application data directory. If you
need to set this then you probably need to set ||Backup and Restore Arguments
||These arguments allow you to do backup and restore settings
|Backup all Bash settings to an archive file before the app
launches. Either specify the filepath with the |
|Backup all Bash settings to an archive file before the app
launches. Either specify the filepath with the |
|The file to use with the |
|Close Bash after creating or restoring backup and do not display any prompts or message dialogs.|
|Include changed images from mopy/bash/images in the backup. Include any image(s) from backup file in restore.|
|Include all images from mopy/bash/images in the backup/restore (if present in backup file).|
Wrye Bash has built-in support for translation into other languages, using text files that tell it which English strings in the source code should be translated, and into what. These text files are found in
Mopy\bash\l10n\. New translations or updates to existing translations should be presented to the Wrye Bash team so that they may be included in future releases.
To begin translating, or to update an existing translation, use the following steps.
Below is an excerpt from a translator file.
=== basher.py, 3711
Active profile cannot be removed.
=== basher.py, 3717
Delete profile %s and the %d save files it contains?
DELETE PROFILE %s AND THE %d SAVE FILES IT CONTAINS?
The above contains two separate translation entries. Each entry begins with the source code file and line number the string to be translated is found on.
The file line is followed by the original text string on a new line, which is then followed by a line containing only
>>>>. The translation entry ends with a final line containing the translated text string.
Note: It is important that the formatting characters are not removed or moved or added to. Formatting characters are those that start with a percentage sign or a backslash, eg.
%s %d %08X \n. If a formatting character is missing, Wrye Bash will throw an exception, which is bad.