/[wryebash]/branches/upstream-dev/Mopy/Docs/Wrye Bash General Readme.html
ViewVC logotype

Contents of /branches/upstream-dev/Mopy/Docs/Wrye Bash General Readme.html

Parent Directory Parent Directory | Revision Log Revision Log


Revision 4 - (show annotations) (download) (as text)
Mon Sep 19 03:20:26 2016 UTC (3 years, 4 months ago) by william
File MIME type: text/html
File size: 118378 byte(s)
add upstream git branches for dev and master
1 <!DOCTYPE html>
2 <meta charset="utf-8">
3 <link rel="shortcut icon" href="../bash/images/bash_32.ico"/>
4 <title>Wrye Bash General Readme</title>
5 <style>
6 html {font-family:Arial,sans-serif; background:#ffffcc; font-size:0.9em;}
7 h1, h2 { background: #9ACD32; margin-left: -8px; margin-right: -8px; padding:0.6em; }
8 h1 { margin-top:-8px; padding-left:1.5em;margin-bottom:0;}
9 h2 { margin-top:5em; padding-left:2em;}
10 h3 { font-size:1.1em; margin-top:3em;}
11 a:link { text-decoration:none; }
12 a:hover { text-decoration:underline; }
13 li ul, li ol {margin-top:0.4em;}
14 li {margin-bottom:10px;}
15 ol ol {list-style:lower-alpha;}
16 ol ol li {margin-bottom:0.2em;}
17 td, th {border:1px solid black; padding: 5px; vertical-align:top;}
18 table {margin:1em; background:#fdfdfd; border-collapse:collapse;}
19 thead {font-weight:bold; background:#8af;}
20 img {border:0;}
21 a[href^="http"]:after {padding-left:2px; content: url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAAKCAYAAACNMs+9AAAAVklEQVR4Xn3PgQkAMQhDUXfqTu7kTtkpd5RA8AInfArtQ2iRXFWT2QedAfttj2FsPIOE1eCOlEuoWWjgzYaB/IkeGOrxXhqB+uA9Bfcm0lAZuh+YIeAD+cAqSz4kCMUAAAAASUVORK5CYII=);}
22 q {font-style:italic;}
23 code {display:inline-block; padding:2px 5px; background:#DDD;}
24 code.box {line-height:20px; white-space:pre; margin:1em 0 0 3em; display:table; padding:5px 10px;}
25 blockquote {background:#E6E6FA; display:table; padding:5px 30px 5px 10px;}
26 figure {margin:0;}
27 figcaption {font-style:italic; margin-bottom:2em;}
28 .missing {background:red; color:white; border:0.25em solid black;}
29 abbr {cursor:help;}
30
31 .slideshow img {opacity:0;
32 position:absolute;
33 transition: opacity 1.5s;
34 -moz-transition: opacity 1.5s;
35 -webkit-transition: opacity 1.5s;
36 -o-transition: opacity 1.5s;}
37 .slideshow img:first-child {opacity:1;}
38 </style>
39
40 <h1>Wrye Bash General Readme</h1>
41
42 <h2 style="margin-top:0;margin-bottom:1em;">Contents</h2>
43 <ol style="float:left;margin:0;margin-right:4em;">
44 <li><a href="#intro">Introduction</a>
45 <ol>
46 <li><a href="#intro-glossary">Glossary</a>
47 </ol>
48 <li><a href="#install">Installation</a>
49 <li><a href="#uninstall">Uninstallation</a>
50 <li><a href="#bain">Installing Mods</a>
51 <ol>
52 <li><a href="#bain-overview">Overview</a>
53 <li><a href="#bain-structure">BAIN-Compatible installer layout</a>
54 <li><a href="#bain-convert">Restructuring Packages to be BAIN-Compatible</a>
55 <li><a href="#bain-install">Installing/Uninstalling Via BAIN</a>
56 <li><a href="#bain-order">BAIN Package Order</a>
57 <li><a href="#bain-symbols">What Symbols &amp; Colours Mean</a>
58 <li><a href="#bain-commands">Useful Context Menu Commands</a>
59 </ol>
60 <li><a href="#load">Setting Up Load Order</a>
61 <ol>
62 <li><a href="#load-overview">Overview</a>
63 <li><a href="#load-set">Setting The Load Order</a>
64 <li><a href="#load-undo">Undo and redo Load Order changes</a>
65 <li><a href="#load-symbols">What Symbols &amp; Colours Mean</a>
66 <li><a href="#load-commands">Useful Context Menu Commands</a>
67 </ol>
68 <li><a href="#patch">Setting Up A Bashed Patch</a>
69 <ol>
70 <li><a href="#patch-overview">Overview</a>
71 <li><a href="#patch-merging">Merging Plugins</a>
72 <li><a href="#patch-importing">Importing From Plugins</a>
73 <li><a href="#patch-tweaking">Applying Tweaks</a>
74 <li><a href="#patch-other">Other Bashed Patch Options</a>
75 </ol>
76 </ol>
77 <ol start="7" style="float:left;margin-top:0;">
78 <li><a href="#ini">Applying Ini File Edits</a>
79 <ol>
80 <li><a href="#ini-overview">Overview</a>
81 <li><a href="#ini-symbols">What Symbols &amp; Colours Mean</a>
82 <li><a href="#ini-commands">Buttons &amp; Context Menu Commands</a>
83 </ol>
84 <li><a href="#launchers">Launching Applications</a>
85 <ol>
86 <li><a href="#launchers-toggles">Toggle Buttons</a>
87 <li><a href="#launchers-game">Game &amp; Editor Launchers</a>
88 <li><a href="#launchers-utils">Game-Specific Utilities</a>
89 <li><a href="#launchers-apps">Other Applications</a>
90 <li><a href="#launchers-features">Wrye Bash Feature Launchers</a>
91 </ol>
92 <li><a href="#trouble">Troubleshooting</a>
93 <ol>
94 <li><a href="#trouble-dump">Generating A Bug Dump</a>
95 <li><a href="#trouble-permissions">File Permissions</a>
96 <li><a href="#trouble-backup">Backing Up &amp; Restoring Settings</a>
97 <li><a href="#trouble-report">How To Report Bugs Helpfully</a>
98 <li><a href="#trouble-known">Known Bugs</a>
99 <li><a href="#trouble-mistakes">Common Issues</a>
100 </ol>
101 <li><a href="#credits">Credits</a>
102 <li><a href="#contact">Contact</a>
103 <li><a href="#license">License</a>
104 <li><a href="#advanced">Advanced Readme Topics</a>
105 </ol>
106 <p style="clear:both;">
107
108 <h2 id="intro">Introduction</h2>
109 <p>Wrye Bash is a powerful mod management utility for TES IV: Oblivion and TES V: Skyrim. Its features include:
110 <ul>
111 <li>A mod installation and conflict manager
112 <li>A plugin load order manager
113 <li>Increased mod compatibility
114 <li>Lifting of the 255 plugin limit through automatic merging of compatible mods
115 <li>.ini and settings files tweak management
116 <li>Screenshot management
117 <li>Many, many more features
118 </ul>
119 <p>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.
120 <p>This readme covers only the most commonly used features, so that the average user can start using Wrye Bash without being overwhelmed. Information on the less commonly used features and more technical details of the features covered in this readme may be found in the <a href="Wrye%20Bash%20Advanced%20Readme.html">Advanced Readme</a>. Information on some of the syntaxes and file formats that Wrye Bash uses are found in the <a href="Wrye%20Bash%20Technical%20Readme.html">Technical Readme</a>. Finally, Wrye Bash's version history is stored in the <a href="Wrye%20Bash%20Version%20History.html">Version History</a> document.
121
122 <h3 id="intro-glossary">Glossary</h3>
123 <p>Modding for Oblivion and Skyrim has a wonderful history of confusing terminology. The list below details some terms commonly used when dealing with mods.
124 <ul>
125 <li><b>The game</b> is the game that Wrye Bash is running for, either Oblivion or Skyrim.
126 <li><b>CTD</b> is an acronym for Crash To Desktop. Used to describe the game crashing.
127 <li><b>DLC</b> refers to any of the official downloadable content for the game.
128 <li><b>Mod</b> refers to any unofficial user-made modification to the game.
129 <li><b>Mod author</b> refers to a person that makes modifications to the game. It can also refer to those who are involved in the creation of utilities that are used by mod authors and/or users.
130 <li><b>ESP</b> (case-insensitive) refers to any file with a <code>.esp</code> extension. It is an acronym for Elder Scrolls Plugin.
131 <li><b>ESM</b> (case-insensitive) refers to any file with a <code>.esm</code> extension. It is an acronym for Elder Scrolls Master.
132 <li><b>Plugin</b> refers to any ESP <u>or</u> ESM file.
133 <li><b>Master</b> refers to any plugins that another plugin is dependent on to function. (It can also refer to an ESM file, as it used to be that only ESMs could be masters, until mod authors developed methods of using ESP files as masters too. The latter definition will not be used in this documentation.)
134 <li><b>The game's master file</b> refers to the ESM that must be loaded for the game to function. For Oblivion, this is <code>Oblivion.esm</code>, and for Skyrim this is <code>Skyrim.esm</code>.
135 <li><b>Conflicts</b> occur when two different mods try to change the same game variable or resource, which could be anything from a specific object in game to a script or a texture. Conflicts can cause problems, including CTDs or save game corruption, but they are not inherently bad, and most modding is the result of purposeful conflicts.
136 <li><b>Resource Conflicts</b> occur when two mods contain two different files that go in the same place, so one mod's file overwrites the others's file. This type of conflict can be managed by altering the install order of mods.
137 <li><b>Data Conflicts</b> occur when two mod plugins alter the same game data. This type of conflict can be managed by altering the load order of plugins.
138 <li><b>BSAs</b> are Bethesda Softwork Archives, with <code>.bsa</code> file extensions. They can be used to store resource files such as textures and meshes.
139 <li><b>ITMs</b> are Identical To Master records, ie. data in a plugin for something that is identical to the data for that thing in the plugin's master(s). Usually a type of unintended edit, known as a <q>dirty edit</q>, which can break the functionality of other mods that require the record in question to have a specific value, but which have that value overridden by an ITM record.
140 <li><b>UDRs</b> are Undeleted and Disabled References. Deleted References can cause crashing, and this can be avoided by first undeleting and then disabling them instead. A type of <q>dirty edit</q>. This acronym is generally misused - the UDR acronym is frequently used to refer to the deleted references, rather than their fixed counterparts. For example, <q>Scan For UDRs</q> will scan for deleted references, not undeleted and disabled references, and BOSS will report the UDR count for a plugin, which is actually the number of deleted references that can be fixed.
141 </ul>
142 <p>This readme will also use the placeholder <b>[Game]</b>. Replace this with <q>Oblivion</q> or <q>Skyrim</q> depending on which game Wrye Bash is running for. Additional terminology specific to Wrye Bash's functions will be introduced as required. Also, links that are followed by <img src='data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAAKCAYAAACNMs+9AAAAVklEQVR4Xn3PgQkAMQhDUXfqTu7kTtkpd5RA8AInfArtQ2iRXFWT2QedAfttj2FsPIOE1eCOlEuoWWjgzYaB/IkeGOrxXhqB+uA9Bfcm0lAZuh+YIeAD+cAqSz4kCMUAAAAASUVORK5CYII='/> go to pages that are not part of the Wrye Bash documentation.
143
144
145 <h2 id="install">Installation</h2>
146 <p>The simplest way to install Wrye Bash is using the installer, as it installs Wrye Bash and its dependencies automatically. However, the instructions below are provided if a manual install method is preferred.
147 <p><b>Note:</b> There are two versions of Wrye Bash available: the Python version and the Standalone version. Both are the same program, but the Standalone version has fewer dependencies and so is recommended for most people.
148 <p><b>Windows Vista &amp; Windows 7 users:</b> Windows' User Account Control feature may interfere with the running of Wrye Bash and other utilities. See the <a href="#trouble-permissions">File Permissions</a> section for solutions.
149 <p>Manual Standalone Version Install:
150 <ol>
151 <li>Extract the downloaded Wrye Bash archive into the game folder (<q>Oblivion</q> or <q>Skyrim</q> depending on the game) so that the Mopy
152 directory appears in the game folder.
153 <li>Run Wrye Bash by double-clicking <q>Wrye Bash.exe</q> in the new Mopy folder.
154 </ol>
155 <p>Manual Python Version Install:
156 <ol>
157 <li>Download and install all the required Python libraries and python itself.
158 See the <a href="Wrye%20Bash%20Advanced%20Readme.html#install-components">Python Components</a> section of the Advanced readme
159 for the list of included libraries and their versions. If you have previously installed Python and any Python libraries,
160 you may not need to install them again.
161 <li>Extract the downloaded Wrye Bash archive into your game folder (<q>Oblivion</q> or <q>Skyrim</q> depending on the game) so that the Mopy
162 directory appears by the game executable. See the
163 <a href="Wrye%20Bash%20Advanced%20Readme.html#install-alternate">Alternative Install Locations</a> if you wish to install to a different directory.
164 <li>Navigate to the Mopy directory and run Wrye Bash by double-clicking <q>Wrye Bash Launcher.pyw</q>.
165 </ol>
166
167 <h2 id="uninstall">Uninstallation</h2>
168 <p>The ease with which Wrye Bash can be removed is dependent on how much you use it to manage your modded game.
169 <ul>
170 <li>If you use a Bashed Patch, you will need to remove any dependencies on it from your saves before uninstalling Wrye Bash in order to avoid in-game issues. This may be near-impossible to do, depending on what is in your Bashed Patch.
171 <li>If you use BAIN to manage your installed mods, you will need to ensure that you have an adequate alternative management system ready, as although uninstalling Wrye Bash will not uninstall your mods, you will no longer be able to use BAIN's conflict resolution features.
172 <li>If you use any INI tweaks applied through Wrye Bash, you will need to make a note of which tweaks you have applied, as although uninstalling Wrye Bash will not undo your tweaks, you will no longer have any record of tweaks applied or default values.
173 <li>If you use the People tab, you will need to transfer your notes on people and record their karma outside of Wrye Bash.
174 </ul>
175 <p>If none of the above points apply to you, or once you have taken the necessary measures for the points that apply, you can uninstall Wrye Bash by either running the uninstaller, if you used the installer to install Wrye Bash, or delete the following files and folders if you installed it manually.
176 <ul>
177 <li><code>[Game]\Mopy</code> - If you've edited any localisation files in the <code>l10n</code> folder that you want to keep, back them up.
178 <li><code>[Game]\Data\Bash Patches</code> - If you've exported any CSV files that you want to keep, back them up.
179 <li><code>[Game]\Data\Docs</code>
180 <li><code>[Game]\Data\INI Tweaks</code>
181 <li><code>Documents\My Games\[Game]</code> - Only delete the <code>BashProfiles.dat</code>, <code>BashProfiles.dat.bak</code>, <code>BashSettings.dat</code>, <code>BashSettings.dat.bak</code>, <code>Messages.dat</code>, <code>Messages.dat.bak</code>, <code>People.dat</code> and <code>People.dat.bak</code> files and the <code>Saves\Bash</code> folder.
182 <li><code>[Game] Mods</code> (in the same folder as [Game]) - The <code>Bash Installers</code> folder stores the mods you've installed via BAIN.
183 </ul>
184
185 <h2 id="bain">Installing Mods</h2>
186 <figure class="slideshow">
187 <img src="../bash/images/readme/installers-1.png" alt="Installers Tab"/>
188 <img src="../bash/images/readme/installers-2.png" alt="Installers Tab"/>
189 <img src="../bash/images/readme/installers-3.png" alt="Installers Tab"/>
190 <img src="../bash/images/readme/installers-4.png" alt="Installers Tab"/>
191 <img src="../bash/images/readme/installers-5.png" alt="Installers Tab"/>
192 <img src="../bash/images/readme/installers-6.png" alt="Installers Tab"/>
193 <img src="../bash/images/readme/installers-7.png" alt="Installers Tab"/>
194 <img src="../bash/images/readme/installers-8.png" alt="Installers Tab"/>
195 <figcaption style="padding-top:650px;">Wrye Bash's Installers tab.</figcaption>
196 </figure>
197
198 <h3 id="bain-overview">Overview</h3>
199 <p>Wrye Bash's mod installer is known as <abbr title="Bash Installers">BAIN</abbr>, and is represented by the Installers tab. The first time the Installers tab is opened, a
200 dialog will appear asking if BAIN should be initialized. If you click <q>Yes</q>, BAIN will be initialised, which can take some time. After that, the information refresh
201 performed when the Installers tab is opened is much faster. BAIN's primary function is to install mod packages. <b>BAIN Packages</b> can be <code>.zip</code>,
202 <code>.7z</code> or <code>.rar</code> archives or uncompressed directories. Uncompressed directories are called <b>projects</b> while archives are usually called
203 <b>packages</b>, abusing terminology. When we refer to projects and packages together we will be also using the term <b>installer</b>.
204 <p>If BAIN is disabled, ie. if you clicked <q>No</q> on the dialog that was displayed the first time you selected the Installers tab, it can be re-enabled by right clicking on a column header in the Installers tab and selecting <a href="Wrye%20Bash%20Advanced%20Readme.html#bainEnabled">Enabled</a>.
205
206 <h3 id="bain-structure">BAIN-Compatible installer layout</h3>
207
208 <p>When looking at an installer (package or project) BAIN follows some rules to decide what's in there and if it can be installed. In broad lines, BAIN
209 will search for specific directories and file extensions (mod, texture, nif, docs etc). The directories BAIN is aware of, independently of the game,
210 are:
211
212 <table>
213 <thead><tr><th>Bash directories<th>Notes
214 <tbody>
215 <tr><td>bash patches<td>yep, Bash will install files in this folder from packages
216 <tr><td>docs<td>its contents will be copied inside Data/Docs
217 <tr><td>ini tweaks<td>ini tweaks inside this will be installed in Data/Ini Tweaks/ - do <b>not</b> include subfolders in ini tweaks/
218 <tr><td>screenshots<td>its contents will be copied inside Data/Docs
219 <thead><tr><th colspan="2">Vanilla game directory present on all games
220 <tbody>
221 <tr><td colspan="2">meshes, music, textures, video
222 </table>
223
224 but there are game specific directories as well (all directory detection is <i>case insensitive</i>):
225
226 <table>
227 <thead><tr><th>Game<th>Extra Game Directories<th>Bonus Directories (tools or modders)
228 <tbody>
229 <tr><td>Oblivion<td>distantlod, facegen, fonts, menus, shaders, sound, trees<td>_tejon, ini, obse, pluggy, scripts, streamline
230 <tr><td>Skyrim<td>dialogueviews, grass, interface, lodsettings, scripts, seq, shadersfx, sound, strings<td>asi, ini, skse, skyproc patchers
231 <tr><td>Fallout 4<td>interface, lodsettings, materials, misc, programs, scripts, shadersfx, sounds, strings, vis<td>f4se, ini
232 </table>
233
234 All these directories (either in the Global or Extra and Bonus Game directories) constitute the <i>standard game directories</i> for this game. If
235 <a href="Wrye%20Bash%20Advanced%20Readme.html#bainHasExtraDirectories">Has Extra Directories</a> is not on for the package, any other top level directory in the (sub)package
236 will be skipped (and their content listed in Skipped tab). There are also some directories and files that will be always skipped (for all the gory details see
237 <a href="Wrye%20Bash%20Advanced%20Readme.html#bain-skipped">Skipped Files</a>).
238
239 <p>There are, loosely speaking, three types of BAIN-compatible package structures:
240
241 <table>
242 <thead><tr><th>Structure<th>Description
243 <tbody>
244 <tr><td>Simple<td>Installer has .esp, .esm and/or .bsa files, and/or any of the standard game subdirectories at the top level of the package/project.
245 <tr><td>Complex<td>Installer has top-level subdirectories that each have a simple structure (as defined above). The top level subdirectories
246 (known as subpackages) <b>must not have the same name as any of the regular game subdirectories for this game.</b>
247 Each top-level subdirectory will be treated as a sub-package, and can be independently activated or deactivated as desired.
248 <tr><td>Complex/Simple<td>A complex installer with only one top-level subdirectory. It is treated as a simple installer, starting at this
249 top level subdirectory. Examples include mods packaged with a top-level Data directory.
250 </table>
251
252 <p>You must dump your installer in <code>Bash Installers</code> directory which is created the first time Bash runs inside the <code>"Game" Mods</code> directory. This directory is by default
253 created on the same level as your game directory (that is if your game exe is located in "C:\GAMES\TESIV\Oblivion" then by default Bash will create the "C:\GAMES\TESIV\Oblivion Mods\"
254 directory on first run, but you can point Bash to create this "Game" Mods directory wherever you want (or point it to an existing one) via the <code>sOblivionMods</code> ini setting. Do
255 <i>not</i> however put it inside the game Data directory, as the game may well be confused and scan it adding to performance, mods thrashing and whatnot. To add an installer to the Bash
256 Installers dir it's enough to drag and drop it on the installers list.
257 <p>Bash will scan the Bash Installers directory and pick up all subfolders and all <code>.zip</code>, <code>.7z</code> or <code>.rar</code> archives - except for:
258
259 <ol>
260 <li>folders or files that begin with <code>--</code> will be skipped
261 <li>a <code>Bain Converters</code> subdir of Bash Installers will be skipped
262 <li>folders or files that begin with <code>bash</code> will be skipped
263 <li>you may specify additional directories to be skipped via the <code>sSkippedBashInstallersDirs</code> ini setting
264 </ol>
265
266 <p>Now BAIN will try to classify the packages it detected in Bash Installers into its package formats - if it fails the package will display as unrecognized and will have to
267 be restructured.
268
269 <h3 id="bain-convert">Restructuring Packages to be BAIN-Compatible</h3>
270 <p>The easiest way to tell if a package needs manual converting to be compatible with BAIN is to try installing it. If it is listed in the Package list with a grey checkbox and name, then BAIN cannot install it. Due to BAIN's flexibility, many mods are already packaged in ways that are compatible, but for those that are not, there are a few possible cases:
271 <ul>
272 <li>The mod has a <abbr title="BAIN Conversion File">BCF</abbr>. BCFs are special packages that tell BAIN how to restructure the mod to be compatible with BAIN without the user having to do any work.
273 <li>The mod is distributed as an OMOD (ie. has file extension <code>.omod</code>). These mods are intended for installation with the Oblivion Mod Manager or Nexus Mod Manager. Such mods usually have a non-OMOD download option: if one is available, download that instead as it is more likely to be compatible. Otherwise, OMOD files can be converted to Projects automatically by dragging and dropping them into the Installers tab.
274 <li>The mod is distributed as an archive, or is a converted OMOD Project, but doesn't have a folder structure that BAIN recognises. It will need manual restructuring.
275 <li>The mod is distributed as an executable (ie. has file extension <code>.exe</code>). This is very rare, as mods do not require the complexity of executables, and the greater security risk executables represent makes their use unpopular. BAIN cannot install mods distributed in this way: often the only way to install them is to run the executable. You can often run the installer, installing to a dummy folder, and then repack the <q>installed</q> files into a BAIN-compatible format.
276 </ul>
277 <p>If an archive has a BCF, it can be converted for installation with BAIN using the following instructions.
278 <ol>
279 <li>Ensure that the BCF is installed in the correct location, <code>[Game] Mods\Bash Installers\Bain Converters</code>. Also ensure that the archive(s) it converts is/are in <code>[Game] Mods\Bash Installers</code>.
280 <li>From the BAIN installers list, select the archive(s) to be converted (i.e., the <q>source</q> packages) and right click on the selected file(s) to bring up the context menu, and select <a href="Wrye%20Bash%20Advanced%20Readme.html#bainConversion">Conversions</a> to open the sub-menu.
281 <li>Click on <i>Apply</i> to open a second sub-menu and select the BCF from it. There may be more than one BCF listed if multiple installed BCFs can convert the selected package(s).
282 An asterisk ('*') is added to the end of a BCF's name for every archive it converts that isn't selected.
283 <li>Optionally choose a name for the converted archive(s).
284 <li>Once Wrye Bash has finished the conversion, the converted archive(s) will appear in the BAIN package list ready for install. You can now delete the original archive(s).
285 </ol>
286 <p>If a package is unrecognised by BAIN and has no associated BCF, its contents will have to be rearranged so that the structure matches one of the three types of BAIN-compatible package structures.
287
288 <h3 id="bain-install">Installing/Uninstalling Via BAIN</h3>
289 <p>Packages must first be placed in the <code>[Game] Mods\Bash Installers</code> directory. This can either be done via Windows Explorer, or by dragging and dropping the package into the Wrye Bash window when the Installers tab is open. If you drag and drop, you will be asked whether you want to copy the package or move it.
290 <p>If a package contains a Wizard (ie. there is <img src="../bash/images/wizard.png" alt="a wand icon"/> overlaid on its checkbox):
291 <ol>
292 <li>Right-click the package and select <a href="#bainWizard">Wizard</a>. You can also choose to install using the Wizard's default options by selecting <a href="#bainAutoWizard">Auto Wizard</a>.
293 <li>If you chose <a href="#bainWizard">Wizard</a>, navigate through the steps of the Wizard to install the package. Otherwise, you will be skipped to the Wizard finish screen.
294 <li>At the Wizard's finish screen, click the <q>Apply</q> button to apply its selections. The Wizard window may need to be resized for the <q>Apply</q> button to become visible.
295 </ol>
296 <p>If a package has a Simple or a Complex/Simple structure:
297 <ol>
298 <li>Select the package in the package list.
299 <li>Choose which plugins to install from it using the <q>Esp/m Filter</q> box to the far right of the package list. Checked plugins will be installed, while unchecked plugins will be skipped.
300 <li>Right-click the package and select <a href="#bainInstall">Install</a>.
301 </ol>
302 <p>If a package has a Complex structure:
303 <ol>
304 <li>Select the package in the package list.
305 <li>Choose which sub-packages to install from the <q>Sub-Package</q> box to the right of the package list. Checked sub-packages will be installed, while unchecked sub-packages will be skipped.
306 <li>Choose which plugins to install from it using the <q>Esp/m Filter</q> box to the far right of the package list. Checked plugins will be installed, while unchecked plugins will be skipped.
307 <li>Right-click the package and select <a href="#bainInstall">Install</a>.
308 </ol>
309 <p>If you install a package then later change the sub-packages or esp/m files selected, you can apply these changed by right-clicking the package in the list and selecting <a href="#bainAnneal">Anneal</a>. A Wizard provides a scripted installation method that can be useful for more complex mods with many options.
310 <p>When a package is installed, BAIN installs any files that appear to be documentation into the <code>Data\Docs</code> folder. Any files that are simply named <q>readme</q> (eg. readme.txt, readme.html, readme.doc) will be renamed according to the package name to prevent packages overwriting each other's readmes.
311 <p>To uninstall any package from the Installers tab select the package
312 and right click on it, then select <a href="#bainUninstall">Uninstall</a>.
313 This will uninstall
314 all Matched files. However, BAIN will not uninstall Mismatched files.
315 A Mismatched file is a file that has been altered after it was
316 installed. The reason BAIN does not uninstall Mismatched files is BAIN
317 has no way of tracking the source of the alteration if it was not
318 done through BAIN. For example, if the file was altered because it was
319 replaced by another mod that was installed manually,
320 then uninstallation of the Mismatched file may not be desirable. On
321 the other hand, if the file was altered because it was cleaned or
322 edited with TESxEdit, or because it was an ini file that was edited
323 with a text editor, then it may be desired to uninstall the Mismatched
324 file along with the package that it came from. Such files could be
325 deleted from the data folder manually, but there is an easy way to do
326 this through BAIN. Before uninstalling the mod, first select the
327 package and right click on it, then select <a href="#bainInstall">Install</a>.
328 This will
329 overwrite any Mismatched files with the version of the file contained
330 in the package, making them Matched. Now select <a href="#bainUninstall">Uninstall</a>
331 and BAIN
332 will uninstall all installed files associated with this package.
333 You can also uninstall packages that BAIN hasn't installed, which will
334 remove any installed files that match the ones in the package. This
335 is useful for cleaning out mods that were manually installed. Of course you
336 need to add the packages to BAIN first.
337 Uninstalling via BAIN respects the ownership of files,
338 ie. uninstalling a mod that contains files also installed by a mod
339 listed lower in the installation order will not uninstall the lower
340 mod's files. See the next section, BAIN Package Order for more on
341 this. However, if the Auto-Anneal option is enabled (the default), then files
342 from other packages previously overridden by the uninstalled package's
343 files will be automatically restored.
344
345 <h3 id="bain-order">BAIN Package Order</h3>
346 <p>The install order of packages in BAIN is important as this decides which mod gets its files installed in the case of resource conflicts. Packages may be listed in install order by left-clicking on the <q>Order</q> column header. If two mods try to install the same file, then the mod lower down in the list will have its file overwrite the file of the mod higher up in the list.
347 <p>The order of sub-packages within a package follow the same rules as packages. Checked sub-packages lower in the sub-package list will overwrite conflicting content from sub-packages above them.
348 <p>Package conflicts are detailed in the <q>Conflicts</q> tab to the right of the package list when you select a package. This tab tells you which packages have which files that conflict with files in your currently-selected package. It gives this information for packages both above and below the selected package in the package list.
349 <p>BAIN allows you to easily adjust the conflict status of packages by moving their order around. This can be done by dragging and dropping packages within the list, or by right-clicking packages and selecting the <a href="#bainMoveTo">Move To...</a> option. You can also select multiple packages and move them, in which case they will be moved as a group, retaining their order relative to one another in their new location. A third option is to select the package(s) and use Ctrl-Up or Ctrl-Down to move them up or down respectively.
350
351 <h3 id="bain-symbols">What Symbols &amp; Colours Mean</h3>
352 <p>BAIN uses the colours of packages in the package list and the state of their checkboxes to convey information about their status to the user. A checkbox state may be combined with any checkbox or text colour, and the possible states and colours are described in the tables below.
353 <p><b>Note:</b> Installed packages are marked with a plus, eg. <img src="../bash/images/checkbox_green_inc.png" width="16" height="16" alt="+"/>. Corrupt or incomplete packages are marked with a cross, eg. <img src="../bash/images/checkbox_red_x.png" width="16" height="16" alt="a cross"/>. Packages that begin and end with <q>==</q>, eg. <q>==Last==</q>, are marker packages. They don't represent an archive or folder and so contain no files, but may be used to organise the package list.
354 <table>
355 <thead><tr><th>Checkbox Shape<th>Meaning
356 <tbody>
357 <tr><td><img src="../bash/images/diamond_white_off.png" width="16" height="16" alt="diamond"/><td>The package is a Project, ie. a directory rather than an archive.
358 <tr><td><img src="../bash/images/checkbox_white_off.png" width="16" height="16" alt="checkbox"/><td>The package is an archive.
359 </table>
360 <table>
361 <thead><tr><th>Checkbox Colour<th>Meaning
362 <tbody>
363 <tr><td><img src="../bash/images/checkbox_green_off.png" width="16" height="16" alt="green"/><td>All the files in the package are installed as configured.
364 <tr><td><img src="../bash/images/checkbox_red_off.png" width="16" height="16" alt="red"/><td>Some or all of the files in the package are not installed as configured.
365 <tr><td><img src="../bash/images/checkbox_orange_off.png" width="16" height="16" alt="orange"/><td>All the package files are installed, but the .esp/.esm plugins are not identical (eg. another package has overwritten them with another version of the plugins).
366 <tr><td><img src="../bash/images/checkbox_yellow_off.png" width="16" height="16" alt="yellow"/><td>All the package files are installed, but some resource (ie. non-plugin) files are not identical (eg. another package has overwritten them with another version of the files)
367 <tr><td><img src="../bash/images/checkbox_white_off.png" width="16" height="16" alt="white"/><td>The package, as configured, has no files to install. This can happen for complex packages where none of the sub-packages are selected for installation.
368 <tr><td><img src="../bash/images/checkbox_grey_off.png" width="16" height="16" alt="grey"/><td>BAIN does not recognise the structure of this package so cannot install it.
369 </table>
370 <table>
371 <thead><tr><th>Text Formatting<th>Meaning
372 <tbody>
373 <tr><td style="color:#000080;">Navy Blue<td>The package contains sub-packages.
374 <tr><td style="color:#BEBEBE;">Grey<td>BAIN does not recognise the structure of this package so cannot install it.
375 <tr><td style="background:#FFBB33;">Orange Background<td>The install is dirty. This will occur for packages for which the configuration has been altered (either by altering active sub-packages and esmps, or by altering the package itself). This can be repaired by running <a href="#bainAnneal">Anneal</a> or <a href="#bainAnnealAll">Anneal All</a>.
376 <tr><td style="background:yellow;">Yellow Background<td>The package has "underrides" i.e. some of its installed files <i>should</i> be overridden by higher order packages. This may happen after reordering mods that have already been installed. It can be repaired by running <a href="#bainAnneal">Anneal</a> or <a href="#bainAnnealAll">Anneal All</a>.
377 <tr><td style="background:#E0E0E0;">Grey Background<td>Some files present in the package will <i><b>not</b></i> be installed. This can be due to having a complex structure only partially handled by BAIN, or having file types that BAIN skips. This can sometimes be fixed by telling BAIN that the package <a href="#bainHasExtraDirectories">Has Extra Directories</a> by ticking that option in the right-click menu.
378 </table>
379
380 <h3 id="bain-commands">Useful Context Menu Commands</h3>
381 <p>The following commands found in the package and column header context (ie. right-click) menus are often useful for many users.
382 <table>
383 <thead>
384 <tr><th colspan="2">Column Header Context Menu
385 <tr><th>Command<th>Description
386 <tbody>
387 <tr><td>Open...<td>Opens the Installers directory in Windows Explorer.
388 <tr><td>Refresh Data<td>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. BAIN refreshes itself automatically if changes are made to packages in the Bash Installers directory.
389 <tr><td>Add Marker...<td>Creates a marker for organising your packages. The <q>==</q> prefix and suffix will be added for you.
390 <tr><td>List Packages<td>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.
391 <tr><td>Uninstall All Packages<td>Uninstalls all the packages in the package list.
392 <tr><td>Clean Data<td>Removes files from the Data folder that are not from one of the following sources:
393 <ul>
394 <li>Vanilla game content.
395 <li>Official DLC content.
396 <li>Wrye Bash.
397 <li>Installed BAIN packages.
398 </ul>
399 The files are not deleted, but moved to the <code>[Game] Mods\Bash Installers\Bash\Data Folder Contents [timestamp]</code> folder instead, where <code>[timestamp]</code> is the date and time the command was run.
400 <tr><td id="bainAnnealAll">Anneal All<td>Installs any missing files for active installers and corrects all install order errors.
401 <tr><td>Unhide...<td>Opens a dialogue window allowing you to select which hidden packages to unhide.
402 <tr><td>Skip OBSE Plugins<td><i>Oblivion only.</i> If this is checked, files in the Data\OBSE\Plugins folder will not be installed.
403 <tr><td>Skip SKSE/Script Dragon Plugins<td><i>Skyrim only.</i> If this is checked, files to go in the Data\SKSE\Plugins or Data\asi folder will not be installed.
404 </table>
405 <table>
406 <thead>
407 <tr><th colspan="3">Package Context Menu
408 <tr><th colspan="2">Command<th>Description
409 <tbody>
410 <tr><td colspan="2">Open...<td>Opens the selected package(s) in the file system.
411 <tr><td colspan="2">Duplicate...<td>Makes a duplicate of the selected package(s).
412 <tr><td colspan="2">Delete<td>Deletes the selected package(s). Deleted packages are <b>not</b> sent to the Recycling Bin, they are permanently deleted.
413 <tr><td colspan="2">Open At...<td>Attempts to open the selected package's page on the selected site. If Google is selected, performs a Google search for the package name. For the other three sites, this command assumes that the trailing digits in a package's name is the package ID at the sites. If this assumption is wrong, a random page, or an error page, will be opened.
414 <tr><td colspan="2">Hide<td>Hides the selected package in the list, and moves it to the <code>[Game] Mods/Bash Mod Data/Hidden</code> folder.
415 <tr><td colspan="2">Rename<td>Renames the selected package or marker.
416 <tr><td colspan="2">Refresh<td>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 <a href="Wrye%20Bash%20Advanced%20Readme.html#bainDontRefresh">Don't Refresh</a> selected, or the <a href="Wrye%20Bash%20Advanced%20Readme.html#bainAutoRefreshProjects">Auto-Refresh Projects</a> option is disabled. Note that scanning a project for changes takes much longer than scanning an archive for changes.
417 <tr><td colspan="2" id="bainMoveTo">Move To...<td>Moves the selected package(s) to the specified position.
418 <tr><td colspan="2">Open readme<td>If BAIN detects a readme in the package, it will be opened.
419 <tr><td colspan="2" id="bainHasExtraDirectories">Has Extra Directories<td>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.
420 <tr><td colspan="2" id="bainWizard">Wizard<td>Runs the Wizard for the package, if it has one.
421 <tr><td colspan="2" id="bainAutoWizard">Auto Wizard<td>Runs the Wizard for the package, if it has one, selecting the default options.
422 <tr><td colspan="2" id="bainAnneal">Anneal<td>Installs missing files and corrects install order errors according to the package configuration.
423 <tr><td colspan="2" id="bainInstall">Install<td>Fully installs the package as configured except for files that would be overridden by later packages.
424 <tr><td colspan="2" id="bainUninstall">Uninstall<td>Uninstalls the package. If <a href="Wrye%20Bash%20Advanced%20Readme.html#bainAutoAnneal">Auto-Anneal</a> is active (the default) then files from earlier packages that were previously overridden will be installed as required.
425 <tr><td id="bainApply">Conversions<td>Apply<td>Applies a BAIN Conversion File.
426 <tr><td colspan="2">List Structure<td>Generates a list of the files and directories in a package. Useful for posting package structure on forums, eg. when troubleshooting an install.
427 </table>
428
429
430 <h2 id="load">Setting Up Load Order</h2>
431 <figure>
432 <img src="../bash/images/readme/mods-1.png" alt="Mods Tab"/>
433 <figcaption>Wrye Bash's Mods tab.</figcaption>
434 </figure>
435 <h3 id="load-overview">Overview</h3>
436 <p>Wrye Bash displays your installed plugins in its <q>Mods</q> tab. Your load order of active installed plugins, which Wrye Bash marks with a
437 ticked checkbox, is important as it decides what plugin 'wins' any conflict between plugins, with later loading plugins overriding those
438 that change the same thing. <b>Load order is not the same thing as BAIN install order!</b> Install order determines which mods' files overwrite
439 other mods' files when they conflict. Load order determines which plugins' effects override other plugins' effects in-game when they conflict.
440 <p>Although in general "Load Order" stands for the load order of the <i>active</i> plugins, all installed plugins have a load order assigned
441 to them. In Oblivion this is based on the modification time of the plugin, in Skyrim based to an agreed upon text-file based standard,
442 while Fallout 4 finally dumps all installed plugins in its plugins.txt, marking active ones with an asterisk. Bash needs plugins load
443 order even for inactive plugins to correctly merge inactive mods in the bashed patch, among others.
444 <p>Plugins may be activated by clicking their checkbox so that it is ticked, or by selecting a plugin or group of plugins and pressing the
445 space bar on your keyboard. Plugins may be deactivated by again clicking their checkbox or pressing the spacebar. If a group of selected
446 plugins contains a mix of active and inactive plugins, pressing the space bar once will activate them all, thereafter it will function as normal.
447 <p>Some plugins are explicitly dependent on other plugins - they have these plugins as <q>masters</q>. When a plugin is activated, its masters are also activated. Conversely, when a plugin upon which other plugins depend is deactivated, those plugins are also deactivated.</p>
448 <p>When setting the load order, make sure that Wrye Bash is displaying your plugins sorted by Load Order. Do so by clicking on the <q>Load Order</q> column header near the top of the tab. You can also display the plugins sorted by other attributes by clicking on any of the other column headers. Clicking twice will reverse the display order for any column but Load Order. The load order of plugins is given in hexadecimal digits, from 00 to FE, which is 0 to 254 in decimal. (This number also forms the first two digits of a record's Form ID.)
449 <p>Note that you can only have a maximum of 255 plugins active at any one time, including your game's master file (eg. Oblivion.esm, Skyrim.esm).
450 Wrye Bash displays a plugin count in its status bar, to the right hand side, in the format <code>Mods: [active]/[installed]</code>.
451
452 <h3 id="load-set">Setting The Load Order</h3>
453 <p>Setting up a correct load order that minimises detrimental conflicts that could cause issues in-game can be a difficult and time-consuming process. Effective load-ordering often requires a knowledge of what each plugin in your load order contains so that you can position the plugins to minimise these conflicts. For simple mods, the description in the mod's readme will usually be sufficient to determine the records it contains, but to be sure a utility such as TES4Edit is required.
454 <p><a href="http://boss-developers.github.io">BOSS</a> can be used to greatly simplify the process of setting the load order, as it can correctly position thousands of plugins automatically. However, you may still need to order some plugins manually.
455 <p>Wrye Bash provides a number of ways for you to set up your load order:
456 <ul>
457 <li>Alphabetical sorting by selecting a group of plugins and choosing File->Sort from the right-click menu.
458 <li>Moving plugins up or down the load order by selecting them and using Ctrl-Up or Ctrl-Down respectively. This also works with groups of plugins and preserves the group's internal order.
459 <li>Dragging and dropping plugins will also change the load order if the plugins are being sorted by Load Order.
460 <li><i>Oblivion only.</i> Selecting a group of plugins and choosing File->Redate from the right-click menu. This will move the first plugin to the specified date/time and position the others at one minute intervals after it.
461 <li><i>Oblivion only.</i> Editing plugin modification dates in the right-hand details panel.
462 </ul>
463 <p>When running Wrye Bash, you can also lock your load order in place to prevent unintended changes to it by selecting the <a href="#modsLockLoadOrder">Lock Load Order</a>
464 option in the column header right-click menu. Note that this will prevent other utilities from changing the load order, so uncheck this option if you use such a
465 utility to set your load order. If you use BOSS to manage your load order and you also use Lock Load Order, ensure
466 <a href="#launchersBOSSDisableLockLoadOrder">BOSS Disable Lock Load Order</a> is also enabled to allow BOSS to function correctly.
467 <p>Note that for Skyrim Wrye Bash will automatically undo any changes to load order done made by the Skyrim launcher or any utility that does not follow the textfile-based
468 load order standard in order to maintain a fully coherent load order. This effectively means that unintended changes are prevented.
469 <figure>
470 <img src="../bash/images/readme/toolbar-12-rclick-hide-boss.png" alt="toolbar hide launcher"/>
471 <figcaption>BOSS's Launch Using GUI option.</figcaption>
472 </figure>
473 <p>The <q>Launch Using GUI</q> toggles the use of the command line interface for BOSS with the BOSS GUI. Giving quick and easy access to the additional features the GUI provides such as the <q>Edit User Rules</q> option.
474
475 <h3 id="load-undo">Undo and redo Load Order changes</h3>
476 <p>Bash features a sophisticated undo/redo load order feature, comprising both load order changes <i>of active <b>or</b> inactive
477 plugins</i> and activating/de-activating plugins. Whether you activate a plugin, drag and drop it in another position, deactivate a
478 plugin (having its children deactivated too) etc, you can always hit <code>Ctrl+Z</code> <i>while the list of mods has focus</i> to undo
479 the operation or <code>Ctrl+Y</code> to redo it. Bash keeps the load orders (meaning total load order of <i>all</i> installed plugins
480 and active state of the plugins) in its internal structures and will persist those on disc on shutting down,
481 in <code>My Games\&lt;Game>\BashLoadOrders.dat</code>, so you can undo/redo on restarting Bash.
482 <p>The undo/redo feature will try to preserve as many load orders as possible - so unlike undo/redo in other applications if you have an
483 initial load order state A then change it to B, then hit undo (so you are back on state A), then change it to C Bash will keep in its
484 internal structures the load order states A C B while most other applications would end up with A C. Undo/redo load order state is a
485 relatively new feature (available in 307 beta) so it may have rough edges.
486
487 <h3 id="load-symbols">What Symbols &amp; Colours Mean</h3>
488 <p>Like in the Installers tab, Wrye Bash uses colour-coding and other formatting effects to convey information about the state of plugins. The different types of formatting used and their meanings are explained here.
489 <table>
490 <thead><tr><th>Checkbox Type<th>Meaning
491 <tbody>
492 <tr><td><img src="../bash/images/checkbox_green_on.png" width="16" height="16" alt="Active" /><td>Plugin is active.
493 <tr><td><img src="../bash/images/checkbox_green_inc.png" width="16" height="16" alt="Merged" /><td>Plugin is merged into an active <a href="#patch">Bashed Patch</a>.
494 <tr><td><img src="../bash/images/checkbox_green_imp.png" width="16" height="16" alt="Imported" /><td>Plugin is imported into an active <a href="#patch">Bashed Patch</a>.
495 <tr><td><img src="../bash/images/checkbox_green_off.png" width="16" height="16" alt="Inactive" /><td>Plugin is not active, merged or imported.
496 </table>
497 <table>
498 <thead><tr><th>Checkbox Colours<th>Meaning
499 <tbody>
500 <tr><td><img src="../bash/images/checkbox_blue_on.png" width="16" height="16" alt="Blue" /><td>The plugin's masters are all in exactly the same order as is specified in the plugin.
501 <tr><td><img src="../bash/images/checkbox_green_on.png" width="16" height="16" alt="Green" /><td>The plugin's masters are in the same order as is specified in the plugin, but their precise positions are different (ie. there are other mods between them). This is not an issue, and can be considered to be just as good as having a blue checkbox.
502 <tr><td><img src="../bash/images/checkbox_orange_on.png" width="16" height="16" alt="Orange" /><td>Some of the plugin's masters are in a different order than what is specified in the plugin. This will generally be handled automatically by the game, but it may result in changes in-game.
503 <tr><td><img src="../bash/images/checkbox_red_on.png" width="16" height="16" alt="Red" /><td>One or more of the plugin's masters is missing. This will generally cause the game to crash on startup, and must be corrected.
504 </table>
505 <table>
506 <thead><tr><th>Text Formatting<th>Meaning
507 <tbody>
508 <tr><td style="color:blue;">Blue text<td>A .esm plugin.
509 <tr><td style="color:green;">Green text<td>A mergeable plugin.
510 <tr><td style="color:purple;">Purple text<td>A plugin that should not be merged (ie. tagged with NoMerge).
511 <tr><td style="background:#FFDCDC;">Pink background<td><i>Oblivion only.</i> A plugin that shares its modification date with another plugin. Not a problem unless both plugins are active.
512 <tr><td style="background:#FF6464;">Red background<td>An active plugin that should remain deactivated (ie. tagged with Deactivate) or, for Oblivion only, an active plugin that shares its modification date with another active plugin. This must be corrected so that they have different modification dates or else it may break your load order.
513 <tr><td style="background:#FF9900;">Orange background<td>An <a href="Wrye%20Bash%20Advanced%20Readme.html#mods-exclusion">exclusion group</a> violation. This should be corrected.
514 <tr><td style="background:#E8E8E8;">Grey background<td>A <a href="#modsAutoGhost">ghosted</a> plugin.
515 <tr><td style="font-style:italic;">Slanted text<td>A plugin that is recommended to be imported and deactivated (ie. tagged with Deactivate).
516 <tr><td style="text-decoration:underline;">Underlined text<td>A plugin identified as having dirty edits (Identical to Master, Deleted References, or otherwise necessary cleaning).
517 </table>
518
519 <h3 id="load-commands">Useful Context Menu Commands</h3>
520 <p>The context menus for the column headers and plugins contain a large number of commands, most of which are unlikely to be of use to the average user so are not detailed here.
521 <table>
522 <thead>
523 <tr><th colspan="3">Column Header Context Menu
524 <tr><th colspan="2">Command<th>Description
525 <tbody>
526 <tr><td>File<td>New Bashed Patch...<td>Creates a new <a href="#patch">Bashed Patch</a> plugin. Useful if you accidentally delete your current one or wish to have more than one.
527 <tr><td colspan="2" id="modsListMods">List Mods<td>This lists the 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.
528 <tr><td colspan="2" id="modsListBashTags">List Bash Tags<td>This lists 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.
529 <tr><td colspan="2" id="modsAutoGhost">Auto-Ghost<td>The Oblivion game engine has a bug where it reads all the plugins in the Data folder,
530 and this can affect performance when the number of plugins is around 300+. In Skyrim there is a different problem, namely if you have over
531 508 mod files in your data directory, the engine just plain refuses to load any of them, active or not (see here:
532 http://forums.bethsoft.com/topic/1369136-thrashing-thread-1/?hl=+508). Auto-Ghosting adds a <q>.ghost</q> extension to all
533 inactive plugins automatically to prevent the game engine reading them, and so helping to avoid the performance drop. When a ghosted
534 plugin is activated, the <q>.ghost</q> extension is removed, allowing it to function as normal. Note that most other utilities will not
535 recognise ghosted plugins, so there are options available for individual plugins to control which get ghosted.
536 Bash displays a warning if a lot of mods and BSAs are detected that you can disable via the ini.
537 <tr><td colspan="2" id="modsLockLoadOrder">Lock Load Order<td>This prevents other utilities from altering plugin modification times. More accurately, it detects
538 changes to modification times when Wrye Bash starts or is focused (ie. on top of all other program windows) and reverses those changes.
539 </table>
540 <table>
541 <thead>
542 <tr><th colspan="2">Plugin Context Menu
543 <tr><th>Command<th>Description
544 <tbody>
545 <tr><td>List Masters...<td>Outputs a list of the selected plugin's masters.
546 <tr><td>List Bash Tags...<td>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.
547 <tr><td>Create BOSS Report...<td>Outputs the plugin filename, <abbr title="Cyclic Redundancy Check">CRC</abbr>, and <abbr title="Identical To Master record">ITM</abbr>/<abbr title="Undeleted and Disabled Reference">UDR</abbr> count for easy reporting of the plugin to an official BOSS thread.
548 <tr><td>Copy Mod Info...<td>Outputs a report on the selected plugins(s) with the info from the currently displayed columns.
549 <tr><td>Don't Ghost<td>Don't ghost this plugin when it is inactive, even if <a href="#modsAutoGhost">Auto-Ghost</a> is enabled.
550 <tr><td>Ghost<td>Ghost this plugin when it is inactive even if <a href="#modsAutoGhost">Auto-Ghost</a> is disabled.
551 <tr><td id="modsRebuildPatch">Rebuild Patch...<td>Rebuild the selected Bashed Patch using the Python patcher.
552 <tr><td id="modsRebuildPatchCBash">Rebuild Patch (CBash *Beta*)...<td><i>Oblivion only.</i> Rebuild the selected Bashed Patch using the CBash patcher.
553 </table>
554
555
556 <h2 id="patch">Setting Up A Bashed Patch</h2>
557 <figure class="slideshow">
558 <img src="../bash/images/readme/bashed-patch-dialogue-1.png" alt="Bashed Patch"/>
559 <img src="../bash/images/readme/bashed-patch-dialogue-2.png" alt="Bashed Patch"/>
560 <img src="../bash/images/readme/bashed-patch-dialogue-3.png" alt="Bashed Patch"/>
561 <img src="../bash/images/readme/bashed-patch-dialogue-4.png" alt="Bashed Patch"/>
562 <figcaption style="padding-top:620px;">Wrye Bash's Bashed Patch configuration dialog.</figcaption>
563 </figure>
564 <h3 id="patch-overview">Overview</h3>
565 <p>A Bashed Patch is a configurable plugin with three main functions:
566 <ul>
567 <li>Merging plugins into itself. Merged plugins can be deactivated, avoiding the 255 plugin limit.
568 <li>Importing specific types of data records from plugins. This can be used to avoid compatibility issues.
569 <li>Applying tweaks to the game. This avoids the need to use other mods to apply the same tweaks.
570 </ul>
571 <p>A Bashed Patch is created by Wrye Bash the first time you run it, with the plugin being called <q><b>Bashed Patch, 0.esp</b></q>. It is configured using the plugin context menu commands <a href="#modsRebuildPatch">Rebuild Patch...</a> or <a href="#modsRebuildPatchCBash">Rebuild Patch (CBash *Beta*)...</a>. <strong>You should rebuild your Bashed Patch every time you change your load order, before playing the game.</strong> The Bashed Patch should be last in your load order, unless you have plugins that explicitly state that they must load last.
572 <p>The configuration dialog consists of a list of major sections to the left, and the contents of the selected section to the right, with the build and save buttons at the bottom. The sections and their items have checkboxes: checking a section will include all its checked items in the Bashed Patch. Unchecked sections and items will not be included. Some sections don't have any items, and so just need the section checkbox checked.
573 <p>A short description of each section and some items is displayed near the bottom of the window if the section/item is hovered over. Bolded items are new since the last time the Bashed Patch was built. Wrye Bash will try to auto-configure most sections, but some will still need tweaking.
574 <p><b>Note:</b> There are currently two methods of building a Bashed Patch. One uses Python, and the other uses CBash, which is a software library written to speed up the reading of plugins. Both methods offer the same options. The CBash method is faster and allows more types of plugin to be merged, but contains some bugs as CBash is still a work in progress. CBash will become the default in the near future, once its bugs have been fixed. For now, it is probably safer to use the Python method.
575 <table>
576 <thead>
577 <tr><th colspan="2">Bashed Patch Configuration Buttons
578 <tr><th>Button<th>Description
579 <tbody>
580 <tr><td>Build Patch<td>Builds your Bashed Patch with the current configuration.
581 <tr><td>Select All (next to section list)<td>Selects all the options/plugins in a section list. If an option has multiple possible values, the first value in the value list will be chosen.
582 <tr><td>Deselect All (next to section list)<td>Deselects all the options/plugins in a section list.
583 <tr><td>Select All (at bottom of window)<td>Selects all sections, and all the options/plugins in all sections. If an option has multiple possible values, the first value in the value list will be chosen.
584 <tr><td>Deselect All (at bottom of window)<td>Deselects all sections and all the options/plugins in all section list.
585 <tr><td>Revert To Default<td>Reverts your Bashed Patch to its default configuration.
586 <tr><td id="patchRevertToSaved">Revert To Saved<td>Restores the last saved configuration of your Bashed Patch, undoing any changes since you last built it.
587 <tr><td>Export<td>Saves your Bashed Patch's configuration into an external file for backup.
588 <tr><td>Import<td>Restores your Bashed Patch's configuration from an exported patch configuration.
589 </table>
590
591 <h3 id="patch-merging">Merging Plugins</h3>
592 <p>Plugins that contain only certain types of data records can be merged into the Bashed Patch. This then allows these plugins to be deactivated, freeing up space in your load order.
593 <p>If you're merging plugins in, you do not need the plugins active to do so. In fact, trying to merge them in Bash will 1 - ask you to deactivate them
594 before hand, and 2 - deactivate them even if you refused that prompt after the Bashed Patch has been created.
595 So if you're merging plugins, leave them inactive before building, then select to merge them in the Bashed Patch build dialog. Don't worry,
596 all the algorithms for the rest of the patchers still work as you'd expect on plugins merged this way.
597 <p>You should check the checkboxes of all the plugins listed in the <q>Merge Patches</q> section, and ensure the section is checked too.
598 <p><b>Do not remove merged mods from your Data folder.</b> They will need to be present when you next rebuild your Bashed Patch.
599
600 <h3 id="patch-importing">Importing From Plugins</h3>
601 <p>Plugins can be tagged with Bash Tags that tell Wrye Bash that they contain certain changes that should be preserved even if another mod also changes the same things. This is usually because the changes are important to the functionality of the mod. Wrye Bash then allows you to choose which plugins should have which types of changes preserved, by selecting from the various Import sections when building a Bashed Patch.
602 <p>If a section's description in the table below begins with <q>Preserves</q> and two or more mods in its list change the same thing, then the later-loading plugin will override the other plugin(s). Otherwise changes are merged.
603 <table>
604 <thead><tr><th>Section<th>Description<th>When You Should Use It
605 <tbody>
606 <tr><td>Import Actors<td><i>Oblivion only.</i> Preserves changes made to actors (ie. NPCs and creatures) by the mods selected.<td>Always, unless you are told otherwise by a mod's readme.
607 <tr><td id="patchImportActorsAIPackages">Import Actors: AIPackages<td><i>Oblivion only.</i> Merges the changes made to actor AI packages by all the mods selected.<td>Always, unless you are told otherwise by a mod's readme.
608 <tr><td>Import Actors: Animations<td><i>Oblivion only.</i> Merges the changes made to actor animations by all the mods selected.<td>Always, unless you are told otherwise by a mod's readme.
609 <tr><td>Import Actors: Death Items<td><i>Oblivion only.</i> Preserves the changes made to the items added to an actor when it dies by the mods selected.<td>Always, unless you are told otherwise by a mod's readme.
610 <tr><td id="patchImportActorsSpells">Import Actors: Spells<td><i>Oblivion only.</i> Preserves the changes made to the spells actors have by the mods selected.<td>Always, unless you are told otherwise by a mod's readme.
611 <tr><td id="patchImportCells">Import Cells<td><i>Oblivion only.</i> Preserves the changes made by the mods selected to cell settings such as lighting, climate, music, name, owner, water and more.<td>Always, unless you are told otherwise by a mod's readme.
612 <tr><td>Import Factions<td><i>Oblivion only.</i> Preserves the changes made to the factions an actor belongs to by the mods selected.<td>Always, unless you are told otherwise by a mod's readme.
613 <tr><td id="patchImportGraphics">Import Graphics<td><i>Oblivion only.</i> Preserves the changes made by the mods selected to various textures and models throughout the game.<td>The decision is entirely based on user preference. Choose whichever mods' graphics you prefer.
614 <tr><td id="patchImportInventory">Import Inventory<td><i>Oblivion only.</i> Merges the changes made to the items in an actor's inventory by all the mods selected.<td>Always, unless you are told otherwise by a mod's readme.
615 <tr><td id="patchImportNPCFaces">Import NPC Faces<td><i>Oblivion only.</i> Preserves the changes made to NPC faces by the mods selected.<td>The decision is entirely based on user preference. Choose whichever mods' NPC faces you prefer.
616 <tr><td id="patchImportNames">Import Names<td><i>Oblivion only.</i> Preserves the changes made to various names throughout the game by the mods selected.<td>The decision is entirely based on user preference. Choose whichever mods' names you prefer.
617 <tr><td id="patchImportRelations">Import Relations<td><i>Oblivion only.</i> Preserves the changes made by the mods selected to how factions interact.<td>Always, unless you are told otherwise by a mod's readme.
618 <tr><td>Import Roads<td><i>Oblivion only.</i> Preserves the changes made by the mods selected to the landscape's roads.<td>Always, unless you are told otherwise by a mod's readme.
619 <tr><td>Import Script Contents<td><i>Oblivion only.</i> Copies scripts from the selected mods into the Bashed Patch.<td>Never.
620 <tr><td>Import Scripts<td><i>Oblivion only.</i> Preserves the changes made by the mods selected to the scripts attached to things in the game.<td>Always, unless you are told otherwise by a mod's readme.
621 <tr><td id="patchImportSounds">Import Sounds<td><i>Oblivion only.</i> Preserves the changes made by the mods selected to various sounds in the game.<td>The decision is entirely based on user preference. Choose whichever mods' sounds you prefer.
622 <tr><td id="patchImportSpellStats">Import Spell Stats<td><i>Oblivion only.</i> Preserves the changes made by the mods selected to items in order to fix bugs or rebalance them.<td>Always, unless you are told otherwise by a mod's readme. There is an element of user preference, for instance if you are using several mods that overhaul spell stats. In such cases, choose whichever mods' stats you prefer.
623 <tr><td>Import Stats<td><i>Oblivion only.</i> Preserves the changes made by the mods selected to spells in order to fix bugs or rebalance them.<td>Always, unless you are told otherwise by a mod's readme. There is an element of user preference, for instance if you are using several mods that overhaul item stats. In such cases, choose whichever mods' stats you prefer.
624 </table>
625
626 <h3 id="patch-tweaking">Applying Tweaks</h3>
627 <p>The Bashed Patch lets you independently tweak a large number of game settings. Each tweak has a description that is visible when you select it. Some tweaks have several possible values, with the current value given in [square brackets] in the tweak name. Right-clicking these tweaks will display a menu from which you can selected a different value. The tweaks are catagorised into different sections.
628 <table>
629 <thead><tr><th>Section<th>Description<th>When You Should Use It
630 <tbody>
631 <tr><td id="patchTweakActors">Tweak Actors<td><i>Oblivion only.</i> Allows you to change a number of the game's settings relating to actors (ie. NPCs).<td>The decision is entirely based on user preference.
632 <tr><td id="patchTweakAssorted">Tweak Assorted<td><i>Oblivion only.</i> Contains a set of miscellaneous tweaks to the game.<td>The <b>Bow Reach Fix</b> and <b>Nvidia Fog Fix</b> are recommended for all users, as they fix bugs that may be uncovered by mods. The <b>DarNified Books</b> option is recommended for users of DarNified UI. Other than those, the decision is entirely based on user preference.
633 <tr><td id="patchTweakClothes">Tweak Clothes<td><i>Oblivion only.</i> Contains a set of tweaks that changes settings relating to the game's clothing.<td>The decision is entirely based on user preference.
634 <tr><td id="patchTweakNames">Tweak Names<td><i>Oblivion only.</i> Contains a set of tweaks that changes the names of things in the game. Most change the names to change how they are sorted in your inventory.<td>The decision is entirely based on user preference.
635 <tr><td id="patchTweakSettings">Tweak Settings<td><i>Oblivion only.</i> Contains a set of tweaks that changes various global and non-global game settings. <td>The <b>UOP Vampire Aging and Face Fix.esp</b> tweak is recommended for all users. Otherwise, the decision is entirely based on user preference.
636 </table>
637
638 <h3 id="patch-other">Other Bashed Patch Options</h3>
639 <p>The Bashed Patch also gives you a number of other sections providing additional functionality besides the above merging, importing and tweaking. These options are described below.
640 <table>
641 <thead><tr><th>Section<th>Description<th>When You Should Use It
642 <tbody>
643 <tr><td id="patchAliasModNames">Alias Mod Names<td>Allows Wrye Bash to recognise some common renamings of plugins that are referenced in .csv data files that it imports as part of some Bashed Patch sections. Renamings should be listed in the text box for this section. The format is <code>Old.esp => New.esp</code>.<td>If you have renamed a plugin that is referenced in a CSV file you have selected in the Bashed Patch's configuration. It is recommended that you refrain from renaming plugins, as it can break parts of Wrye Bash and other utilities.
644 <tr><td id="patchReplaceFormIDs">Replace Form IDs<td><i>Oblivion only.</i> Replaces a set of formIDs with another set of formIDs defined by a .csv file.<td>If you use a mod that tells you to use it.
645 <tr><td id="patchCoblCatalogs">Cobl Catalogs<td><i>Oblivion only.</i> Updates Cobl's ingredient and effect catalogs to take into account those added by mods you use.<td>If you use Cobl (a.k.a. Common Oblivion).
646 <tr><td>Cobl Exhaustion<td><i>Oblivion only.</i> Updates greater powers added by the mods that are listed in the selected .csv file options so that they're compatible with Cobl's Exhaustion feature.<td>If you use Cobl's Exhaustion feature.
647 <tr><td>Contents Checker<td><i>Oblivion only.</i> Checks that leveled lists and inventories contain the correct types of entries, and removes any incorrect entries.<td>Always.
648 <tr><td id="patchLeveledLists">Leveled Lists<td>Merges changes made to leveled lists by mods to increase compatibility between them.<td>Always. If you don't have any mods that alter leveled lists, the option won't do anything, in which case it doesn't hurt to have it enabled.
649 <tr><td id="patchMorphFactions">Morph Factions<td><i>Oblivion only.</i> Updates factions so that they are more likely to work with Wrye Morph.<td>If you use Cobl and Wrye Morph.
650 <tr><td id="patchPowerExhaustion">Power Exhaustion<td><i>Oblivion only.</i> This is an option provided for backwards-compatibility only and was deprecated then finally removed in Wrye Bash v296. Users of Power Exhaustion should upgrade to Cobl and use its Exhaustion feature instead.<td>Never.
651 <tr><td id="patchRaceRecords">Race Records<td><i>Oblivion only.</i> Some mods make changes to races and want those changes to be preserved even if another mod changes the same race. This ensures that those changes are kept. It also checks for and fixes various errors such as googly eyes and missing hair or eyes. It also has a section of race tweaks which the user can select as desired.<td>Always, even if there are no mods listed on the right.
652 <tr><td id="patchSEWorldTests">SEWorld Tests<td><i>Oblivion only.</i> Fixes quests that aren't suspended while your character is in the Shivering Isles. This doesn't apply to mod-added quests, it only restores suspension to vanilla quests where mods have removed it.<td>Always. If you don't have Shivering Isles, the option won't do anything, in which case it doesn't hurt to have it enabled.
653 </table>
654
655 <h2 id="ini">Applying Ini File Edits</h2>
656 <figure class="slideshow">
657 <img src="../bash/images/readme/ini-edits-1.png" alt="INI Edits Tab" />
658 <img src="../bash/images/readme/ini-oblivion.png" alt="INI Edits Tab" />
659 <img src="../bash/images/readme/ini-all_natural.png" alt="INI Edits Tab" />
660 <figcaption style="padding-top:650px;">Wrye Bash's INI Edits tab, editing Oblivion.ini, Oblivion's configuration file, and All Natural.ini, a mod's configuration file. (Animated slideshow.)</figcaption>
661 </figure>
662
663 <h3 id="ini-overview">Overview</h3>
664 <p>The Ini Edits tab allows the user to quickly apply edits to Oblivion.ini or Skyrim.ini, depending on your game, and mod-added ini files, including those containing scripts used to configure mods. Edits are applied from ini tweak files, which are just a text file that contains only the lines of the ini that you wish to change. Ini tweaks are stored in the <code>Data\Ini Tweaks</code> folder, and may be installed through BAIN or placed there manually.
665 <p>The drop-down box allows you to select the current ini file. The <q>Browse...</q> option in the drop-down box can be used to select an ini file not listed.
666 <p>Selecting a tweak will display its contents in the middle column, and highlights the changes it applies to the current ini file in the right column. To apply a tweak, right click it and select <a href="#tweakApply">Apply</a>.
667 <p><b>Warning:</b> Incorrect Oblivion.ini or Skyrim.ini settings can cause bugs, CTDs or other damage to your game. Advanced settings in particular tend to be machine-specific and should not be casually copied from one computer to another.
668
669 <h3 id="ini-symbols">What Symbols &amp; Colours Mean</h3>
670 <table>
671 <thead><tr><th>Checkbox Style<th>Meaning
672 <tbody>
673 <tr><td><img src="../bash/images/checkbox_orange_off.png" alt="Orange"/><td>Some or all the variables the tweak sets do not exist in the current ini file.
674 <tr><td><img src="../bash/images/checkbox_green_off.png" alt="Green"/><td>The variable values in the current ini file do not match the values set by the tweak.
675 <tr><td><img src="../bash/images/checkbox_yellow_imp.png" alt="Yellow with Dot"/><td>Some, but not all, of the variable values in the current ini file do not match the values set by the tweak.
676 <tr><td><img src="../bash/images/checkbox_green_imp.png" alt="Green with Dot"/><td>Some, but not all, of the variable values in the current ini file do not match the values set by the tweak. The values that don't match another tweak from the same installer.
677 <tr><td><img src="../bash/images/checkbox_green_on.png" alt="Green with Check"/><td>Tweak is applied.
678 </table>
679 <table>
680 <thead><tr><th>Text Formatting<th>Meaning
681 <tbody>
682 <tr><td style="background-color:#FFD5AA;">Orange Background<td>The specific heading or tweak is invalid for the current ini file.
683 <tr><td style="background-color:#FFFFBF;">Yellow Background<td>The specific variable value does not match the value in the current ini file.
684 <tr><td style="background-color:#C1FFC1;">Green Background<td>The specific variable value matches the value in the current ini file.
685 </table>
686 <h3 id="ini-commands">Buttons &amp; Context Menu Commands</h3>
687 <table>
688 <thead>
689 <tr><th colspan="2">Ini Edits Tab
690 <tr><th>Button<th>Description
691 <tbody>
692 <tr><td>Remove<td>Removes the current ini file from the drop-down selection box.
693 <tr><td>Edit...<td>Opens the current ini file for editing in the default text editor.
694 </table>
695 <table>
696 <thead>
697 <tr><th colspan="2">Column Header Context Menu
698 <tr><th>Command<th>Description
699 <tbody>
700 <tr><td>Sort By<td>This submenu allows you to choose by which column the save list is sorted. This is equivalent to clicking on a column header.
701 <tr><td>Columns<td>This submenu allows you to choose which columns are visible in the save list.
702 <tr><td>Allow Tweaks with New Lines<td>
703 <tr><td>Open...<td>
704 <tr><td>List Active INIs...<td>
705 </table>
706 <table>
707 <thead>
708 <tr><th colspan="2">Tweak Context Menu
709 <tr><th>Command<th>Description
710 <tbody>
711 <tr><td id="tweakApply">Apply<td>Applies the tweak to the current ini file.
712 <tr><td>Create Tweak with current settings...<td>Creates a new tweak with the same settings as the selected tweak, but uses the values in the current ini file.
713 <tr><td>List Errors...<td>If the tweak is invalid, this will show you which entries in the tweak don't exist in the current ini file.
714 <tr><td>Open...<td>Open the tweak for editing in the default text editor.
715 <tr><td>Delete<td>Delete the tweak.
716 </table>
717
718 <h2 id="launchers">Launching Applications</h2>
719 <figure class="slideshow">
720 <img src="../bash/images/readme/toolbar-10-hover-obse-toggle.png" alt="launcher"/>
721 <img src="../bash/images/readme/toolbar-9-hover-autoquit.png" alt="launcher"/>
722 <img src="../bash/images/readme/toolbar-8-hover-launchgameviaobse.png" alt="launcher"/>
723 <img src="../bash/images/readme/toolbar-7-hover-launchgame.png" alt="launcher"/>
724 <img src="../bash/images/readme/toolbar-6-hover-launchboss.png" alt="launcher"/>
725 <img src="../bash/images/readme/toolbar-5-hover-launchbashmon.png" alt="launcher"/>
726 <img src="../bash/images/readme/toolbar-4-hover-docbrowser.png" alt="launcher"/>
727 <img src="../bash/images/readme/toolbar-3-hover-modchecker.png" alt="launcher"/>
728 <img src="../bash/images/readme/toolbar-2-hover-settings.png" alt="launcher"/>
729 <img src="../bash/images/readme/toolbar-1-hover-helpfile.png" alt="launcher"/>
730 <figcaption style="padding-top:80px;">Wrye Bash's launcher bar, at the bottom of its main window.</figcaption>
731 </figure>
732 <p>At the bottom left of Bash's main window you'll find launch buttons for your game and other applications if they're installed. You'll also find a few toggle buttons and some Wrye Bash feature buttons. Each of the application buttons will be present if the corresponding application is present in the game install directory, or in their default install location if the application is not game-specific.
733 <p>Clicking an application's icon will launch it, and clicking a toggle button will change the state of the toggle. Clicking a Wrye Bash feature button will open that feature's window.
734 <h3 id="launchers-toggles">Toggle Buttons</h3>
735 <table>
736 <thead><tr><th>Icon (On)<th>Icon (Off)<th>Toggles<th>Behaviour
737 <tbody>
738 <tr><td><img src="../bash/images/checkbox_green_on_32.png" width="32" height="32" alt="checked green checkbox"/><td><img src="../bash/images/checkbox_green_off_32.png" width="32" height="32" alt="unchecked green checkbox"/><td>Script Extender<td>When checked this will launch the game's Script Extender when either the game or game's editor (Construction Set or Creation Kit) buttons are clicked. If the LAA Launcher also launches the game's Script Extender, then unchecking this toggle will also uncheck the LAA Launcher toggle.
739 <tr><td><img src="../bash/images/checkbox_blue_on_32.png" width="32" height="32" alt="checked blue checkbox"/><td><img src="../bash/images/checkbox_blue_off_32.png" width="32" height="32" alt="unchecked blue checkbox"/><td>LAA Launcher<td>When checked this will launch the LAA Launcher when the game button is clicked. If the LAA Launcher also launches the game's Script Extender, checking this will also check the Script Extender toggle.
740 <tr><td><img src="../bash/images/checkbox_red_x_32.png" width="32" height="32" alt="checked red checkbox"/><td><img src="../bash/images/checkbox_red_off_32.png" width="32" height="32" alt="unchecked red checkbox"/><td>Auto-Quit<td>If checked this will cause Bash to quit when launching the game. This is useful if you're concerned about memory usage.
741 </table>
742 <h3 id="launchers-game">Game &amp; Editor Launchers</h3>
743 <p>The game and editor icons displayed will depend on which supported game you have Wrye Bash installed for. Using Wrye Bash's game launcher opens the game itself, rather than the game's launcher.
744 <table>
745 <thead>
746 <tr><th colspan="2">Oblivion<th colspan="2">Skyrim
747 <tr><th>Icon<th>Application<th>Icon<th>Application
748 <tbody>
749 <tr><td><img src="../bash/images/oblivion32.png" width="32" height="32" alt="Oblivion icon"/><td>Oblivion
750 <td><img src="../bash/images/skyrim32.png" width="32" height="32" alt="Skyrim icon"/><td>Skyrim
751 <tr><td><img src="../bash/images/tescs32.png" width="32" height="32" alt="Oblivion CS icon"/><td><a href="http://cs.elderscrolls.com/constwiki/index.php/The_Elder_Scrolls_Construction_Set">TES Construction Set</a>
752 <td><img src="../bash/images/creationkit32.png" width="32" height="32" alt="Creation Kit icon"/><td><a href="http://www.creationkit.com/">Skyrim Creation Kit</a>
753 </table>
754 <h3 id="launchers-utils">Game-Specific Utilities</h3>
755 <p>Tes4Edit, Tes4Trans and Tes4view are just different modes of Tes4Edit.exe and will be available if Tes4Edit.exe is available. Tes4Gecko &amp; Oblivion Book Creator will be available if the windows path variable <code>JAVA_HOME</code> points to a valid java install (or the javaw.exe is present in Windows\System32) and their .jar file is present in Oblivion install directory or for OBC in the data directory (you can override those default paths in bash.ini). The BOSS launcher has some options if BOSS v2 is installed:
756 <ul>
757 <li>Right-clicking the BOSS icon and selecting <q id="launchersBOSSDisableLockLoadOrder">BOSS Disable Lock Load Order</q> will cause Wrye Bash to temporarily disable Lock Load Order
758 when BOSS is run from its application launcher in the status bar, to allow BOSS to set the load order, re-enabling it after BOSS has finished running. It has no effect when BOSS
759 is run from outside Wrye Bash, or when Wrye Bash is running for Skyrim.
760 <li>Right-clicking the BOSS icon and selecting the <q>Launch BOSS GUI</q> will cause Wrye Bash to launch BOSS's GUI instead of its command line interface.
761 <li>If <b>V</b> is pressed, it will disable version parsing.
762 <li>If <b>R</b> is pressed, it will do a level 1 revert (to the state just prior to the last sort).
763 <li>If <b>Shift-R</b> is pressed, it will do a level 2 revert (to the state just prior to the 2nd last sort).
764 <li>If <b>S</b> is pressed, it will run BOSS in its silent mode, so that the BOSS Log does not automatically open once it has finished running.
765 <li>If <b>C</b> is pressed, it will run BOSS with its Display File CRCs option enabled, so that plugin CRCs are displayed in the BOSS Log.
766 </ul>
767 <table>
768 <thead>
769 <tr><th colspan="2">Oblivion<th colspan="2">Skyrim
770 <tr><th>Icon<th>Application<th>Icon<th>Application
771 <tbody>
772 <tr><td><img src="../bash/images/obmm32.png" width="32" height="32" alt="tool image"/><td><a href="http://oblivion.nexusmods.com/mods/2097">Oblivion Mod Manager</a>
773 <td><img src="../bash/images/boss32.png" width="32" height="32" alt="tool image"/><td><a href="http://boss-developers.github.io">BOSS</a>
774 <tr><td><img src="../bash/images/tools/isobl32.png" width="32" height="32" alt="tool image"/><td><a href="http://tesalliance.org/forums/index.php?/files/file/132-insanitys-oblivion-launcher/">Insanity Sorrow's Oblivion Launcher</a>
775 <td><td>
776 <tr><td><img src="../bash/images/tools/insanity'sreadmegenerator32.png" width="32" height="32" alt="tool image"/><td><a href="http://tesalliance.org/forums/index.php?/files/file/130-insanitys-readme-generator/">Insanity Sorrow's Readme Generator</a>
777 <td><td>
778 <tr><td><img src="../bash/images/tools/insanity'srng32.png" width="32" height="32" alt="tool image"/><td><a href="http://tesalliance.org/forums/index.php?/files/file/131-random-name-generator/">Insanity Sorrow's Random Name Generator</a>
779 <td><td>
780 <tr><td><img src="../bash/images/tools/randomnpc32.png" width="32" height="32" alt="tool image"/><td><a href="http://tesalliance.org/forums/index.php?/files/file/128-random-npc/">Insanity Sorrow's Random NPC Generator</a>
781 <td><td>
782 <tr><td><img src="../bash/images/tools/oblivionfaceexchangerlite32.png" width="32" height="32" alt="tool image"/><td><a href="http://oblivion.nexusmods.com/mods/7808">Oblivion Face Exchange Lite</a>
783 <td><td>
784 <tr><td><img src="../bash/images/tools/modlistgenerator32.png" width="32" height="32" alt="tool image"/><td><a href="http://tesalliance.org/forums/index.php?/files/file/280-oblivion-mod-list-generator/">Oblivion Mod List Generator</a>
785 <td><td>
786 <tr><td><img src="../bash/images/tools/oblivionbookcreator32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.nexusmods.com/oblivion/mods/42132">Oblivion Book Creator</a>
787 <td><td>
788 <tr><td><img src="../bash/images/tools/bsacommander32.png" width="32" height="32" alt="tool image"/><td><a href="http://oblivion.nexusmods.com/mods/3311">BSA Commander</a>
789 <td><td>
790 <tr><td><img src="../bash/images/tools/tabula32.png" width="32" height="32" alt="tool image"/><td><a href="http://oblivion.nexusmods.com/mods/33486">Tabula</a>
791 <td><td>
792 <tr><td><img src="../bash/images/tools/tes4files32.png" width="32" height="32" alt="tool image"/><td><a href="http://oblivion.nexusmods.com/mods/8489">Tes4Files</a>
793 <td><td>
794 <tr><td><img src="../bash/images/tools/tes4gecko32.png" width="32" height="32" alt="tool image"/><td><a href="http://oblivion.nexusmods.com/mods/8665">Tes4Gecko</a>
795 <td><td>
796 <tr><td><img src="../bash/images/tools/tes4view32.png" width="32" height="32" alt="tool image"/><td><a href="http://oblivion.nexusmods.com/mods/11536">Tes4View</a>
797 <td><td>
798 <tr><td><img src="../bash/images/tools/tes4edit32.png" width="32" height="32" alt="tool image"/><td><a href="http://oblivion.nexusmods.com/mods/11536">Tes4Edit</a>
799 <td><td>
800 <tr><td><img src="../bash/images/tools/tes4trans32.png" width="32" height="32" alt="tool image"/><td><a href="http://oblivion.nexusmods.com/mods/11536">Tes4Trans</a>
801 <td><td>
802 <tr><td><img src="../bash/images/tools/tes4lodgen32.png" width="32" height="32" alt="tool image"/><td><a href="http://oblivion.nexusmods.com/mods/15781">Tes4LodGen</a>
803 <td><td>
804 <tr><td><img src="../bash/images/boss32.png" width="32" height="32" alt="tool image"/><td><a href="http://boss-developers.github.io">BOSS</a>
805 <td><td>
806 <tr><td><img src="../bash/images/tools/interactivemapofcyrodiil32.png" width="32" height="32" alt="tool image"/><td><a href="http://oblivion.nexusmods.com/mods/3961">Interactive Map of Cyrodiil and Shivering Isles</a>
807 <td><td>
808 </table>
809 <h3 id="launchers-apps">Other Applications</h3>
810 <table>
811 <thead>
812 <tr><th colspan="2">Model Tools<th colspan="2">Texture Tools<th colspan="2">Audio Tools<th colspan="2">Misc
813 <tr><th>Icon<th>Application<th>Icon<th>Application<th>Icon<th>Application<th>Icon<th>Application
814 <tbody>
815 <tr><td><img src="../bash/images/tools/artofillusion32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.artofillusion.org/">Art of Illusion</a>
816 <td><img src="../bash/images/tools/anifx32.png" width="32" height="32" alt="tool image"/><td><a href="http://icofx.ro/anifx/index.html">AniFX</a>
817 <td><img src="../bash/images/tools/audacity32.png" width="32" height="32" alt="tool image"/><td><a href="http://audacity.sourceforge.net/">Audacity</a>
818 <td><img src="../bash/images/tools/fraps32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.fraps.com/download.php">Fraps</a>
819 <tr><td><img src="../bash/images/tools/autocad32.png" width="32" height="32" alt="tool image"/><td><a href="http://usa.autodesk.com/adsk/servlet/pc/index?siteID=123112&amp;id=13799652">AutoCad</a>
820 <td><img src="../bash/images/tools/artweaver32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.artweaver.de/">Artweaver</a>
821 <td><img src="../bash/images/tools/abcamberaudioconverter32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.processtext.com/abcmp3wav.html">ABC Amber Audio Converter</a>
822 <td><img src="../bash/images/tools/logitechkeyboard32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.logitech.com/index.cfm/434/285&amp;cl=za">Logitech G11 Keyboard Profiler</a>
823 <tr><td><img src="../bash/images/tools/blender32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.blender.org">Blender</a>
824 <td><img src="../bash/images/tools/crazybump32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.crazybump.com/">CrazyBump</a>
825 <td><img src="../bash/images/tools/switch32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.nch.com.au/switch/index.html">Switch</a>
826 <td><img src="../bash/images/tools/mediamonkey32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.mediamonkey.com/">Media Monkey</a>
827 <tr><td><img src="../bash/images/tools/gmax32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.turbosquid.com/gmax">GMax</a>
828 <td><img src="../bash/images/tools/ddsconverter32.png" width="32" height="32" alt="tool image"/><td><a href="http://eliteforce2.filefront.com/file/DDS_Converter;29412">DDSConverter</a>
829 <td><td>
830 <td><img src="../bash/images/tools/notepad++32.png" width="32" height="32" alt="tool image"/><td><a href="http://notepad-plus.sourceforge.net/">Notepad++</a>
831 <tr><td><img src="../bash/images/tools/maya32.png" width="32" height="32" alt="tool image"/><td><a href="http://usa.autodesk.com/adsk/servlet/pc/index?siteID=123112&amp;id=13577897">Maya</a>
832 <td><img src="../bash/images/tools/deeppaint32.png" width="32" height="32" alt="tool image"/><td><a href="http://download.chip.eu/en/Deep-Paint-2.0_132831.html">DeepPaint</a>
833 <td><td>
834 <td><img src="../bash/images/steam32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.steampowered.com/">Steam</a>
835 <tr><td><img src="../bash/images/tools/3dsmax32.png" width="32" height="32" alt="tool image"/><td><a href="http://usa.autodesk.com/adsk/servlet/pc/index?siteID=123112&amp;id=13567410">3ds Max</a>
836 <td><img src="../bash/images/tools/dogwaffle32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.thebest3d.com/dogwaffle/free/">Dogwaffle</a>
837 <td><td>
838 <td><img src="../bash/images/tools/evgaprecision32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.evga.com/">EVGA Precision</a>
839 <tr><td><img src="../bash/images/tools/milkshape3d32.png" width="32" height="32" alt="tool image"/><td><a href="http://chumbalum.swissquake.ch/">MilkShape 3D</a>
840 <td><img src="../bash/images/tools/genetica32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.spiralgraphics.biz/genetica.htm">Genetica</a>
841 <td><td>
842 <td><img src="../bash/images/tools/winmerge32.png" width="32" height="32" alt="tool image"/><td><a href="http://winmerge.org/">WinMerge</a>
843 <tr><td><img src="../bash/images/tools/mudbox32.png" width="32" height="32" alt="tool image"/><td><a href="http://usa.autodesk.com/adsk/servlet/pc/index?siteID=123112&amp;id=13565063">Mudbox</a>
844 <td><img src="../bash/images/tools/geneticaviewer32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.spiralgraphics.biz/viewer/">Genetica Viewer</a>
845 <td><td>
846 <td><img src="../bash/images/tools/freemind32.png" width="32" height="32" alt="tool image"/><td><a href="http://freemind.sourceforge.net/wiki/index.php/Main_Page">FreeMind</a>
847 <tr><td><img src="../bash/images/tools/sculptris32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.sculptris.com">Sculptris</a>
848 <td><img src="../bash/images/tools/gimp32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.gimp.org/downloads/">GIMP</a>
849 <td><td>
850 <td><img src="../bash/images/tools/freeplane32.png" width="32" height="32" alt="tool image"/><td><a href="http://freeplane.sourceforge.net/wiki/index.php/Main_Page">Freeplane</a>
851 <tr><td><img src="../bash/images/tools/softimagemodtool32.png" width="32" height="32" alt="tool image"/><td><a href="http://usa.autodesk.com/adsk/servlet/pc/item?id=13571257&amp;siteID=123112">Softimage Mod Tool</a>
852 <td><img src="../bash/images/tools/gimpshop32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.gimpshop.com/">Gimp Shop</a>
853 <td><td>
854 <td><img src="../bash/images/tools/filezilla32.png" width="32" height="32" alt="tool image"/><td><a href="http://filezilla-project.org/">Filezilla</a>
855 <tr><td><img src="../bash/images/tools/speedtree32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.speedtree.com/">SpeedTree</a>
856 <td><img src="../bash/images/tools/icofx32.png" width="32" height="32" alt="tool image"/><td><a href="http://icofx.ro/index.html">IcoFX</a>
857 <td><td>
858 <td><img src="../bash/images/tools/eggtranslator32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.egg-of-time.us/portal/index.php?option=com_content&amp;view=article&amp;id=1825">Egg Translator</a>
859 <tr><td><img src="../bash/images/tools/treed32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.frecle.net/index.php?show=treed.about">Treed</a>
860 <td><img src="../bash/images/tools/inkscape32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.inkscape.org/">Inkscape</a>
861 <td><td>
862 <td><img src="../bash/images/tools/radvideotools32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.radgametools.com/bnkdown.htm">RAD Video Tools</a>
863 <tr><td><img src="../bash/images/tools/wings3d32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.wings3d.com/">Wings3D</a>
864 <td><img src="../bash/images/tools/irfanview32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.irfanview.com/">Irfan View</a>
865 <td><td>
866 <td><img src="../bash/images/tools/winsnap32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.filehippo.com/download_winsnap/">WinSnap</a>
867 <tr><td><img src="../bash/images/tools/nifskope32.png" width="32" height="32" alt="tool image"/><td><a href="http://niftools.sourceforge.net/wiki/NifTools">Nifskope</a>
868 <td><img src="../bash/images/tools/faststoneimageviewer32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.faststone.org/">FastStone Image Viewer</a>
869 <td><td>
870 <td><td>
871 <tr><td><td>
872 <td><img src="../bash/images/tools/mapzone32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.mapzoneeditor.com/">MaPZone</a>
873 <td><td>
874 <td><td>
875 <tr><td><td>
876 <td><img src="../bash/images/tools/mypaint32.png" width="32" height="32" alt="tool image"/><td><a href="http://mypaint.intilinux.com/">MyPaint</a>
877 <td><td>
878 <td><td>
879 <tr><td><td>
880 <td><img src="../bash/images/tools/nvidiamelody32.png" width="32" height="32" alt="tool image"/><td><a href="http://developer.nvidia.com/object/melody_home.html">NVIDIAMelody</a>
881 <td><td>
882 <td><td>
883 <tr><td><td>
884 <td><img src="../bash/images/tools/paint.net32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.getpaint.net/download.html">Paint.NET</a>
885 <td><td>
886 <td><td>
887 <tr><td><td>
888 <td><img src="../bash/images/tools/paintshopprox332.png" width="32" height="32" alt="tool image"/><td><a href="http://www.corel.com/servlet/Satellite/us/en/Product/1184951547051">PaintShop Photo Pro</a>
889 <td><td>
890 <td><td>
891 <tr><td><td>
892 <td><img src="../bash/images/tools/photobie32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.photobie.com/">Photobie Design Studio</a>
893 <td><td>
894 <td><td>
895 <tr><td><td>
896 <td><img src="../bash/images/tools/photofiltre32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.photofiltre.com/">PhotoFiltre</a>
897 <td><td>
898 <td><td>
899 <tr><td><td>
900 <td><img src="../bash/images/tools/photoscape32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.photoscape.org/ps/main/index.php">PhotoScape</a>
901 <td><td>
902 <td><td>
903 <tr><td><td>
904 <td><img src="../bash/images/tools/photoseam32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.mediachance.com/pseam/">PhotoSEAM</a>
905 <td><td>
906 <td><td>
907 <tr><td><td>
908 <td><img src="../bash/images/tools/photoshop32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.adobe.com/">Photoshop</a>
909 <td><td>
910 <td><td>
911 <tr><td><td>
912 <td><img src="../bash/images/tools/pixelstudiopro32.png" width="32" height="32" alt="tool image"/><td><a href="http://pixelstudiopro.com/">Pixel Studio Pro</a>
913 <td><td>
914 <td><td>
915 <tr><td><td>
916 <td><img src="../bash/images/tools/pixia32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.ne.jp/asahi/mighty/knight/index.html">Pixia</a>
917 <td><td>
918 <td><td>
919 <tr><td><td>
920 <td><img src="../bash/images/tools/texturemaker32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.texturemaker.com/download.php">TextureMaker</a>
921 <td><td>
922 <td><td>
923 <tr><td><td>
924 <td><img src="../bash/images/tools/twistedbrush32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.pixarra.com/">Twisted Brush</a>
925 <td><td>
926 <td><td>
927 <tr><td><td>
928 <td><img src="../bash/images/tools/wtv32.png" width="32" height="32" alt="tool image"/><td><a href="http://developer.nvidia.com/object/windows_texture_viewer.html">Windows Texture Viewer</a>
929 <td><td>
930 <td><td>
931 <tr><td><td>
932 <td><img src="../bash/images/tools/xnormal32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.xnormal.net/">xNormal</a>
933 <td><td>
934 <td><td>
935 <tr><td><td>
936 <td><img src="../bash/images/tools/xnview32.png" width="32" height="32" alt="tool image"/><td><a href="http://www.xnview.com/">XnView</a>
937 <td><td>
938 <td><td>
939 </table>
940 <h3 id="launchers-features">Wrye Bash Feature Launchers</h3>
941 <table>
942 <thead><tr><th>Icon<th>Feature<th>Description
943 <tbody>
944 <tr><td><img src="../bash/images/bashmon32.png" width="32" height="32" alt="tool image"/><td>BashMon<td><i>Oblivion only.</i> This launches bashmon.py in a command shell window, for use with <a href="http://oblivion.nexusmods.com/mods/28563">Wrye Morph</a>.
945 <tr><td><img src="../bash/images/docbrowser32.png" width="32" height="32" alt="tool image"/><td>Doc Browser<td>Show the <a href="#DocBrowser">Doc Browser</a>. (You can also view the doc browser by double clicking on any mod file in the Mods tab.)
946 <tr><td id="launchersModChecker"><img src="../bash/images/modchecker32.png" width="32" height="32" alt="tool image"/><td>Mod Checker<td>Show the <a href="#ModChecker">Mod Checker</a>.
947 <tr><td id="launchersSettingsMenu"><img src="../bash/images/settingsbutton32.png" width="32" height="32" alt="tool image"/><td>Settings<td>Brings up the <a href="#BashSettingsMenu">Settings Menu</a>.
948 <tr><td><img src="../bash/images/help32.png" width="32" height="32" alt="tool image"/><td>Help<td>Show this help file in the default web browser.
949 </table>
950
951 <h2 id="trouble">Troubleshooting</h2>
952 <h3 id="trouble-dump">Generating A Bug Dump</h3>
953 <p>If Wrye Bash encounters an issue, it will generate a bug dump that will appear in a popup window. If an issue is encountered during startup, Wrye Bash may be unable to create the popup window, and so the bug dump will be saved to a log file, either <code>bash.log</code> or <code>Wrye Bash.exe.log</code> depending on the version of Wrye Bash you use. If no log file is present, then you will have to generate it yourself, using the steps below.
954 <ol>
955 <li>Open a command prompt. This can be done by selecting Start->Programs->Accessories->Command Prompt.
956 <li>Change the working directory to the <code>Mopy</code> directory. E.g. <code>cd /D "C:\Program Files\Bethesda Softworks\Oblivion\Mopy"</code> if Wrye Bash is installed for Oblivion.
957 <li>If using the Python version of Wrye Bash: Run <code>"Wrye Bash Debug.py" -d > bash.log</code>.
958 <ul>
959 <li>If that does not work, try <code>"C:\python27\python.exe" "Wrye Bash Debug.py" -d</code>. This assumes that you have Python 2.7 installed to the default directory. Adjust the above to reference the correct path if not.
960 </ul>
961 If using the Standalone version of Wrye Bash: Run <code>"Wrye Bash.exe" -d</code>.
962 </ol>
963 <p>The log file will detail the cause of the problem that is stopping Wrye Bash from starting. Read it and the rest of this section to see if the problem is something you can fix yourself. If not, report it to an official Wrye Bash thread for support.
964
965 <h3 id="trouble-permissions">File Permissions</h3>
966 <p>If you are running Windows Vista or later, Wrye Bash (and other modding programs) may be prevented from working correctly by the UAC security feature. There are four common workarounds to this problem:
967 <ol>
968 <li>Install the game outside <q>Program Files</q> or <q>Program Files (x86)</q>. UAC prevents unauthorised edits to these folders, so by installing the game outside of them, you remove it from UAC's reach, allowing you to use mods more easily. Steam users can move their Steam installation and games using <a href="https://support.steampowered.com/kb_article.php?ref=7418-YUBN-8129">these instructions</a>.
969 <li>Deactivate UAC. This can be done from the Control Panel, and will turn UAC off across the whole of your computer. It is up to you whether you feel that you have adequate security measures in place to do this without risk.
970 <li>Give yourself <q>Full Control</q> permissions over your game install folder. This will allow you to make any edits you desire while keeping UAC active and on guard for any edits made by programs you do not run, and also means that you do not need to reinstall your game to a new location.
971 <li>Do nothing. Wrye Bash will detect if it needs to run as Administrator, and give you a dialog with a few options:
972 <ol>
973 <li>Start Wrye Bash as Administrator: This will give Wrye Bash full Administrator Rights, allowing it to function fully with no further action, with one exception:
974 <ul>
975 <li>You will not be able to drag and drop archives into the Installers window to move or copy those archives into BAIN. This is because non-Admin processes (explorer.exe) are not allowed to communicate with Admin processes (Wrye Bash) in this manner.
976 </ul>
977 <li>Start normally. This will start Wrye Bash without Administrator Rights.
978 <ul>
979 <li>Many actions that require Administrator Privileges will cause a UAC prompt to be shown. Commonly, these are:
980 <ul>
981 <li>The first time Wrye Bash is started, approximately 4-6 times, depending on the number of directories Wrye Bash needs to create.
982 <li>When the Bashed Patch is rebuilt, 2 times, once for the Bashed Patch itself, once for the associated readme.
983 <li>Installing, Uninstalling, Annealing, and other operations in the Installers Tab that require modification of the game's Data folder.
984 <li>On shutdown, you may be prompted multiple times when saving various .dat files to the Bash Installers and Bash Mod Data folders, if these folders are under UAC protection.
985 </ul>
986 <li>A few actions are restricted:
987 <ul>
988 <li>Saving files into the UAC protected area: Windows does not allow the Save File dialog to select a target within a UAC protected folder.
989 <li>Ghosting: Wrye Bash will not be able to un-ghost already ghosted mods. Wrye Bash will not ghost mods. Both of these require renaming mod files.
990 <li>Other actions that require Administrator Privileges may not have workarounds coded. Be warned, any errors you encounter while running as a non-Admin under a UAC protected directory will most likely not be fixed. Follow one of the alternate solutions to solve these errors.
991 </ul>
992 </ul>
993 </ol>
994 Launching Wrye Bash with some command line switches can avoid this dialog:
995 <ul>
996 <li>--no-uac: Always start normally, without Administrator Privileges
997 <li>--uac: Always start as Administrator (if required)
998 </ul>
999 </ol>
1000 <p>For those that wish to take the third option and give themselves <q>Full Control</q> permissions, here is a guide:
1001 <ol>
1002 <li>Right-click the folder you wish to change the permissions for, and select <q>Properties</q>.
1003 <li>In <q>Properties</q>, select the <q>Security</q> tab, and click the <q>Edit...</q> button. A UAC prompt may appear, simply allow yourself to continue.
1004 <li>In the <q>Group or user names</q> box, select the <q>Users</q> option.
1005 <li>In the lower box, check the box opposite <q>Full Control</q> in the <q>Allow</q> column. Press OK to exit. If a UAC prompt appears, allow the change.
1006 <li>In the <q>Properties</q> window, select OK to exit. You should now have Full Control permissions over your chosen folder.
1007 </ol>
1008
1009 <h3 id="trouble-backup">Backing Up &amp; Restoring Settings</h3>
1010 <p>The easiest method is to just run the <a href="Wrye%20Bash%20Advanced%20Readme.html#tools">Backup Settings</a> and/or <a href="Wrye%20Bash%20Advanced%20Readme.html#tools">Restore Settings</a> commands, which are available in the <a href="Wrye%20Bash%20Advanced%20Readme.html#tools-settings">Settings menu</a>. These commands do not backup/restore any mod files or saves, just the Wrye Bash settings/data. When run, the commands ask you for the location you wish to back up to or restore from.
1011 <p>If you wish to manually back up your settings, the directories Wrye Bash stores files in are below.
1012 <table>
1013 <thead><tr><th>Directory<th>Contents
1014 <tbody>
1015 <tr><td>[Game]\Mopy <td>Main Bash files. If you're working on any localisation files in <code>Mopy\l10n</code> you may want to back them up.
1016 <tr><td>[Game]\Data\Bash Patches <td>Contains CSV files used by the import/export functions. Back up any CSV files you've exported and want to keep.
1017 <tr><td>[Game]\Data\Docs <td>Contains mod readmes. Doesn't need backing up.
1018 <tr><td>[Game]\Data\INI Tweaks <td>Contains ini tweaks. Only needs backing up if you've added custom ini tweaks.
1019 <tr><td>Documents\My Games\[Game] <td>Contains Wrye Bash settings. It is important to back this up.
1020 <tr><td>[Game] Mods (in the same folder as [Game])<td>Contains BAIN packages and other Wrye Bash settings. it is important to back this up.
1021 </table>
1022
1023 <h3 id="trouble-report">How To Report Bugs Helpfully</h3>
1024 <p>Bugs should be reported in an official Wrye Bash thread (links can be found in the <a href="#contact">Contact</a> section of this document). In order to best help you, the following information is required.
1025 <ul>
1026 <li>Your Wrye Bash version. This includes whether it's the Python or Standalone install, the version number and the SVN number (the latter only if using the SVN).
1027 <li>The symptoms. Provide a step-by-step description of what you did, what you expected and what happened.
1028 <li>What you see. Error messages are very helpful.
1029 <li>Your version of Windows. If you're using Windows with UAC enabled and you have your game in the default install directory, please resolve any permissions issues using one of the methods in the <a href="#permissions">File Permissions</a> section before reporting any bugs.
1030 <li>Any modifications you have made to your bash.ini, if you are using one.
1031 <li>If you're having an issue with the Standalone version, make sure to uninstall any Python components on your computer and try again, as they can sometimes interfere.
1032 <li>If the issue is related to the <a href="#patch">Bashed Patch</a>, please include the following:
1033 <ul>
1034 <li>Your load order. Get this by right clicking on a column header in the Mods tab, and selecting <a href="#modsListMods">List Mods...</a>.
1035 <li>Your Bash Tags. Get this by right clicking on a column header in the Mods tab, and selecting <a href="#modsListBashTags">List Bash Tags...</a>.
1036 <li>Your <a href="#patch">Bashed Patch</a> config. Get this by right clicking on the <a href="#patch">Bashed Patch</a> and selecting <a href="Wrye%20Bash%20Advanced%20Readme.html#modsListPatchConfig">List Patch Config...</a>.
1037 </ul>
1038 </ul>
1039
1040 <h3 id="trouble-known">Known Bugs</h3>
1041 <p>Wrye Bash, being a complex program, has its share of bugs.
1042 Visit our <a href="https://github.com/wrye-bash/wrye-bash/issues">issue tracker</a> for know bugs and enhancement requests.
1043 Respect developer's time - keep discussions there short, sweet and technical. No walls of text or forum chit chat.
1044
1045 <h3 id="trouble-mistakes">Common Issues</h3>
1046 <table>
1047 <thead><tr><th>Issue<th>Cause<th>Solution
1048 <tbody>
1049 <tr><td>Can't find bash.py<td>Wrye Bash is being run from the wrong directory.<td>Make sure you are generating the log from the Mopy directory.
1050 <tr><td>Can't Find User Directory<td>The PyWin32 Python module is not installed correctly.<td>Install the Wrye Python package correctly.
1051 <tr><td>Can't Find wxversion<td>Unknown<td>Uninstall then reinstall Python and wxPython (in that order).
1052 <tr><td>No module named wx<td>You haven't installed wxPython successfully or you haven't installed it in the right place.<td>Install the Wrye Python package correctly.
1053 <tr><td>The NTVDM CPU has encountered an illegal instruction.<td>This is a Python issue that causes the installation of PyWin32 (part of the Wrye Python bundle) to fail.<td> One workaround is to use the Standalone version of Wrye Bash. The alternative is to <a href="http://sourceforge.net/projects/pywin32/files/pywin32/Build%20219/pywin32-219.win32-py2.7.exe/download">download PyWin32 separately</a> and install it after installing Wrye Bash.
1054 <tr><td>Generating comtypes<td>Launching Wrye Bash for the first time after installing ComTypes (part of the Wrye Python bundle).<td>Not an error. Close the popup produced.
1055 <tr><td>Memory Error. This causes a debug output like the following to appear.
1056 <code class="box">Traceback (most recent call last):
1057 File "F:\Bethesda Softworks\Oblivion\Mopy\bash\basher.py", line 5349, in OnCloseWindow
1058 self.SaveSettings()
1059 File "F:\Bethesda Softworks\Oblivion\Mopy\bash\basher.py", line 5361, in SaveSettings
1060 self.notebook.GetPage(index).OnCloseWindow()
1061 File "F:\Bethesda Softworks\Oblivion\Mopy\bash\basher.py", line 2554, in OnCloseWindow
1062 bosh.modInfos.table.save()
1063 File "F:\Bethesda Softworks\Oblivion\Mopy\bash\bolt.py", line 2158, in save
1064 self.hasChanged = not dictFile.save()
1065 File "F:\Bethesda Softworks\Oblivion\Mopy\bash\bosh.py", line 315, in save
1066 saved = bolt.PickleDict.save(self)
1067 File "F:\Bethesda Softworks\Oblivion\Mopy\bash\bolt.py", line 1910, in save
1068 cPickle.dump(data,out,-1)
1069 MemoryError</code>
1070 <td>This is Wrye Bash running out of memory while trying to save its settings. Usually this will occur when a user has a very large BAIN setup, and it will happen after rebuilding the Bashed Patch. Saving Wrye Bash's settings involves some memory overhead, so usually happens while saving settings.
1071 <td>If you start seeing this error, it means you have enough information in BAIN to push Wrye Bash to the 2GB limit of memory for 32-bit applications. Either:
1072 <ul>
1073 <li>Avoid rebuilding the Bashed Patch after using BAIN. Instead, restart Wrye Bash, then rebuild the Bashed Patch.
1074 <li>If running the Python source, try enabling the LAA flag on python.exe and pythonw.exe. For 64-bit OS users, this may allow Wrye Bash up to almost 4GB of memory before crashing.
1075 <li>If running the Standalone executable, try enabling the LAA flag on Wrye Bash.exe.
1076 <li>If you do not need access to CBash, you can setup your Python environment using 64-bit Python.
1077 </ul>
1078 <tr><td>Wrye Bash will not start, and no Bug Dump can be generated<td>Wrye Bash is installed in a directory with unicode characters, and the Python interpreter has problems importing files in such directories.<td>Reinstall Wrye Bash to a directory without unicode characters.
1079 <tr><td>File not found errors<td>Mapped paths and junction links can confuse Wrye Bash, leading to file not found errors.<td>Avoid using mapped paths and junction links for your game install.
1080 </table>
1081
1082
1083 <h2 id="credits">Credits</h2>
1084 <img alt="Monkey God of Modding" src="../bash/images/wrye_monkey_87.jpg">
1085 <h3>Current Maintainer</h3>
1086 <ul>
1087 <li>Utumno: Complete refactoring of the codebase, performance.
1088 </ul>
1089
1090 <h3>Past Authors</h3>
1091 <ul>
1092 <li><b>Wrye</b>: Monkey God of Modding!
1093 <li>Ralgor: Cell support and Import Cells.
1094 <li>Raziel23x: new tweaks etc.
1095 <li>Haama: OBSE cofile definitions, various fixes, improvements etc
1096 <li>Badhair: OBSE cofile reading code, various optimizations etc.
1097 <li>Breeze582000: Bashmon
1098 <li>Pacific Morrowind: New imports, exports, tweaks, etc.
1099 <li>Lojack: Wizard based install system, Ini tab, etc.
1100 <li>myk002: Project management, Asynchronous installer tab, etc.
1101 <li>Waruddar: Extensive additions/improvements/fixes, primary author of CBash
1102 </ul>
1103
1104 <h3>Additional Credits</h3>
1105 <ul>
1106 <li><b>Translators</b>
1107 <ul>
1108 <li>German: DWS
1109 <li>Italian: Abot
1110 <li>Portuguese: Hadoki
1111 <li>Russian: DJ_Kovrik
1112 </ul>
1113 <li><b>Mod and Save File Gurus</b>
1114 <ul>
1115 <li>GhostWheel
1116 <li>Dave Humphreys
1117 <li>ElminsterEU
1118 <li>Rick
1119 <li>Resetgun
1120 <li>ScripterRon
1121 <li>Wrye
1122 </ul>
1123 <li><b>Python Kings</b>
1124 <ul>
1125 <li>Guido van Rossum and many, many others.
1126 </ul>
1127 <li><b>Special Thanks</b>
1128 <ul>
1129 <li>dev_akm: Archive Invalidation, etc.
1130 <li>ElminsterEU: Tes4View etc. Crucial for adding/checking new record types.
1131 <li>Quarn: BSA-Redirection, Black Screen Fix
1132 <li>Timeslip: BSA editing code, OBMM integration, etc.
1133 <li>Veritas_Secreto: Tamriel NPCs Revamped
1134 </ul>
1135 <li><b>Additional Thanks</b>
1136 <ul>
1137 <li>ElminsterEU: Bug catching, technical suggestions.
1138 <li><img width="32" height="32" alt="Metallicow's Icon" style="align: AbsMiddle;" src="../bash/images/mcowavi32.png"> Metallicow: Shiny new tool launcher icons, Graphics, Mooo, & the WizBAIN Editor.
1139 <li>Tom Suprgan: Several well researched suggestions.
1140 <li>Sativarg: Proofreading.
1141 <li>Kmacg94: Additional power exhaustion coverage.
1142 <li>To the testers/bug finders/helpful people on the forum when others have trouble: Arthmoor, Corepc, Daemondarque, TommyH, Surazal and many others.
1143 <li>WrinklyNinja: The LOOT API, libloadorder and libbsa, and the rewritten documentation included in v297 and later.
1144 <li>Alt3rn1ty: For supplying the screenshot images used in the documentation, many INI tweaks for Skyrim, and being an all-round bon oeuf and snappy dresser.
1145 <li>To those members of the community that contributed to the upkeep of Wrye Bash while its developers were absent (May/June 2012): Alt3rn1ty, Arthmoor, Daidalos, trira, WrinklyNinja, and many others.
1146 </ul>
1147 <li><b>Misc. Resources</b>
1148 <ul>
1149 <li><a href="http://www.famfamfam.com/lab/icons/silk/">FamFamFam Icons</a>
1150 <li><a href="http://www.bluebison.net/">Python and Chameleon images</a>
1151 </ul>
1152 </ul>
1153
1154 <h3>Homage Credits</h3>
1155 <p>Aka. ideas/stuff stolen from other people.
1156 <ul>
1157 <li><b>Names Files</b>
1158 <ul>
1159 <li>Flak: <a href="http://planetelderscrolls.gamespy.com/View.php?view=OblivionMods.Detail&amp;id=123">Flak's Complete Names Project</a>
1160 </ul>
1161 <li><b>Bash Features</b>
1162 <ul>
1163 <li>Kyorisu: Tes IV Save Manager (Save Profiles)
1164 <li>No Light Flicker: Crypton's No Light Flicker mods
1165 </ul>
1166 <li><b>GMST Tweaks</b>
1167 <ul>
1168 <li>Aelius: Arrow Litter, Essential NPC Unconsciousness
1169 <li>David Moyer: PC Death Camera
1170 <li>dbolivar, Acleacius: Horse Turning Speed
1171 <li>demuerte: Chameleon: No Refraction
1172 <li>Ravida: Fatigue from Running/Encumbrance
1173 <li>timmypod: Unlimited Amulets and Rings
1174 <li>Woodman: Chase Camera
1175 <li>KseAli: POI Visibility
1176 <li>Tom Supergan: Chase Camera Distance
1177 <li>showler: AI: Max Dead Actors
1178 <li>??: Compass Disable
1179 <li>??: Compass: POI Recognition
1180 </ul>
1181 </ul>
1182
1183
1184 <h2 id="contact">Contact</h2>
1185 <p>If you have a question/comment about Wrye Bash, it's best to post it on the current RELZ topic on the Bethesda Game Studios (BGS) forums.
1186
1187
1188 <h2 id="license">License</h2>
1189 <p>Wrye Bash is released under Version 2 of the GNU General Public License. See enclosed <a href="license.txt">license.txt</a> file for license details, or visit the <a href="http://www.gnu.org/copyleft/gpl.html">GNU Website</a> for information on all their licenses.
1190
1191 <h3>Packaged Programs</h3>
1192 <p>Additionally, Wrye Bash comes packaged with the following programs:
1193 <ul>
1194 <li>Mozilla's chardet library.
1195 <ul>
1196 <li>Website: <a href="http://pypi.python.org/pypi/chardet">Python.org</a>
1197 <li>License: <a href="http://www.gnu.org/licenses/lgpl.html">LGPL 2.1</a>
1198 <li>Usage: Wrye Bash uses this library to help in detecting character encodings use when reading and writing encoded Unicode strings.
1199 <li>Modifications: Minor modifications to bring chardet in line with Python 2.7 - removed the EUCTWProber, from the MBCSGroupProber class.
1200 </ul>
1201 <li>LOOT API
1202 <ul>
1203 <li>Website: <a href="https://github.com/loot/loot">GitHub</a>
1204 <li>License: <a href="http://www.gnu.org/licenses/gpl.html">GPL 3.0</a>
1205 <li>Usage: Wrye Bash uses this library to retrieve Bash Tag suggestions and Dirty mod information from LOOT's plugin databases.
1206 </ul>
1207 <li>libloadorder
1208 <ul>
1209 <li>Website: <a href="https://github.com/WrinklyNinja/libloadorder">GitHub</a>
1210 <li>License: <a href="http://www.gnu.org/licenses/gpl.html">GPL 3.0</a>
1211 <li>Usage: Wrye Bash uses this library to read and write plugin load order.
1212 </ul>
1213 <li>libbsa
1214 <ul>
1215 <li>Website: <a href="https://github.com/WrinklyNinja/libbsa">GitHub</a>
1216 <li>License: <a href="http://www.gnu.org/licenses/gpl.html">GPL 3.0</a>
1217 <li>Usage: Wrye Bash uses this library to read the contents of BSA files.
1218 </ul>
1219 <li>CBash
1220 <ul>
1221 <li>Website: <a href="http://sourceforge.net/projects/cbash/">SourceForge</a>
1222 <li>License: Triple-license <a href="http://www.mozilla.org/MPL/">MPL 1.1</a>/<a href="http://www.gnu.org/copyleft/gpl.html">GPL 2.0</a>/<a href="http://www.gnu.org/licenses/lgpl.html">LGPL 2.1</a>
1223 <li>Modifications:
1224 <ul>
1225 <li>cint.py - some changes made that have not yet been merged into the CBash SVN repository. These are committed to the Wrye Bash SVN repository.
1226 <li>C/C++ Source Code: Version 0.5.1 - 0.5.3 of CBash are built off modified source code, which can be found in the Wrye Bash SVN repository, <a href="http://oblivionworks.svn.sourceforge.net/viewvc/oblivionworks/Programs/CBash/">here</a>.
1227 </ul>
1228 </ul>
1229 <li>7zip:
1230 <ul>
1231 <li>Website: <a href="http://www.7-zip.org/">7zip.org</a>
1232 <li>License: <a href="http://www.gnu.org/licenses/lgpl.html">LGPL</a>
1233 <li>Usage: Wrye Bash uses 7z to pack and unpack archives.
1234 </ul>
1235 <li>LZMA SDK:
1236 <ul>
1237 <li>Website: <a href="http://www.7-zip.org/sdk.html">7zip.org</a>
1238 <li>License: Public Domain
1239 <li>Usage: Wrye Bash uses lzma.exe from the SDK to unpack OBMM compressed data streams.
1240 </ul>
1241 </ul>
1242
1243 <h2 id="advanced">Advanced Readme Topics</h2>
1244 <p>This final section gives a brief summary of what may be found in the Advanced Readme. The some of the topics covered are:
1245 <ul>
1246 <li>Installers:
1247 <ul>
1248 <li>How to install Wrye Bash in any location.
1249 <li>What the individual Python components required for the Python version are.
1250 </ul>
1251 <li>BAIN:
1252 <ul>
1253 <li>What the rest of the user interface of the Installers tab does.
1254 <li>Which files BAIN skips by default, and how to tell if files have been skipped.
1255 <li>How to install Script Extender plugins.
1256 <li>How to edit OMOD Conversion Data using BAIN, for OMOD-Ready, BAIN compatible mods.
1257 <li>How to create BAIN Conversion Files, and more about them.
1258 <li>What the rest of the context menu commands do.
1259 </ul>
1260 <li>Mods tab:
1261 <ul>
1262 <li>Different ways to sort the listing of plugins in Wrye Bash.
1263 <li>What exclusion groups are, and how they may be used.
1264 <li>What the plugin details panel on the right-hand side of the Mods tab does.
1265 <li>What CSV files are, and how Wrye Bash uses them.
1266 <li>What the rest of the context menu commands do.
1267 </ul>
1268 <li>Bashed Patch:
1269 <ul>
1270 <li>How to view or edit the Bashed Patch outside of Wrye Bash.
1271 <li>What Bash Tags are, what Tags exist, and when and how they can be used.
1272 <li>What all the various Tweak... options are.
1273 <li>What Merge Filtering is, and how and when to use it.
1274 <li>What Item Interchange Mode is, and how and when to use it.
1275 <li>What the default CSV files that Wrye Bash comes with are, and what they do when imported into the Bashed Patch.
1276 <li>What the Leveled Lists patcher does, and how best to use it.
1277 </ul>
1278 <li>The Saves tab:
1279 <ul>
1280 <li>What the functionality of Saves tab is, and how it may be used.
1281 <li>How to use save profiles.
1282 <li>How to import faces from other savegames and mods.
1283 <li>What all the context menu commands do, and what all the colours and symbols used mean.
1284 </ul>
1285 <li>What the functionalities of the Screenshots and People tabs are, and how they may be used.
1286 <li>How to customise which launchers are displayed, including adding your own new launchers.
1287 <li>How to use Wrye Bash's Settings menu to customise its general behaviour.
1288 <li>How to use the Docs Browser to view mod readmes through Wrye Bash.
1289 <li>What the Mod Checker is and how to use it to detect issues with your installed mods and more.
1290 <li>What Oblivion.esm swapping is, and how it can be used and why.
1291 <li>What Wrye Bash's keyboard shortcuts are.
1292 <li>How to translate Wrye Bash into other languages.
1293 </ul>
1294 <p>The Advanced Readme is a more technical document aimed more towards mod authors and advanced users of Wrye Bash than the average user. If you find yourself wanting to know more, or not understanding why something in Wrye Bash behaves the way it does, then the answer you seek may be found in the <a href="Wrye%20Bash%20Advanced%20Readme.html">Advanced Readme</a>.
1295 <script>
1296 function nextImage(imgs){
1297 for(var i=0;i<imgs.length;i++){
1298 if(imgs[i].style.opacity=='1' || imgs[i].style.opacity==''){
1299 imgs[i].style.opacity='0';
1300 if(i+1<imgs.length){
1301 imgs[i+1].style.opacity='1';
1302 }else{
1303 imgs[0].style.opacity='1';
1304 }
1305 break;
1306 }
1307 }
1308 setTimeout(nextImage, 5000, imgs);
1309 }
1310
1311 var figures = document.getElementsByTagName('figure');
1312 if(figures!=null){
1313 for (var i=0; i < figures.length; i++) {
1314 if (figures[i].className == 'slideshow'){
1315 var wrapper = function(i){
1316 return function(){nextImage(figures[i].getElementsByTagName('img'));}
1317 }
1318 setTimeout(wrapper(i),5000);
1319 }
1320 }
1321 }
1322 </script>

  ViewVC Help
Powered by ViewVC 1.1.22