Guide:Mod Organizer

From S.T.E.P. Project Wiki

by DoubleYou, wolverine2710, Uhuru, Tannin & S.T.E.P. Team

Guide Forum Thread
Official Support Forum

About Mod Organizer

Mod Organizer by Tannin (Tannin42 on the Nexus) is an advanced mod manager for Fallout 3, Fallout New Vegas, Oblivion, and Skyrim. It is localized in English, Czech, French, German, Korean, Russian, Spanish, Turkish, and Chinese (both simplified and traditional). Its primary purpose is to provide a way to install mods in a manner that leaves the game's install folder intact and untouched, doing so via a virtual file system. By keeping every mod it installs entirely separate from one another, it makes installation and uninstallation of mods quick and easy. It automatically detects mods in conflict and provides straightforward methods for resolution via Priorities. The modder is also given the ability to have multiple profiles for quick swapping between different modded setups.

Features

Video play triangle.png
Related Videos:


How to use this guide

This guide has many innovative features intended to help you to quickly find the information desired, so you can get back to modding as quickly as possible. It is also written in a manner that can be read straight through so you can gain a nearly comprehensive knowledge of the program.

Useful side information

Side boxes typically located to the right of the general vicinity of the applicable content are sparingly used throughout the guide to quickly instruct you on key concepts. White skim text may be implemented in these as well.

White skim text

This guide is augmented with white text to help make it easier to skim. Important words are changed to the white color rather than the normal light grey color to form "skim phrases." This is currently inconsistent throughout the guide.

Videos!

Unlike most wiki guides you find on the internet, video tutorials covering the information in this guide are integrated throughout this guide. Official guide videos are linked in the headers, provided by courtesy of GamerPoets. These tutorials are carefully reviewed for their technical correctness and usefulness. Please like and subscribe to show your support, as he does this without any monetary compensation out of his own good free will, like all members contributing to the STEP Project.

Additionally, other related videos that we find useful are linked at the bottom of relevant sections like this example below by Gopher.

Video play triangle.png
Related Videos:


Pictures

Pictures showing the general area of the feature in question are strategically-placed in the throughout the guide. Also notice this picture to the right, which shows you the location of the key parts of the graphical user interface (GUI) referenced throughout this guide: the Toolbar, Left Pane, Right Pane, and Console. See the associated tabs for more information about each section. Currently, the Console does not possess a tab, as it merely helps you troubleshoot problems and visually cues to you that it is working. To hide it, if you so desire, hover the cursor just above the Console box until it changes into a double-arrowed icon and drag it all the way down. This can be done for other parts of the GUI as well. If the Left Pane or Right Pane are invisible, or desired to become hidden from view, hover the cursor between the two panes until it changes into a double-arrowed icon, and drag it to the right or to the left.



Warnings and Notices

You should read all warnings and notices, as they highlight specific areas of difficulty or problems. They shall be located within the area where you will most likely encounter the error.

Info-Logo.png Notice: This is an important notice
Info-Logo.png       Notice:This is a less-important notice
Warning-Logo.png Warning: This is an important warning
Warning-Logo.png       Warning:This is a less-important warning


Installing Mod Organizer

Prerequisites

While Mod Organizer (MO) boasts a standalone and fully modular platform, there are a few things necessary for an optimal experience:

  1. A Nexus Account
    • For many features of MO to work correctly, a Nexus account is required. Membership is free, the registration process is simple, and the benefits are enormous, so there is no reason not to join.
  2. .NET Framework 4+
    • In order for the NCC fomod installer plugin to work, Microsoft .NET Framework 4 or higher is required. You most likely have this installed. It is not required to run MO, but MO will be crippled without it. For instance, the SkyUI installer will not run without this.
  3. Python 2.x x86
    • In order for Python plugin to work, Python 2.7.8 32-bit is required. MO now includes a minimal standalone installation of Python, so you should NOT need to download this. Download and install 'Windows x86 MSI Installer (2.7.8)' to use system Python. Python is currently only used in the Configurator plugin, so it is not absolutely necessary for MO usage.
      Info-Logo.png       Notice:Do NOT install the 3.x series of Python instead of 2.x, as it is NOT backwards compatible with the 2.x series.

Installation

  1. Download the main file from either the Nexus mod page or the Sourceforge files page.
  2. Install into any folder outside User Account Control (the game's main directory is recommended).
  3. To create a shortcut on your desktop, right-click the ModOrganizer executable, hover over the Send To menu, and select Desktop (create shortcut).
Warning-Logo.png       Warning:Before launching Mod Organizer, launch the game at least once so all configuration files are available.


Updates

When an update is available for Mod Organizer, the update button becomes colored Update-MO.png. Click the update button to update. You may have to click it twice: once to log on to the Nexus, and a second time to actually download and install the update. For a more detailed discussion on updating Mod Organizer, please see the this section of the Mod Organizer Advanced Guide.

Initial setup

Info-Logo.png       Notice:Before starting Mod Organizer, launch the game at least once so all configuration files are available.
  1. When first started, Mod Organizer (MO) will present a window asking you to select the game you wish to manage. Select the appropriate game, which should be automatically recognized. If it is not, you may use the browse function to find your game folder and select it.
  2. First time users will receive a message to show the tutorial. It is highly recommended to do so.
  3. Click the wrench Wrench MO.png button in the toolbar, and select the Nexus tab.
  4. Check automatically log in box and insert your Nexus username and password.
  5. Click the globe Globe MO.png button in the toolbar. This allows MO to download mods when the Download with Manager button is clicked on the Nexus.
  6. Turn on the Archive Invalidation method appropriate for your game:
    • If running any game that is not Skyrim, click the profile Profiles MO.png button in the toolbar and check Automatic Archive Invalidation. Repeat this for all new profiles you create.
    • If running Skyrim, click the wrench Wrench MO.png button, go to the Workarounds tab, and click Back-date BSAs.
  7. This is all the initial setup necessary to begin. Now you can probably begin modding, referring back to this wiki for more information about different functions as necessary.
Warning-Logo.png       Warning:If your game is installed to a UAC-protected directory, e.g. Program Files, then you may have to run MO as administrator or give your regular user account access rights. This is not recommended. The alternative and safer method is to edit the security settings of the folder to give your user account full control.



Toolbar


Six buttons are located in the toolbar at top left and three more are displayed at top right. The first six buttons at top left depict an archive, globe, profile, gear, puzzle, and wrench:

  • The archive Archive MO.png button can be used to install a mod by browsing to the mod's archive and opening it. It is not currently possible to install a mod that is not inside an archive with this button.
  • The globe Globe MO.png button can be used to launch your web browser to the Nexus homepage of the game being managed. In addition to this function, it also sets up MO to download mods for your game via the Download with Manager buttons.
  • The profile Profiles MO.png button can be used to set up different configurations of mods in MO. To learn more, see the Profiles tab.
  • The gear Gear MO.png button can be used to manage the applications that can be run inside MO. To learn more, see the Third Party Programs tab.
  • The puzzle Puzzle mo.png menu can be used to launch various plugins for MO. This currently includes the INI editor, NMM import, and Configurator plugin. To learn more, see the Tools section under the Plugins tab.
  • The wrench Wrench MO.png button can be used to configure different aspects of how Mod Organizer works. To learn more, see the Settings tab.

The three buttons at top right include the warning icon, update button, and help menu.

  • The warning Warning NA MO.png icon tells you if there are potential problems with your Mod Organizer setup. When there are no warnings, it will be greyed out. When the triangle is red Warn mo li.png, clicking the warning will inform you of the potential problem detected.
  • The update Update-MO.png button is used to update Mod Organizer to the newest version. If it is greyed out Update NA MO.png, there is no update available. When it becomes colored Update-MO.png, Mod Organizer may be updated through this button.
  • The help Help MO.png menu may be used whenever you need help with Mod Organizer. It can be used to tell you more about individual elements of the UI. To use it, click help in the main window toolbar (or the ?-button in each dialog box) and point the cursor on the control you want to know more about. Whenever the button hovers over some element it can tell you more about, it will turn into a question mark. Once it transforms into a question mark, you can left-click to read about that element. The help menu also has a link to the Mod Organizer wiki, a Report Issue button that takes you to Mod Organizer's official bug tracker, and options to launch different guided tutorials.

Left Pane

The left pane displays all installed mods, their priority order and enabled status depicted according to the selected profile. Mods can be sorted by name, flag, category, version number, priority, installation date, or Nexus ID.

Profiles

To change profiles, click on the profile drop-down box and select the desired profile. To learn more about profiles, see the Profiles tab.

Columns

The left pane has many columns displaying various information about each mod. You can turn off any column you feel you don't need by right-clicking on the column bar and unchecking it.

Mod Name

The Mod Name is whatever you call a mod upon installation. Installed mods may be sorted alphabetically by clicking the Mod Name column. To edit a mod's name, single-click twice on the mod's current name and then type in the new name. Alternately, single-click once on the mod's current name, press F2, and then type in the new name.

Flags

Flags are special icons that inform you about file conflicts between installed mods, current endorsement status, and whether or not Mod Organizer thinks you've installed the mod correctly.

What do the Flags mean?

If a lightning icon with a green plus sign Lightning Plus MO.png appears in the Flags column, when the virtual data directory is created the corresponding mod will overwrite file(s) from a lower priority mod while none of its files will be overwritten. If a lightning icon with a red minus sign Lightning Minus MO.png appears, the mod will will not overwrite files from any other mod but will have one or more of its files overwritten by a higher priority mod. If a lightning icon with both a green plus sign and a red minus sign Lightning Plus Minus MO.png appears, the corresponding mod will overwrite a lower priority mod's file(s) while having one or more of its files overwritten by a higher priority mod. If a lightning icon Lightning Dim MO.png appears without a plus or minus sign, the mod will be completely overwritten by other mod(s) and might as well not be installed.

The red X Big Red X MO.png icon appears when an installed mod does not contain any data that Mod Organizer recognizes as valid mod information. In addition, the mod name will be greyed out and italicized. If you want to use the mod despite this fact, you can right-click the mod and select Ignore missing data to remove the flag. This will put an empty textures folder in the mod directory, which MO will see as valid data despite the fact that it does absolutely nothing.

The heart question Unendorsed MO.png icon appears when a mod has not been endorsed.

The notes Notes MO.png icon appears when you add notes to the mod.


Category

Sorting by category can be useful if you remember what a mod does, but you can't remember its name. If you have not categorized your mods, this might be less useful.

Nexus ID

Sorting by Nexus ID can be rather useless, unless you want to find your oldest or newest mod quickly. This, of course, is retrieved from the Nexus ID of the mod, and shall show a value of 0 for non-Nexus mods.

Version

This tells you what version of the mod is installed and whether or not it is up to date. If the version number is in green, it is the latest version. If it is red, there is a new version available. If it is red with a warning Warning icon MO.png flag in front of it, the version you have installed is higher numerically but does not appear to match the current version on the Nexus.

Installation

This will tell you the date and time the mod was installed.

Priority

The priority of a mod determines how important that mod is to Mod Organizer. The numerical priority value determines the precedence of the mod. If a mod has a high numerical priority value, it will be loaded last and overwrite any conflicts of any mod of less priority. In other words, if two mods have a conflict, the one loaded last will overwrite the change of the one loaded earlier. It is default and recommended to sort by priority ascending, so you can drag and drop mods to change priority. You can also sort by priority descending, which will also allow you to drag and drop priority order, but it is backward to the norm and may be confusing.

Context menu

Right-click or press Shift + F10 in the Left Pane to open the context menu. You can access the All Mods portion alternatively by clicking the Open list options Mo wrench menu.png menu beside the profile drop-down. You will only get the All Mods menu if clicking on a Non-MO mod.

All mods
  • Install Mod... Presents you with the file browser allowing you to install a new mod from an archive. This works exactly the same as clicking the Archive Archive MO.png button in the toolbar.
  • Enable all visible Enables all mods you have installed in the left pane that are currently visible. If you only want to enable the mods within a specific category, you can open the Filters sidebar, select the category, access the context menu, and click this option.
  • Disable all visible Disables all mods currently visible in the left pane. If you only want to disable the mods within a specific category, you can open the Filters sidebar, select the category, access the context menu, and click this option.
  • Check all for update Queries the Nexus to look for updates on mods and their endorsement state. It will also change the filter view to <Update>.
  • Refresh Refreshes the state of your enabled mods and reassesses conflicts.
  • Export to csv... Exports your list of mods to a csv file which can be opened in Microsoft Excel.
Mod-specific
  • Add/Remove Categories Presents you with a drop-down menu where you can add or remove categories for a mod.
  • Replace Categories Presents you with a drop-down menu where you can replace the categories for mods.
  • Primary Category Sets the primary category visible for a mod that will display in the category column.
  • Change versioning scheme Changes the version number system to be compatible with how some modders number their mod versions.
  • Ignore update Ignores the current update notice. If the mod updates again, you will be notified.
  • Rename Mod... Allows you to rename the mod.
  • Remove Mod... Entirely deletes the mod.
  • Reinstall Mod... Entirely deletes the mod and then reinstalls from the archive, provided you still have it in your downloads. If the original archive is unavailable, it will tell you so and do nothing.
  • Endorse Endorses the mod on the Nexus
  • Unendorse Unendorses the mod on the Nexus
  • Won't Endorse Removes the not-endorsed flag Unendorsed MO.png. These mods will be filtered into the <Not Endorsed> category.
  • Endorsement state unknown Non-clickable statement that will remain until you successfully Check all for update.
  • Ignore Missing Data Removes the red X flag Big Red X MO.png by placing a dummy textures folder inside the mod.
  • Visit on Nexus Opens the mod's page on the Nexus if the Nexus id is known.
  • Open in explorer Opens the location of the mod in Windows Explorer.
  • Sync to Mods... A feature to sync from Overwrite to installed mods. There must be a duplicate in an installed mod to use.
  • Create Mod... When Overwrite has files in it, right-clicking and selecting this option will send all Overwrite files into a new mod that you name.
  • Information... Opens the Mod Information dialog box.

Mod Information

The Information dialog box for any mod may be accessed by either double-clicking the mod or via the context menu.

Textfiles

The Textfiles tab show all text files located inside the mod, including readmes and similar documents. It will show a list of all text files at left, which may be viewed by clicking their filenames. You may edit any text file and save using the Save button at the bottom.

INI-Files

The INI-Files tab shows any ini files located inside the mod. You may edit any ini file and save using the Save button at the bottom. You can also create a new ini file tweak for the mod by right-clicking in the lower left box and selecting Create Tweak. After entering a name and clicking OK, you can edit your custom ini file with any ini tweaks you desire.

Mod specific ini tweaks

Back a few versions, Tannin introduced a feature called ini tweaks. You may have seen it when you view the information for a mod in the lower left of the of the “INI-Files” tab. Most if not all mods do not have anything listed in there.

Back then, anafuineluva, on 09 February 2013 asked this question, "Does ini tweaks apply over skyrim.ini only? Is there a way to apply them to skyrimprefs.ini too?"

To which Tannin replied, "ini tweaks do not change skyrim.ini or skyrimprefs.ini, they are used instead of them. This means that if a setting exists in ini tweaks, that setting is used over any other ini. In fact, as it stands right now, ini tweaks should even overwrite settings from other ini files, i.e. skse plugins, but I've never tested that."

I have made use the ini tweaks for the settings that S.T.E.P. recommends and also for the fonts entry needed for DARNui in newvegas. I set up a mod with them and installed it, this way when I switch profiles, I just enable it and do not have to worry about editing the ini itself. Nice feature.

To set up a new custom tweak you can do a couple of things. With MO closed create a new empty folder in the Mods directory and restart MO. MO will now show the new folder as a greyed out mos. An easier way to do this in the current version of MO, is if you have an empty overwrite folder to double click on it open it up and right click and create a new folder, you do not need to rename it. Click close to exit the overwrite folder dialog.

With that done you will be able to right click on the overwrite folder and select “Create Mod” from the right click menu. Give it a name that reflects what you want, something like Custom ini Tweaks and press OK. You now have a new mod named Custom ini Tweaks.

In either case double click on the new mod to open the information pane and select the INI-Files tab. Click in the lower left box and right click to get the “create Tweak” fly out menu. Enter the name of the tweak in the dialog that pops up and click OK.

Say you want to do the fonts from Darnified UI. Name the tweak Darn fonts and click OK. Click on the new entry and in the big box on the right copy and paste the whole section from the readme starting with the [Fonts] header. The save button will become active, click it to save the tweak and close the information pane. Re-open the information pane and the new tweak will now have a check box next to it, click it to put a check in the box to activate it.

Another option is if a mod needs a certain entry for the mod to function right you can just open the mod and create the tweak for it there. The iMaxGrassTypesPerTexure=XX in Skyrim Flora Overhaul by Vurt comes to mind. Don’t forget the [grass] before it. This way the tweak will be enabled when the mod is.

A condensed version of the above is:

  1. Double click any mod in your installed mod list (e.g. your RWT2/Skyfalls Patch)
  2. Open to INI-tab
  3. In the bottom-left pane, right-mouse click and select Create Tweak
  4. Enter a name (e.g. Particle Tweak)
  5. In the Right Pane, type the ini tweak you want to make. E.g.[Particles] iMaxDesired=6000
  6. Save and close
Images

Images contained in the mod will be able to be seen in the Images tab.

Optional ESPs

The Optional ESPs tab gives you the ability to move any of the current mod's plugins to an inactive, optional place so that you have the plugin file handy but will not accidentally enable it. Please note that the message that MO normally gives you when enabling a mod with multiple ESPs in it will NOT be triggered by additional plugins located in Optional ESPs.

Conflicts

The Conflicts tab provides an overview of any and all conflicting files between currently enabled mods. There are three boxes toward the right which tell how many files, consecutively from top to bottom, are (1) in conflict but overwriting other mods, (2) in conflict and being overwritten by other mods, and (3) not in conflict with any other enabled mods.

Files in the current mod that are overwriting files from another mod in a lower priority position are listed in the top pane. The files in conflict are listed with their paths on the left, and the source(s) of the conflicting files are shown on the right, in order from lowest priority to highest. In order to allow a different mod to provide the conflicting file, you must change the priority position of the current mod to be before the other mod. Alternately, you can right-click any of the conflicting files and select Hide, which will effectively remove the file from the current mod (It actually appends a .mohidden file extension to the file so that it will not be used, but easily restored by going into the Filetree tab, right-clicking, and Unhiding the file). At top right of this pane is the number of all files that are in conflict that this mod is providing.

Files in the current mod that are being overwritten by other enabled mods in a higher priority position are listed in the bottom pane. The files in conflict are listed with their paths on the left, and the name of the mod providing the conflicting file is shown on the left (there is only one providing mod). You cannot hide any files in this pane. At top right of this pane is the number of all files that are in conflict that another mod is providing.

Categories

The Categories tab allows you to change the categories for the mod.

Nexus Info

The Nexus Info tab will show you the text from the Nexus page identified by the Mod ID at top left. Edit the Mod ID if it is incorrect, as otherwise the current version information will also be incorrect. Editing the Version number may be done at top right if incorrect. Clicking the blue Visit on Nexus link should take should open the mod page in your web browser.

Notes

In the Notes tab you can create notes for the mod. These notes can be seen you hover over the note flag Notes MO.png for the mod.

Filetree

Mod Organizer's (MO) Filetree tab displays all files in the mod, including the MO-generated meta.ini file. MO stores information about the mod inside this meta.ini file, so do not touch it. Using the context menu in Filetree, you can create new folders, open files, rename files/folders, delete files/folders, and hide files/folders. You can also drag and drop files/folders into new locations within the mod. This pane is most useful for making sure everything has been installed to the correct folders, especially when a FOMOD installer fails to install correctly.

To access the Filetree, double-click an installed mod in the left pane of Mod Organizer and select Filetree at top right (or right-click and select Information from the context menu).

To hide a file/folder, right-click it and select Hide. To delete a file/folder, right-click it and select Delete. To rename a file/folder, right-click it and select Rename. Alternatively, you can rename a file/folder by double-clicking it. To open a file, right-click the file and select Open. To create a new folder, right-click in the directory level you wish to place the new folder and select New Folder. To move files/folders around within the mod, simply drag and drop them where you want them to go.



Mod selection and filtering

Mod Organizer (MO) allows multiple ways to find and view mods through grouping, searching, and filtering.

Mod grouping

Currently you can group mods together two different ways via the drop-down menu at the bottom center of the left pane. You can group by categories or Nexus IDs. As a visual hint, the modlist shall be placed inside a green box when mod grouping is active. If you wish to turn off mod grouping, select No Grouping from the drop-down menu.
Warning-Logo.png       Warning:You cannot change mods priorities via drag and drop when Mod grouping is on.



Namefilter

Here you can quickly find your mods by simply typing in parts of their name.

Filters

Mod Organizer has an advanced filtering system, making mod organization easy. To access it, click the Filter button at the left, bottom corner of the Left Pane. This will pop out a sidebar of different filters in it, which are discussed below. To see all mods again after using a filter, either right-click the filter and select Deselect filter, Ctrl+click the filter, or click in any blank space within the sidebar. Filters may be combined by using the And or Or commands at the bottom of the sidebar. Using the And command will filter through and only show mods that meet all selected filter criteria. Conversely, the Or command will show all mods that meet at least one of the filter's criteria. As a visual hint, the modlist shall be placed inside a red box when filters are active.

<Checked>

This filter selects mods that you have enabled for your current profile.

<Unchecked>

This filter selects mods that you have not enabled for your current profile.

<Update>

This filter selects mods that have a newer version available. It is automatically selected when you Check All for Update.

<Managed by MO>

This filter selects mods installed into MO.

<Managed outside MO>

This filter selects Non-MO mods.

<No Category>

This filter selects mods that do not have a category assigned to them.

<Conflicted>

This filter selects enabled mods that have file conflicts with other enabled mods.

<Not Endorsed>

This filter selects mods that have not been endorsed. This includes mods that you have marked as Won't Endorse.

Categories

After all the preset filters, you have the category filters, which simply select mods assigned to the selected category. If you add a custom category, it will show here as well. To add a custom category, right-click in the Filter sidebar and select Edit Categories. To see more about editing categories, see here.

Right Pane

Plugins

The Plugins tab provides load order management for all ESMs/ESPs installed and enabled. Any mod enabled in the Left Pane containing an ESM or ESP file in the root of the mod will appear here. If the ESM/ESP is in another folder besides the root, it will not be used. If a ESM/ESP has a warning Warning icon MO.png flag in front of its name, one of its masters is missing, which will be indicated upon hovering over the file. Load order can easily be modified by dragging and dropping into the correct position. For more information, see the Priorities tab.

If you right-click inside the Plugins tab, you will find you have three options:

  1. Enable all
  2. Disable all
  3. Lock load order (please note that this option is only available for active plugins)

The Enable all function will activate all ESMs/ESPs in the Plugins tab. The Disable all option will deactivate all ESMs/ESPs except Skyrim.esm and Update.esm, which are necessary for the game to function. The Lock load order button can be useful if you want certain plugins to be in a specific order. If you select a bunch of mods and lock them in this order, those mods shall always end up in that order, although other plugins may slip in between them.


Backup and Restore

Mod Organizer allows you to backup your profile's plugin list (load order) and restore it if the need arises. To backup your profile's plugin list, click the Create Backup Document-save.png button at top right of the Plugins tab. Backing this up will NOT backup your INI files, BSA order, or modlist. You can, however, backup your profile's modlist in the Left Pane. To restore a previous plugin list, click the Restore Backup... Restore backup MO.png button to the left of the backup button. Upon restoring a backup, any plugins not active at time of backup shall be unchecked, and all priority/load-order changes since the backup shall be reverted. Also, any new plugins since the backup shall be unticked and in alphabetical order at the bottom of your plugin list.

Sort

The new Sort Arrange-boxes.png button at top left of the Plugins tab automatically sorts your plugins using LOOT. Any rules that you have made with the external LOOT application shall carry over, but you cannot make rules without installing the main LOOT application.



Archives

If a mod contains assets in a BSA file, it will appear in the Archives tab under the mod's name. BSAs may also be unpacked in this tab by right-clicking the BSA and selecting Extract... This will extract the BSA's contents to any folder you choose.

When Have MO manage BSAs is checked in the Archives tab, all BSAs are treated exactly as if they were loose files. That means their priority depends solely on the mod priority order and not the plugin priority order (load order). Additionally, checking a BSA in this mode allows the BSA's assets to be loaded without the need for a dummy plugin.

MO's BSA management may be turned off by unticking the Have MO manage BSAs option. If you decide to do this, please note that you will have to load BSAs through dummy plugins. The game's built-in BSA versus loose files rules shall apply, and BSAs shall be loaded in plugin load order.

A more detailed discussion of BSA priorities is located in the Priorities tab.

Info-Logo.png       Notice:Users who get the "failed to remove limit on archive list!" error message can only load around 80 BSAs by means of checking them. Those users may have to unpack additional BSAs, or load the corresponding ESP, which will allow the game to load the BSA using default game mechanics.


Data

The Data tab provides an overview of how the Skyrim Data directory is seen when a program is launched through Mod Organizer. The File column tells the name of the file and the Mod column tells us the source of the file. If the name reported in the Mod column is colored red, another mod is active that would have provided the same file, but the mod reported in red is currently overwriting that file. If you hover over the red mod name, it will tell you where the conflicting file is located. Ticking Show only conflicts at the bottom of this tab will cause it to only display files that have conflicts between mods.

The context menu in the Data tab accessed by right-clicking provides several useful options. The Open/Execute option will open any file using the default program, or execute the file if it is a EXE or JAR executable application. The Add as Executable option is useful to add applications installed to the data directory quickly to Mod Organizer's list of executables. The Hide option will add a .mohidden file extension to whatever file you are hiding, making it effectively nonexistent. The Write to file option will create a text file listing every single file in your virtual data directory and its source. It will present you with a Save As dialog box, to which you can type whatever name you want for the filename. It is suggested to add a .txt file extension in this window to make opening the file with a text editor simpler. The Refresh option, as well as the big refresh button at the top of the tab, will check for any changes and make sure what you are seeing is current and accurate.


Saves

The Saves tab displays your saved games. Hovering the mouse over a save brings up information about that save, including which ESPs used in the save are missing from the current profile. Right-clicking and selecting Fix Mods... brings up a list of missing ESPs and any mods containing those missing plugins, if available. This provides a simple way to put all your mods for any particular save back into their original configuration.


Downloads

The Downloads tab is where all mods downloaded through Mod Organizer are stored. To learn more, visit the Downloading Mods tab.



General
General Settings and Categories

Language

This is a drop-down list of all languages Mod Organizer has. Currently supported languages include English, Czech, French, German, Korean, Russian, Spanish, Turkish, and Chinese (both simplified and traditional).

Style

Here you can select different skins for Mod Organizer.

Log Level

This controls what data is printed to the ModOrganizer.log file. Debug is most verbose and useful in solving problems. Info prints less information, but is less useful if encounter a bug. If set on Error level, the log file shall only record errors and information on that error shall be almost nonexistent.

Advanced

By ticking Advanced, you are able to change the directories where your downloads, mods, and/or web cache are located on your hard drives(s). This is most useful if you are using a SSD and do not wish to store mod installation archives upon it. It also is useful if you are using multiple Mod Organizer installs and you want them centered on a hub of installed mods.

User Interface

  • Neither Compact Download Interface or Download Meta Information.

    Neither Compact Download Interface or Download Meta Information.

  • Only Download Meta Information ticked.

    Only Download Meta Information ticked.

  • Compact Download Interface or Download Meta Information.

    Compact Download Interface or Download Meta Information.

Compact Download Interface

This option will shrink the viewing space of downloaded archives in the Downloads tab. This will appear like the third image above.

Download Meta Information

This option will display the downloaded archives type (whether a main, update, or optional file) and its version if available. This will appear like the second image above.

Reset Dialogs

If you press the Reset Dialogs button, any place in Mod Organizer where you have selected a Remember Selection box shall be reset.

Configure Mod Categories

Pressing the Configure Mod Categories button will bring up the Categories window, which allows you to edit categories. Right-clicking at any point will bring up a context menu allowing you to add a new category at that position or remove the category selected.

The ID column to the left displays the category ID number. These should never need to be changed and are mainly for reference purposes in association with other IDs only. However, even farther left, in the column without a title, each category is numbered in the order by which they appear in the list of categories. You can click these and drag and drop the categories into new positions thereby. All other fields may be edited by double-clicking or selecting and pressing F2.

Managing categories

You may have noticed as you install mods that some of them have an assigned category and some do not. Mod Organizer (MO) provides a limited set of categories out of the box. You can fix this in MO by creating the missing categories.

To configure new categories, go to Settings and click Configure Mod Categories button across the bottom of the General tab. You will get a new window with the existing categories listed. If you cannot see all of the information in this window stretch it by dragging the right or left edge out a bit.

You can do the following in this window: Single-click on a category to select it. The entire row will become highlighted. Double-clicking on ID, Name, Nexus IDs and Parent ID will enable the edit box for each one.

To add a missing category, right-click on any of the existing categories to get a little pop-up that will let you add or remove a category. Click the Add entry. A new blank category will be created above the highlighted category. MO will assign a new ID to the category with "new" as the name for it.

To add the missing Nexus category, go to the Nexus main page, hover over the Files button at the top of the page, and then select Categories to open the Categories page. To get Nexus IDs, hover over one of the categories and somewhere in your browser you should see the link preview. At the end of the link you will see CAT=some number. Example CAT=67 for Abodes - Player Homes. Go back to MO and highlight your new category. Double-click on the Nexus IDs field and enter the number you got in the previous step. Double-click on the name field to rename from "new" to the category name you want to use.

You may have noticed that some categories have nested sub-categories. You can do this from the same dialog as above. To nest a category you have to specify its Parent ID, the last column to the right of the window. For example you create a new category FOOD and MO assigns a number to it (the ID), say 25. Create another category and call it ROTTEN. Edit the Parent ID in ROTTEN to 25. ROTTEN will now be a sub-category of FOOD.

If at any time you want to remove a category, highlight it, right-click and select remove.

After you are satisfied with your edits close down MO and navigate to the MO folder and look for a file named categories.dat. Make a copy of this file and keep it in a safe place. If you ever need to re-install MO copy it back to the main folder and your edited categories will be ready to go.




Nexus

Login Info

Entering your Nexus ID and password in this box will allow you to log in to the Nexus without having to type this information every time. Tick the checkmark to cause Mod Organizer to automatically log in. It is stored encrypted inside the Modorganizer.ini file.

Offline Mode

Ticking the Offline Mode box will cause Mod Organizer not to access the Internet.

Proxy Settings

Checking the Use HTTP Proxy box will allow Mod Organizer to use your system's proxy settings.

Associate with "Download with Manager" links

Clicking this button will associate Download with Manager links on the Nexus to the version of Mod Organizer for the game being managed.

Servers

When you download a mod, Mod Organizer will create a list of known servers as well as their connection speed. Dragging and dropping servers from the left box into the right box will cause those servers to be preferred over the other ones. This is especially useful for Premium users who may wish to specify Premium servers for faster speeds.



Plugins

Various settings for some Mod Organizer plugin can be set in the Plugins tab in Settings. To learn more, see the Plugins tab.



Workarounds

Steam App ID

This is the ID Steam uses for the game that Mod Organizer is organizing. Do not touch unless you know for sure it is incorrect. More information can be found here.

Load Mechanism

This is the manner through which Mod Organizer (MO) is used in your game. Do not touch unless the default mechanism is failing. If set to Mod Organizer, your game will be hooked when run through MO, loading your mods. If set to Script Extender, MO will be loaded as a plugin when launched through the game's script extender loader. If set to Proxy DLL, MO will be loaded through a DLL application extension method, which is a rather big hack, and should be avoided above all.

NMM Version

This is the version of NMM for which Mod Organizer will set as user agent. It may need to be increased if the Nexus bans any particular version of Nexus Mod Manager from usage.

Hide inactive ESPs/ESMs

This workaround will hide any inactive ESPs/ESMs. Currently bugged, so do not use.

Force-enable game files

The base game files, like Skyrim.esm for Skyrim and its related BSAs, will be mandatory if this box is checked. Unchecking this box allows you to disable the base game files, if so desired. This may be useful if using a total conversion mod built on the game's engine.

Display mods installed outside MO

This option allows you to toggle whether or not all plugin + BSA mods in the real data directory are displayed as Non-MO mods in the modlist. Disabling this feature will only remove mods installed into data, not the official DLC.

Back-date BSAs

This is an alternative to Archive Invalidation that only works on Skyrim. You must click this if you are running Skyrim and do not activate Archive Invalidation. Otherwise you risk vanilla BSAs overwriting some of your loose files, which is a pain to troubleshoot.



Plugins

Mod Organizer (MO) can be extended in a few ways through plugins. Plugins can be written in C++/Qt or in Python (the Python API is currently slightly limited in comparison to the C++ one and requires users to have Python installed).

There are currently three kinds of plugins: extensions, installers, and tools.

Extensions

Extensions add to the capabilities of Mod Organizer by adding support for other coding languages.

  • Python Proxy - An extension that allows Mod Organizer to run Python plugins if supported. It also allows the user to specify the Python to be used by proxy to Python location.

Installers

Mods are packaged in many different ways. Installers allow MO to handle these different types of archives.

  • BAIN - Installs archives packaged for the Wrye Bash package manager. Right now it does not support wizards.
  • Bundle - Proxy installer for archives packaged in another archive (i.e. a FOMOD packaged in a .7z)
  • Fomod - Installs archives that use an xml file to describe the installation options. FOMOD stands for Fallout mod as FOMOD archives were originally developed by Fallout Mod Manager.
  • Manual - Can install almost any package but requires user interaction. Usually the fallback if no other installer works.
  • Fomod (external) - Uses an external tool called NCC based on Nexus Mod Manager to install FOMOD archives. This is slower than the above installer and less well-integrated but much more compatible. This is because NCC supports C# scripts in addition to xml scripts.
  • Simple - Allows one-click install for mods packaged in simple data level format.

Tools

These plugins usually work similar to stand-alone tools, but they can interfere with the main MO application (e.g., requesting information about the active profile or resolving file names in the virtual directory).

  • BSA Extractor - This plugin allows you to extract BSAs in a mod during installation.
  • FNIS Checker - This plugin informs you when you should run FNIS before you start your game.
  • Basic Diagnosis Plugin - Checks for problems unrelated to other plugins.
  • INI Editor - Basic text editor to edit the game configuration. This is a good starting point for anyone interested in developing a plugin using C++.
  • NMM Import - Imports mods installed through NMM into MO. Not well tested.
  • Preview Base - Provides the ability to preview various types of files.
  • DDS Preview - Provides the ability to preview DDS files based on code from the niftools project.
  • Configurator - More sophisticated configuration editor for the skyrim.ini and skyrimprefs.ini files. It is currently the only official plugin written in Python.

Plugin settings

Various settings for some Mod Organizer plugins can be set in the Plugins tab in Settings. This section talks about what these settings are and how they are used.

BSA Extractor

The BSA Extractor has one setting that can be set to a Boolean value. If enabled is set to false, the plugin will simply be disabled. Conversely, if enabled is set to true, the plugin will be enabled. The default value is disabled. Enabling this plugin causes a dialog to appear the next time a mod including a BSA is installed, giving the option to extract the BSA, with another option to remember the setting.

FNIS Checker

The FNIS Checker has two settings which can be set to Boolean values. If enabled is set to false, the plugin will simply be disabled. Conversely, if enabled is set to true, the plugin will be active. If sensitive is set to false, the plugin will only message you when it is almost if not entirely sure that FNIS must be run. If sensitive is set to true, just about every time you change something in your profile, it will tell you to run FNIS.

INI Editor

The INI Editor has two settings which can be set to Boolean values. The external setting determines whether or not the ini is opened in an external editor. The associated setting determines whether or not the program you currently have associated with ini files will open them. The associated setting will do nothing while the external setting is set to false.

FOMOD Installer

The integrated FOMOD installer has two settings which can be set to Boolean values. If enabled is set to false, the plugin will simply be disabled. Conversely, if enabled is set to true, the plugin will be active. If prefer is set to false, the installer will not be used as long as the NCC FOMOD plugin is working. If prefer is set to true, this installer shall handle all xml-based FOMODs. For more details, see the Installing Mods tab.

Simple Installer

The Simple installer allows correctly-packaged mod archives to simply skip to the quick install window, allowing you to install many mods with just a click. The Simple Installer has two settings that can be set to a Boolean values. If enabled is set to false, the plugin will simply be disabled. If disabled, you will always be presented with the manual install window. Conversely, if enabled is set to true, the plugin will be active. If silent is set to true, then all simple mod archives shall be installed automatically, bypassing the Quick Install menu. Setting silent to false will cause simple mod archives to show the Quick Install menu prior to installation. For more details, see the Installing Mods tab.

Python Proxy

The Python Proxy has one setting that can be set to a Boolean value and another setting that can be set to a string. If enabled is set to false, the plugin will simply be disabled. Conversely, if enabled is set to true, the plugin will be enabled. The python-dir value may be set to the directory where Python is installed.

Blacklisted Plugins

Here are any plugins that have been blacklisted so that they are not enabled. Plugins may become blacklisted if MO detects that they might have caused a crash. Use the delete key to remove any entries.



Third Party Programs

When you use Mod Organizer (MO), all other programs that work with mods (i.e., BOSS, Wrye Bash, Skyrim Launcher, SkyEdit, Creation Kit, etc.) should be started from inside MO. The same is true for all launchers you may use (e.g., SKSE, SBW). Some of the well-known tools for the games supported by MO are automatically detected and added to your list of executables. Other tools must be added manually. A list of automatically detected tools are shown at the end of this page. To launch a game after it has been added to MO's list of executables, select the application from the drop-down list on the top right and click Run.


When you open the Modify Executables dialog by clicking the gears Gear MO.png button, several fields present themselves:

  • Title - This is the name for this application as displayed in the drop-down menu. You may use whatever name you wish.
  • Binary - The full path to the executable to run. Only files that end on .exe or .bat are executables! Other files like .jar or .py require an interpreter (e.g., Java, Python). In those cases you set up the interpreter as the binary here.
  • Start In - This is the working directory for the application. You can usually leave this empty. If you're running a .jar/.py file you may have to set this to the path of the .jar/.py file for it to work correctly.
  • Arguments - These are command line arguments to be passed to the binary. If arguments are required (and which) depends on the app. If you're running a java application (.jar), you set the binary to your "java.exe" or "javaw.exe" and as the argument use "-jar <name of the .jar file>". If you're running a python application (.py or .pyw) you set the binary to your "python.exe" or "pythonw.exe" and the argument to "<name of the .py/pyw file>".
  • Overwrite Steam AppID - This is only required for applications that are distributed via Steam and are not the game itself. The only case I'm aware of is the Creation Kit, and that is set up automatically.
  • Close MO when started - If checked, MO will close when the executable is started. Choose based on your preference.

List of automatically recognized executables

Some executables are added to your list of executables if they are installed at their default location. MO does not search the filing system for them. All of them need to be in the game's base directory (i.e. <Skyrim install directory>/). Supported games include Skyrim, Oblivion, Fallout 3 and Fallout New Vegas.

Originally BOSS was supposed to be installed inside the data folder. Later that was changed so BOSS got its own directory; therefore, there are two locations MO looks in currently: the BOSS folder inside the game's base directory and the data folder inside the base directory.

Skyrim
  • Skyrim Script Extender (skse_loader.exe)
  • Simple Borderless Window (SBW.exe)
  • Skyrim main executable (TESV.exe)
  • Skyrim Launcher (SkyrimLauncher.exe)
  • Creation Kit (CreationKit.exe)
  • BOSS (BOSS/BOSS.exe)
Oblivion
  • Oblivion Script Extender (obse_loader.exe)
  • Oblivion main executable (oblivion.exe)
  • Oblivion Mod Manager (OblivionModManager.exe)
  • Construction Set (TESConstructionSet.exe)
  • Oblivion Launcher (OblivionLauncher.exe)
  • BOSS (BOSS/BOSS.exe or Data/BOSS.exe)
Fallout 3
  • Fallout Script Extender (fose_loader.exe)
  • Fallout main executable (fallout3.exe)
  • Fallout Mod Manager (fomm/fomm.exe)
  • Garden of Eden Creation Kit (geck.exe)
  • Fallout Launcher (FalloutLauncher.exe)
  • BOSS (BOSS/BOSS.exe)
Fallout New Vegas
  • New Vegas Script Extender (nvse_loader.exe)
  • Fallout New Vegas main executable (falloutnv.exe)
  • Fallout Mod Manager (fomm/fomm.exe)
  • Garden of Eden Creation Kit (geck.exe)
  • Fallout New Vegas Launcher (FalloutNVLauncher.exe)
  • BOSS (BOSS/BOSS.exe)

General application setup

  1. Click the gears Gear MO.png button. This opens the Modify Executables window.
  2. In the Title field, type in what you want to call the application. This fills in the Title field.
  3. All the way to the right of the Binary field is a button with an ellipsis with a subtext of "Browse filesystem." Click it. This opens a window where we can browse to the program we want to run.
  4. Navigate to the folder where the program is installed and select the application. This fills in the Binary field.
    • If the program's files are located at the same location as the executable (e.g., TESV.exe is in the Skyrim directory, whereas Reproccer.jar is not in the Java directory), steps 5 and 6 may be skipped, as they would be redundant.
  5. All the way to the right of the Start in field is a button with an ellipsis. Click it. This opens a window where we can browse to the folder where the program we want to run is located.
  6. Navigate to the folder where the program is located and select it. This fills in the Start in field.
  7. Do you need the application to call another file, or input a custom setting? Use the Arguments field for any such needs.
  8. Do you need to overwrite the Steam AppID? Almost undoubtedly not, but if you do, you can check that option and type in the appropriate AppID in the field provided.
  9. Do you desire to close MO when you start the program? Only if you are launching the game, most likely. If you do, check the Close MO when started option.
  10. Click the Add button. This will add the application to your executables list.
  11. Click Close to close the dialog.

Note: Typical application setup does not require steps 5 through 9.

General application troubleshooting

Problem: An error occurs launching the application saying, "This application could not be started. Do you want to view information about this issue?"
Probable cause: The application is installed as a mod in Mod Organizer, but is unchecked in the Left Pane modlist.
General Solution: Check the application's mod in the Left Pane modlist.

Problem: Launching an application fails. Mod Organizer locks for a few seconds, but then simply unlocks and does nothing.
Probable cause: The application is installed as a mod in Mod Organizer, but is unchecked in the Left Pane modlist.
General Solution: Check the application's mod in the Left Pane modlist.

Problem: Launching an application produces an "Elevation required" message.
Probable cause: The application being launched requires administrative permissions.
General Solution: Click the Yes button if you trust the application to have administrative privileges.

Problem: The application launches correctly, but fails to use the custom argument(s) entered in the Modify Executables dialog.
Probable Cause: You are launching the application from a shortcut that was created before the custom argument(s) were added.
General Solution:

  1. Click the Shortcut drop-down menu.
  2. Remove all shortcuts. If you manually renamed any of them, you will have to delete those shortcuts manually.
  3. Recreate the shortcuts desired.

BodySlide 2 and Outfit Studio

To install BodySlide 2 and Outfit Studio in Mod Organizer:

  1. Once MO opens the archive, it will not detect any game data.
    • Select Set data directory.
    • Click OK to install.
    • Select Ignore at the prompt.
  2. The red X Big Red X MO.png flag will appear for the mod in the Left Pane.
    • Right-click the mod.
    • Select Ignore missing data.
  3. Enable the mod by ticking its check mark.

BodySlide 2 and Outfit Studio can be added to the list of executable via default procedure:

  1. Click the gears Gear MO.png button. This opens the Modify Executables window.
  2. In the Title field, type "BodySlide 2 and Outfit Studio" (or whatever else you desire to call it). This fills in the Title field.
  3. All the way to the right of the Binary field is a button with an ellipsis with a subtext of "Browse filesystem." Click it. This opens a window where we can browse to the program we want to run.
  4. Navigate to the BodySlide directory and select the "BodySlide.exe" application. This fills in the Binary field.
  5. Click the Add button. This will add BodySlide 2 and Outfit Studio to your executables list.
  6. Click Close to close the dialog.
  7. The same procedure may be used to add the other applications within this mod.

Better Oblivion Sorting Software (BOSS)

Better Oblivion Sorting Software (BOSS) can be added to the list of executable via default procedure:
  1. Click the gears Gear MO.png button. This opens the Modify Executables window.
  2. In the Title field, type "BOSS" (or whatever else you desire to call it). This fills in the Title field.
  3. All the way to the right of the Binary field is a button with an ellipsis with a subtext of "Browse filesystem." Click it. This opens a window where we can browse to the program we want to run.
  4. Navigate to BOSS's directory (probably C:\BOSS) and select the "BOSS GUI.exe" application. This fills in the Binary field.
  5. Click the Add button. This will add BOSS to your executables list.
  6. Click Close to close the dialog.

Please note:

  • You may alternatively use the command-line "BOSS.exe" executable in the BOSS directory to bypass the GUI.



BOSS Userlist Manager (BUM)

BOSS Userlist Manager (BUM) can be added to the list of executable via default procedure:

  1. Click the gears Gear MO.png button. This opens the Modify Executables window.
  2. In the Title field, type "BUM" (or whatever else you desire to call it). This fills in the Title field.
  3. All the way to the right of the Binary field is a button with an ellipsis with a subtext of "Browse filesystem." Click it. This opens a window where we can browse to the program we want to run.
  4. Navigate to BUM's directory and select the "BOSS Userlist Manager.exe" application. This fills in the Binary field.
  5. Click the Add button. This will add BUM to your executables list.
  6. Click Close to close the dialog.

Please note:

  • When BUM is first run it will want to set up its configuration information.
    • Under Game selection select the appropriate game.
    • The Mod Path should be the path to the game's Data folder (e.g., C:\Steam\SteamApps\common\skyrim\Data\).
    • The Masterlist path is the path where the BOSS program is installed (e.g., C:\BOSS\Skyrim).
    • The Boss program is the path to the BOSS executable that is going to be used. (e.g., C:\BOSS\BOSS.exe).
    • Click Save. If asked to configure other installed games repeat the above steps. If the other games are not needed, delete the Mod Path line and BUM will ignore those games.



Creation Kit

The Creation Kit should be automatically detected and added to the executables list upon first startup, so there is no setup necessary. Using the Creation Kit with MO is a bit complicated currently, however, for the following reasons:

  • While the Creation Kit is running, files you add to one of the mod directories do not become visible until CK is restarted.
  • After saving the changes the esp file is moved to the Overwrite mod.
  • The script compiler does not work in Mod Organizer, because it is a 64-bit application. To compile scripts, you will have to temporarily move the scripts to the data directory.

If for whatever reason the Creation Kit is not in your list of applications, you may add it manually by doing the following:

  1. Click the gears Gear MO.png button. This opens the Modify Executables window.
  2. In the Title field, type "Creation Kit" (or whatever else you desire to call it). This fills in the Title field.
  3. All the way to the right of the Binary field is a button with an ellipsis with a subtext of "Browse filesystem." Click it. This opens a window where we can browse to the program we want to run.
  4. Navigate to the game directory and select the "CreationKit.exe" application. This fills in the Binary field.
  5. Check the Overwrite Steam AppID option and enter the number 202480 in the field beside it.
  6. Click the Add button. This will add the Creation Kit to your executables list.
  7. Click Close to close the dialog.

Compiling Scripts in Creation Kit through Mod Organizer

Since the Papyrus Script Compiler for the Creation Kit is a 64-bit executable which MO cannot handle, you cannot natively compile scripts from the Creation Kit. Except you can, because as it turns out, the PapyrusCompiler is in fact an "Any CPU" executable, which means it contains binaries for 32-bit as well as 64-bit, so if we could convince the compiler to run in 32-bit mode even on a 64-bit operating system, we can then compile scripts normally. You can do this by doing the following:

  1. Download the "windows sdk with .net" package from the microsoft page. There are multiple versions of the package, it does not really matter which one you get, but here is a very current one.
  2. Start the downloaded installer. Take note of the install location (I'll assume "C:\program files (x86)\Microsoft Kits\windows\8.1a"). During the installation you can select the features you want to install. You only need ".NET Framework 4.5.1 Software Development Kit" (or similar if you downloaded a different package).
  3. Open a command prompt (in the search field of the start menu type cmd then click on cmd.exe)
  4. Type in the following: "C:\program files (x86)\Microsoft Kits\8.1a\bin\NETFX 4.5.1 Tools\corflags.exe" /32bit+ "c:\Program Files (x86)\steam\steam apps\common\skyrim\papyrus compiler\papyruscompiler.exe"
    (This makes the papyruscompiler always run in 32-bit mode. If you ever want to undo that, run the same command with /32bit- instead of /32bit+) Now with the current version of MO (1.2.14 and earlier) there is one more step because currently MO has a workaround for the papyruscompiler that doesn't work 100% and won't be needed with this solution.
  5. Download this and drop it into your MO directory. This is the same hook.dll as MO 1.2.14 but with the workaround removed. From now on you should be able to run CK from MO and compile scripts without a problem.



Fore's New Idles for Skyrim (FNIS)

Fore's New Idles for Skyrim (FNIS) may be added in this manner:
  1. Click the gears Gear MO.png button. This opens the Modify Executables window.
  2. In the Title field, type FNIS.
  3. For the Binary field, browse to your FNIS installation (should be located in <ModOrganizer>/mods/Fores New Idles in Skyrim - FNIS/tools/GenerateFNIS_for_Users) and select the GenerateFNISforUsers.exe application.
  4. Click the Add button. This will add FNIS to your executables list.
  5. Click Close to close the dialog.


Please note:

  • After closing FNIS, there shall be files in Overwrite (essentially a fake mod located at the bottom of the Left Pane if sorted by priority ascending) created by FNIS. Right-click Overwrite and select Create Mod, name it FNIS Output and click OK. This will create a new mod listing in the Left Pane for the FNIS generated files. You will then need to check it to enable it. Each subsequent time you update FNIS behavior, you must open Overwrite and drag the new files back to this mod.
  • If you receive a This application cannot be started message, most likely you forgot to enable the mod in the Left Pane.

Free Commander XE

Free Commander XE (FCXE) is an easy-to-use alternative to the standard windows file manager (windows explorer). If you want to see the virtual filing system of MO in action, for example to test if MO is working correctly, you should start FCXE from inside MO. Navigate to your <Skyrim>/data directory. What you see here is what MO exposes to all programs started from inside MO, including Skyrim itself. If you use the windows explorer to navigate to your <Skyrim>/data directory you see only the files of a fresh install of Skyrim. That is under the assumption you have not placed other files/mods in here (manually or using NMM). Note: When you have installed the High Resolution Texture Pack DLC, those files will be installed by Steam in the <Skyrim>/data directory. The same is true for the other three non-free DLC's. When you navigate to the directory where the regular skyrim.ini and skyrimprefs.ini files reside and open these files you also see the contents you configured using MO. Its also possible to edit both ini files.

Info-Logo.png       Notice:For technical reasons, you cannot use Windows Explorer or programs based on Windows Explorer for this. You can use other alternative file managers like Total Commander (TC) however. FCXE and TC have been tested and work flawlessly.

MO only supports 32 bits programs, so make sure you install the 32 bits version of FCXE.

To set up Free Commander XE to work with MO:

  1. Click the gears Gear MO.png button. This opens the Modify Executables window.
  2. In the Title field, type in "Free Commander XE" (or whatever else you want to call it). This fills in the Title field.
  3. All the way to the right of the Binary field is a button with an ellipsis with a subtext of "Browse filesystem." Click it. This opens a window where we can browse to the program we want to run.
  4. Navigate to your FreeCommanderXE directory and select the "FreeCommander.exe" application. This fills in the Binary field.
  5. Click the Add button. This will add Free Commander XE to your executables list.
  6. Click Close to close the dialog.



LOOT

To set up LOOT to work with MO:

  1. Click the gears Gear MO.png button. This opens the Modify Executables window.
  2. In the Title field, type LOOT.
  3. For the Binary field, browse to your LOOT installation and select the LOOT.exe application.
  4. Click the Add button. This will add LOOT to your executables list.
  5. Click Close to close the dialog.

Now each time you want to run LOOT, simply select it from the drop-down menu at top right and click Run.

Simple Borderless Window (SBW)

To set up Simple Borderless Window (SBW) to work with MO:

  1. Click the gears Gear MO.png button. This opens the Modify Executables window.
  2. In the Title field, type in "SBW" (or whatever else you want to call it). This fills in the Title field.
  3. All the way to the right of the Binary field is a button with an ellipsis with a subtext of "Browse filesystem." Click it. This opens a window where we can browse to the program we want to run.
  4. Navigate to your Skyrim directory and select the "SBW.exe" application. This fills in the Binary field.
  5. Check the Close MO when started option. This causes MO to close upon launch of SBW.
  6. Click the Add button. This will add SBW to your executables list.
  7. Click Close to close the dialog.

Please note:

  • The skyrimprefs.ini for each profile must be edited, changing the "bFull Screen" value to 0, for Skyrim to launch in windowed mode.
  • The picture shows when you alt-tab in Skyrim. While in game you will not see the tray or anything else. It will be windowed mode but without the borders: essentially Fullscreen.



Skyrim Script Extender (SKSE)

Skyrim Script Extender should automatically be detected and added to executables. If for whatever reason it is not detected, it may be added by doing the following:
  1. Click the gears Gear MO.png button. This opens the Modify Executables window.
  2. In the Title field, type in "SKSE" (or whatever else you want to call it). This fills in the Title field.
  3. All the way to the right of the Binary field is a button with an ellipsis with a subtext of "Browse filesystem." Click it. This opens a window where we can browse to the program we want to run.
  4. Navigate to your Skyrim directory and select the "skse_loader.exe" application. This fills in the Binary field.
  5. Check the Close MO when started option. This causes MO to close upon launch of SKSE.
  6. Click the Add button. This will add SKSE to your executables list.
  7. Click Close to close the dialog.

Please note:

  • SKSE may not be installed as a mod via MO. You may, however, install the scripts via MO to keep your data directory clean (provided that you haven't changed MO's load mechanism to Script Extender).
  • SKSE plugins may be installed and used via MO (provided that you haven't changed MO's load mechanism to Script Extender).


Troubleshooting

Problem: SKSE fails to launch, producing a "Couldn't read arguments" error popup message.
Probable Cause: You have set an incorrect argument for SKSE.
General Solution:

  1. Click the gears Gear MO.png button. This opens the Modify Executables window.
  2. Select SKSE from the top window.
  3. Remove or fix the incorrect argument. Valid arguments for SKSE:
    • -h
    • -help
    • -editor
    • -priority <level>
    • -altexe <path>
    • -altdll <path>
    • -crconly
    • -waitforclose
    • -fpslimit <max fps> (require FPS Limiter mod)
    • -v
    • -msinfo
    • -noskiplauncher
    • -launchsteam
    • -affinity <mask>
    • -forcesteamloader
  4. Click the Modify button to save changes.
  5. Click the Close button to exit the dialog.
  6. Any SKSE shortcuts set up while this incorrect argument was in place will need to be removed and recreated.



SkyProc Patchers

SkyProc Patchers such as ASIS, Automatic Variants, Reproccer and similar, are Java executable "jar" files and not actual executables. To add any SkyProc program to executables:

  1. In the Right Pane, go to the Data tab.
  2. Locate the SkyProc Patchers directory and expand to the SkyProc program you want to use.
  3. Right-click the .jar file and select Add as executable.
  4. Enter a name and finish.

Please note:

  • 32-bit Java is required to run SkyProc Patchers.
  • You may be asked to select the Java executable. It wants the "javaw.exe" file typically located inside Java\jre7\bin in your Program Files directory.
  • Instead of adding as executable, you may simply execute it from the Data tab by right-clicking and selecting Open/Execute. This is useful if you run all your patchers via SUM and you find yourself in need of running one of them manually.
  • BOSS may be bypassed by adding -noboss to the end of the Arguments field in Configure Executables.

Troubleshooting

Problem: Patcher failing due to esps sorted incorrectly (throws an error saying something akin to missing master).
Probable Cause: You have an esp in your load order which requires a master which currently is lower in your load order than the esp requiring the master.
General Solution:

  1. Place the esp in the correct spot (below the master file it requires).
  2. Add -noboss to the end of the Arguments line for the patcher in MO.
  3. Run the patcher and patch as normal.

Or

  1. Place the esp in the correct spot (below the master file it requires).
  2. Launch SUM (install it if you do not have it).
  3. Change SUM settings so that BOSS doesn't run.
  4. Run the patcher through SUM and patch as normal.

Problem: Patcher failing, throwing an error saying it cannot find something, or some other random error.
Probable Cause: Java is out of date.
General Solution:

  1. Download the latest Windows x86 offline version from here if running Windows XP or from here if running Windows Vista or higher.
  2. Install it.

Problem: Patcher failing, throwing an error related to memory.
Probable Cause: Java is running out of memory to perform the operation.
Possible Solution:

  1. Launch SUM (install it if you don't have it).
  2. Allocate more memory in the Other Settings panel
  3. Run the patcher through SUM and patch as normal.

And/Or

  1. Close any java application. The files java.exe and javaw.exe cannot be opened.
  2. Download this 4GB patch.
  3. Extract it anywhere and execute the "4gb_patch.exe" file.
  4. Find your java (32-bit) bin folder (something like C:/Program Files (x86)/Java/jre8/bin).
  5. Apply the patch in both java.exe and javaw.exe files.
  6. Launch SUM (install it if you do not have it).
  7. Allocate more memory in the Other Settings panel
  8. Run the patcher through SUM and patch as normal.




TES5Edit (also TES4Edit, FNVEdit, and FO3Edit)

To add TES5Edit to executables:

  1. Click the gears Gear MO.png button. This opens the Modify Executables window.
  2. In the Title field, type "TES5Edit" (or whatever else you desire to call it). This fills in the Title field.
  3. All the way to the right of the Binary field is a button with an ellipsis with a subtext of "Browse filesystem." Click it. This opens a window where we can browse to the program we want to run.
  4. Navigate to the game directory and select the "TES5Edit.exe" application. This fills in the Binary field.
  5. Click the Add button. This will add TES5Edit to your executables list.
  6. Click Close to close the dialog.

Please note:

  • If Backup Plugins is checked in TES5Edit, files are saved to original file location, overwriting them, and a backup is created in Overwrite inside the TES5Edit Backups folder (please note that this behavior is different from older versions of MO, in which case no matter what, the modified file was saved in Overwrite).
  • If Backup Plugins is unchecked in TES5Edit, files are saved to original file location, overwriting them without creating backups (please note that this behavior is different from older versions of MO, in which case the modified file always went to overwrite).



Wrye Bash

Wrye Bash comes in two variants: standalone and Python. The standalone version may be added to MO like any other program, however you have to set python.exe/pythonw.exe (32-bit) as the executable and Wrye Bash as the argument for the Python variant.

To add Wrye Bash standalone to executables:
  1. Click the gears Gear MO.png button. This opens the Modify Executables window.
  2. In the Title field, type in "Wrye Bash" (or whatever else you decide to title it). This fills in the Title field.
  3. All the way to the right of the Binary field is a button with an ellipsis with a subtext of "Browse filesystem." Click it. This opens a window where we can browse to the program we want to run.
  4. Navigate to and select "Wrye Bash.exe" located, most likely, in the "Mopy" folder where you installed it. This will fill in the Binary field.
    • Having trouble finding it? It should be in the "Mopy" directory inside your game directory.
  5. Click the Add button. This will add Wrye Bash to your list of applications.
  6. Click Close to close the dialog.

To add Wrye Bash Python to executables:

  1. Click the gears Gear MO.png button. This opens the Modify Executables window.
  2. In the Title field, type in "Wrye Bash Python" (or whatever else you decide to title it). This fills in the Title field.
  3. All the way to the right of the Binary field is a button with an ellipsis with a subtext of "Browse filesystem." Click it. This opens a window where we can browse to the program we want to run.
  4. Navigate to and select "pythonw.exe" inside your Python directory (should be located in C:\Python27). This will fill in the Binary field.
  5. All the way to the right of the Start in field is a button with an ellipsis. Click it. This opens a window where we can browse to the folder where the program we want to run is located.
  6. Navigate to the directory where Wrye Bash was installed and select it (default location is Steam\SteamApps\common\skyrim\Mopy). This will fill in the Start in field.
  7. Leave that all open, but now go into Windows Explorer and find your Wrye Bash directory and enter it. You should see a file called "Wrye Bash Launcher.pyw" inside that folder.
  8. Press down the Shift button and hold, at the same time right-click the "Wrye Bash Launcher.pyw" file. The context menu should appear.
  9. Select Copy as path from the context menu. It may be hard to locate, but it will be about in center of the context menu. If you can't find it, try pressing Shift + right-click again, and it should appear. This will copy the path to the "Wrye Bash Launcher.pyw" to your clipboard.
  10. Now paste the path that you just copied to your clipboard into the Argument field. The argument should now look something like this: "C:\Games\Steam\SteamApps\common\skyrim\Mopy\Wrye Bash Launcher.pyw"
  11. Click the Add button. This will add Wrye Bash to your list of applications.
  12. Click Close to close the dialog.


Please note:

  • If you start Wrye Bash from MO (add it as an executable), it will recognize the plugins (esp, esm) from MO but Wrye Bash will treat them as if the mods had been installed manually.
  • Disabling Wrye Bash's Auto-Ghost functionality when launched through Mod Organizer stops all ESP files being moved from their respective folders to the Data folder.
  • Some versions of Wrye Bash (e.g., Wyre Flash for Fallout 3) do not have a standalone version, in which case the Python setup is necessary.

Shortcuts

Mod Organizer (MO) allows the user to create shortcuts to launch applications through it. Shortcuts may be placed on the Start Menu, Desktop, or the Toolbar within MO itself.

To place a shortcut on the Desktop (or to remove it if it is there already):

  1. Select the application from the executable drop-down menu.
  2. Click the Shortcut drop-down menu.
  3. Select Desktop.

To place a shortcut in the Start Menu (or to remove it if it is there already):

  1. Select the application from the executable drop-down menu.
  2. Click the Shortcut drop-down menu.
  3. Select Start Menu.

To place a shortcut on the Toolbar (or to remove it if it is there already):

  1. Select the application from the executable drop-down menu.
  2. Click the Shortcut drop-down menu.
  3. Select Toolbar.
Warning-Logo.png       Warning:Any arguments, lack of arguments, or other options changed in the Configure Executables dialog will not affect shortcuts made prior to these changes. For the shortcut to receive the new settings, you must delete the shortcut and create it again.


Changing shortcut icons

By default, Start Menu and Desktop shortcuts created through Mod Organizer display its icon and not the icon of the application to be launched. This can be changed by altering the shortcut's icon settings. To do so:

  1. Right-click on the shortcut to be modified and select Properties.
  2. Click the Change Icon... button.
  3. Click Browse...
  4. Browse to the location of the application and select the application (or relevant icon image).
  5. Click Open.
  6. Click OK.
  7. Click Apply.
  8. Click OK.

Profile-specific shortcuts

It is possible to make a shortcut profile-specific. This only works for Desktop and Start Menu shortcuts. If this is done, it will only run in the profile specified. To create a profile-specific shortcut:

  1. Create the shortcut to the application as outlined above.
  2. Right-click on the shortcut created and select Properties.
  3. The Target field will include two strings encompassed by quotes like this: "<ModOrganizer>/ModOrganizer.exe" "<ApplicationFolder>/Application.exe"
    • Between those two strings add -p "Name of Profile" replacing Name of Profile with the name of the profile to be used.
    • The Target field should now look like this: "<ModOrganizer>/ModOrganizer.exe" -p "Name of Profile" "<ApplicationFolder>/Application.exe"
  4. Click Apply.
  5. (Optional) Rename the shortcut in a manner that will indicate which profile it will work on.
  6. Click OK.

Profiles

Profiles in Mod Organizer let you have different mod setups and quickly switch between them. The following aspects are separate for each profile:

  • The selection of enabled mods. This can be toggled by checking and unchecking the mod's checkbox in the Left Pane.
  • The priority order of the installed mods. This can be changed by dragging and dropping mods into the desired priority position in the Left Pane. To learn more, see the Priorities tab.
  • The selection of enabled plugins (ESPs and ESMs). This can be toggled by checking and unchecking the plugin's checkbox in the Plugins tab of the Right Pane.
  • The priority order (load order) of plugins. This can be changed by dragging and dropping plugins into the desired priority position in the Plugins tab of the Right Pane.
  • The selection of enabled BSA files in cases where BSAs are loaded without plugins when using MO BSA management, configured in the Archives tab of the Right Pane.
  • Local saved games (if enabled).
  • Game configuration files (e.g., skyrim.ini, skyrimprefs.ini).
Info-Logo.png       Notice:Please note that the ini files are copies of the global files, created at the time the profile is created. This means that if you change the global ini-files (i.e. by starting the Launcher outside MO) those changes affect profiles created afterwards but not the existing ones.

Mod profiles do NOT control:

  • Optional ESPs. If you move an ESP in an open profile to Optional ESPs, it will be in Optional ESPs for all profiles, even if one of those profiles specified the optional ESP within its load order.
  • Hidden files. If you hide one of the files in an installed mod in one profile, it will be hidden throughout all profiles.
  • Mod names. If you rename a mod in one profile, it will have that name throughout all profiles.
  • Category. If you change the category of a mod in one profile, it will have that category throughout all profiles.
  • Version. If you change the version of a mod in one profile, it will be that version throughout all profiles.
  • Mod ini files. If a mod has an ini file inside it, and you change it inside one profile, it will have that change throughout all profiles.
  • Mod files. If you modify a mod file in one profile, it will be modified throughout all profiles.
  • Notes. If you make a note in the Notes tab for a mod in one profile, it will retain that note throughout all profiles.
  • Nexus mod ID. If you change an installed mod's Nexus ID in one profile, it will be changed throughout all profiles.


Creating profiles

To create a new profile:

  1. Click the profile button.
  2. Click create
  3. Type in a name
  4. If you would like to revert to default ini game settings, check the Default Game Settings box
  5. Click OK
  6. Click close

To create a new profile based on an existing profile:

  1. Click the profile button.
  2. Select the profile from which you would like to base your new profile
  3. Click copy
  4. Type in a name
  5. Click OK
  6. Click close

To go to your newly created profile(s), simply select it from the drop-down list at top left. Alternatively, you can access the Profile drop-down list by pressing F4 (currently only works when you first activate the MO window). Turn on Automatic Archive Invalidation in the Configure Profiles dialog if running any game other than Skyrim. If running Skyrim, clicking the Back-date BSAs button in Settings > Workarounds is all that is necessary.

Local saves

The Local Saves option allows you to keep saves separate from other profiles, rather than all mixed together. Checking Local Saves will make the game look for saves in your profile's save folder instead of the default location. Clicking the Transfer Saves button will allow you to copy or move characters into the profile.

Editing INI settings

MO takes copy of the game INI files upon first launch. Any successive changes to the default game INI files will not be reflected in MO. To edit the INI files, open the Puzzle menu and select either the Configurator to launch a GUI INI editor or click INI Editor to launch a text based ini editor.

Backup and Restore

Mod Organizer allows you to backup your profile's modlist in the Left Pane and restore it if the need arises. To backup your profile's modlist, click the Create Backup Document-save.png button to the right of the profile drop-down menu. Backing this up will NOT backup your INI files, BSA order, or plugin list (load order). You can, however, backup your profile's plugin list in the Plugins tab in the Right Pane. To restore a previous modlist, click the Restore Backup... Restore backup MO.png button to the right of the profile drop-down menu. Upon restoring a backup, any mods not active at time of backup shall be unchecked, and all priority changes since the backup shall be reverted. Also, any new mods since the backup shall be unticked and in alphabetical order at the bottom of your modlist.





Downloading mods

Mods may be downloaded via Mod Organizer (MO) by clicking the Download with Manager buttons on the Nexus mod sites once set up to do so (see step 5 in the Initial Setup section under the Installation tab). Mods downloaded through MO shall appear in the Downloads tab in the Right Pane. Mods can also be downloaded manually and subsequently installed to MO using the Archive Archive MO.png button in the toolbar.

MO collects meta information after the download has completed, including the mod's name, version, and Nexus ID. When a downloaded mod is installed, the meta information determines the name that MO suggests for the mod. Once installed, the Nexus ID and version number is imprinted on the installed mod's information. If meta information has not been collected for a downloaded mod, a warning Warning icon MO.png icon will appear in front of the mod in the Downloads tab. To attempt to retrieve the information:

  1. Right-click the downloaded file in the Downloads tab.
  2. Select Query Info.
  3. If presented with a window asking you to choose between two possible Nexus IDs, select the correct one (normally the higher number). If neither are correct, cancel.
  4. If presented with a window asking you to enter the Nexus ID, enter the correct number (Nexus IDs are the number at the end of URL after nexusmods.com/mods).
  5. If presented with a window asking you to choose the correct file, choose the correct file. If the correct file isn't there, select cancel.

In many cases the meta information collection will fail despite following these steps. This is caused by one of the three following problems:

  1. The file has not been assigned a version number by the mod author.
  2. There are more than thirty files assigned to the mod, and none of the thirty detected by MO were the correct file.
  3. The file doesn't exist on the Nexus.



Please note:

  • The globe Globe MO.png button can be clicked to enable MO to download a file via the Download with Manager buttons on the Nexus.
  • You can select preferred servers for downloading mods inside Settings at the bottom of the Nexus tab. Simply drag and drop your preferred servers into the box on the right (please note that these servers are only identified upon first download of a mod). This is useful if you have a premium account, as you can give premium servers higher priority.
  • If a file says that it is Done in the Downloads tab, it has finished downloading, but is currently not installed. If a file says that it is Installed in the Downloads tab, it has been installed. If a file says that it is Uninstalled in the Downloads tab, it has been uninstalled.
  • Files in the Downloads tab may either be deleted or removed from view. Deleted files are moved to the Recycle Bin. Files that have been removed from view still exist in MO's downloads folder, but shall not appear in MO's Downloads tab.
  • Files that have been removed from view may again be seen by ticking Show Hidden at bottom left of the Downloads tab.
  • Mods downloaded by MO are stored in the "downloads" folder inside the ModOrganizer directory.
  • Manually downloaded mods do not automatically appear in the Downloads tab in MO. If you want the downloaded mod to appear in the Downloads tab, you must manually copy it to MO's downloads folder. You may then follow the steps explained above to collect meta info for the mod.
  • Meta information gathered by MO may not necessarily be correct. If it is incorrect, following installation you may manually enter the correct Nexus ID and/or version number in the Nexus Info tab.

UI Settings

  • Neither Compact Download Interface or Download Meta Information.

    Neither Compact Download Interface or Download Meta Information.

  • Only Download Meta Information ticked.

    Only Download Meta Information ticked.

  • Compact Download Interface or Download Meta Information.

    Compact Download Interface or Download Meta Information.

Compact Download Interface

This option when ticked in Settings will shrink the viewing space of downloaded archives in the Downloads tab. This will appear like the third image above.

Download Meta Information

This option when ticked in Settings will display the downloaded archives type (whether a main, update, or optional file) and its version if available. This will appear like the second image above.

Troubleshooting

Problem: Attempting to install a downloaded mod file produces a "None of the available installer plugins were able to handle that archive." message.
Probable Cause: The downloaded file is corrupt.
General Solution: Re-download the file.

Problem: When I click the Download with Manager button on the Nexus, nothing happens.
Possible solutions: There are many reasons why this may happen. Please try these possible fixes:

  • Click the globe Globe MO.png button.
  • Go to the Nexus tab in Settings and click the Associate with "Download with manager" links button.
  • Go to your ModOrganizer directory and run the nxmhandler application. If the program is pointing to Mod Organizer, click the Register Active button, click yes at the prompt, and close. If the program is not pointing to Mod Organizer, right-click in the window and select Add, select the game you are handling, browse to the appropriate ModOrganizer.exe application, click OK, click the Register Active button, click yes at the prompt, and close.
  • If you are using Google Chrome, locate the "Local State" file (normally located inside C:\<username>\AppData\Local\Google\Chrome\User Data\), open in a text editor while Google Chrome is closed, search for "nxm", delete the line that says "nxm": false (if true, still delete the line), and save. Next time you click the Download with Manager button, Chrome should pop-up a dialog asking to launch the application registered for nxm links. Click Launch.
  • If you are using Firefox, open Firefox and inside Options go to the Applications tab. Search for nxm and point it toward the nxmhandler application located inside the ModOrganizer directory if the option exists.

Managing Nexus downloads for multiple games

When first run, Mod Organizer (MO) sets up an association with the NXM link in Nexus network to handle the download with manager button on the Nexus network. This association, unfortunately, is all encompassing and steals the association from Nexus Mod Manager. MO only supports Oblivion, Fallout 3, Fallout NV and Skyrim while Nexus Mod Manager supports more games.

If you are using Nexus Mod Manager to manage other games that MO does not support you cannot use the download with manager button as it is associated with MO.

The solution to this problem is provided in the ModOrganizer folder in the form of a program called nxmhandler.exe. This little program will allow you to associate another application to handle nxm links alongside MO.

To set up an association to another game and another MO do the following:

  1. Navigate to the ModOrganizer folder and look for nxmhandler.exe. Double click on it to run the program.
  2. In the nxm handler window you should see all the associations assigned to MO.
  3. In a blank area of the window, right click and select Add. This will open a new window with a supported games box and a file browser button.
  4. Select "Other" from the supported games section.
  5. Press the button to open the file browser and navigate to the new client that will handle this association (Nexus Mod Manager for example, Some-path/Nexus Mod Manager/NexusClient.exe) and click open. You will be returned to the Add dialog. Click OK to close the Add dialog
  6. You should now have an entry with "other" as the supported game and the path to NexusClient.exe.
  7. Now we need to determine the name of the game to associate with NMM.
  8. Navigate to the Nexus network game list. Scroll to the name of the game you want to use and click on the link. When the home page of the game you want to use is loaded, look at the URL in the browser address field. At the end of the URL there will be the name of the game. An example for Dragon Age 2 would be http://www.nexusmods.com/dragonage2. We are interested in the last part, dragonage2. Highlight it and copy it to the Windows clip board.
  9. Go back to the nxmhandler window and double-click on "other" in the supported games section. This will allow you to edit the name. Delete "other" and paste the contents of the clipboard in its place. You should now have dragonage2 as the game and the path to NMM. Click close to finish. You should now have an association to Dragon Age 2 that will work alongside what is associated with Mod Organizer.
  10. If you need to associate multiple games to NMM you can just find the name of the game in the URL as described above and run nxmhandler.exe again. Double-click on the supported game entry that point to NMM and add it to the name. Separate the names with a comma. This last one is untested, but when investigating this my results suggest that this is to be true.

Installing mods

Mod Exists

Mod Exists Dialog Box

The Mod Exists dialog box appears whenever you try to install a mod with the same name as an existing mod. This normally occurs when installing optional files for mods or updating a mod.

The Merge button typically should be chosen when installing optional files that are add-ons to the mod. This simply adds the files to the existing mod, overwriting any existing files.

The Replace button generally should be chosen when upgrading a mod to a new version containing all required assets. This deletes all files in the mod and installs the new files in its place.

The Rename button allows you to install the mod under a different name, allowing you to keep the file contents separate from the main mod, or enabling you to install different versions of the same mod.

The Cancel button stops installation.

Ticking the Keep Backup checkmark in combination with either the Merge or Replace options will create a backup of the mod before installing the file. To restore the backup:

  1. Right-click the mod and select Open in explorer.
  2. Delete the mod folder highlighted.
  3. The mod folder directly beneath the folder you deleted will have the same name with "_backup" appended to it. Rename that folder to the original mod's name, removing "_backup" from it.
  4. The mod has now been successfully restored from backup. There used to be a context menu option to perform this operation, but it appears to be missing from the current version.

There are four ways to begin installing a new mod:

  1. Download the mod archive through Mod Organizer (MO) from Nexusmods.com, and then once it has finished, install by double-clicking the file in the Downloads tab in the Right Pane.
  2. Click the Archive Archive MO.png button in the toolbar, browse to the mod archive, select it, and click Open.
  3. Right-click within the Left Pane, select Install Mod... from the context menu, browse to the mod archive, select it, and click Open.
  4. Install a mod from the Steam Workshop by running the game launcher through Mod Organizer (see Installing mods from the Steam Workshop guide below).

When you open most archives, the Name box will show you the name of the mod as parsed from the meta info collected when it was downloaded. If no meta info was collected, it will display the filename of the archive minus the appended Nexus ID and version number. You can rename the mod to anything you desire or keep the name. To speed up the naming process, you can click the down arrow which will present a drop-down box with suggestions of other names based on other mods you've installed sharing the same Nexus ID, the name of the mod archive itself, the name of the mod archive with the Nexus ID and version number attached, and the actual name of the mod from the Nexus.

Mod archives are packaged in three different ways that MO currently supports:

  1. Simple archive
  2. BAIN (Bash Installer)
  3. FOMOD (Fallout Mod)

If the archive is not packaged in any of the first three ways, it will open the manual installation dialog.

Please note:

  • Any time you install a new mod, it will automatically assume the highest numerical priority position. That means, once enabled by checking its box within the current profile, it will overwrite any conflicting mod files in a lower numerical priority position. To learn more, see the Priorities tab.
  • It is currently not possible to start multiple mod installs at the same time.


Manual install

Any mod can be installed manually; it just takes a lot of work. You must read the mod's installation instructions to determine what files you need to put where. Most of the time, however, manual installation within MO's manual installation dialog is quite simple.

When the manual installation dialog comes up, the first thing you should notice is the red text in the bottom left corner that says No game data at top level. The first time this happens, a little tutorial should appear and guide you through the manual installation workflow. Once the message at the bottom corner turns to a green Looks good, pressing OK will install the mod.

  • No game data on top level

    No game data on top level

  • Looks good

    Looks good

Most of the time when the manual installation dialog comes up, you'll see a data folder and a readme. In these cases, most of the time you can simply right-click the data folder, select Set data directory and install. If you set the wrong directory, simply right-click and select the Unset data directory option. Some archives may be more complex, and you may have to move files around into a common data directory to correctly install. Read the installation section and readmes to find out what goes where. You can open an included readme by right-clicking and selecting Open.

You can create new folders within the manual installation dialog by right-clicking the directory level you want to place the folder and selecting Create directory. Some mods may require many directories to be created to place the file in the correct path. If you mess up, you can always modify it in the installed mod's Filetree tab.

You can move files around within the manual installation dialog by dragging and dropping them within the appropriate directory. You can drag multiple items by Ctrl+clicking them. In order to not install a file/folder, simply uncheck the it.

Quick install of simple archives

Quick Install Window

The simple archive is naturally the easiest to install and thankfully is the most common. It presents you with a Quick Install window with only three options. The Manual button will open up the manual installation dialog. The OK button will install the mod. The Cancel button will cancel installation and close the dialog.

Please note:

  • Simple archive quick install functionality may be disabled by going to the Plugins tab inside Settings and setting the enabled value to false for the Simple Installer plugin.
  • Simple archives may be installed automatically (saves a click by always using the OK option to install these mods) by going to the Plugins tab inside Settings and setting the silent value to true for the Simple Installer plugin. You may have to turn this feature off in cases where a mod might require you to install it manually despite being in the simple format.

Installing BAIN archives

Bash Installer (BAIN) archives will open the BAIN Package Installer window. Check the options that you need (referring to the installation instructions on the mod's page or an included readme) and click OK to install. The Package.txt button will open up any package.txt file it finds in the mod archive. It will be greyed out if one does not exist. The Manual button will open up the manual installation dialog. The Cancel button will cancel installation and close the dialog.



Installing FOMOD archives

FOMOD (Fallout Mod) installer archives will launch one of two FOMOD installation plugins depending on whether its script format is coded in XML or C#. XML FOMODs will launch the integrated installer plugin, which will initially extract the files and then present you with the FOMOD Installation Dialog. C# fomods will launch the external installer plugin, which will initially extract the files while presenting you with a window stating that it is running the external installer, and then finally present you with the installation dialog. Simply follow the wizard's instructions to install the mod.


Workarounds for problematic FOMODs

Most of the time, you can simply follow the wizard instructions and everything will install correctly. However, sometimes one of the installation plugin may install the mod incorrectly, and then you may have to resort to an alternate installation method.

Forcing the external installer plugin to install FOMODs

There are two reasons why you may wish to force the external installer plugin (NCC) to install the FOMOD.

  1. The FOMOD does not install the correct files using the integrated plugin.
  2. The FOMOD uses a mod detection script using XML that only recognizes your installed mods using the external installer.

If for one of these two reasons you want to force NCC to install the FOMOD, do the following:

  1. Open Settings by clicking the wrench Wrench MO.png button in the toolbar.
  2. Go to the Plugins tab.
  3. Click on FOMOD Installer.
  4. Double-click on the true value beside prefer.
  5. Select False from the drop-down list.
  6. Click OK.

It is recommended to re-enable the internal plugin to restore default behavior after successful installation of the problematic mod. This may be done by setting the prefer value back to true.

Installing FOMODs with Fallout Mod Manager through Mod Organizer

FOMODs can sometimes be installed using Fallout Mod Manager (FOMM) by running it through Mod Organizer (MO) and creating a mod from the files it dumps inside Overwrite. Please note that FOMM was built for Fallout and may not work for other game FOMODs. Also note that it is preferable to use the default FOMOD installation plugin to using FOMM. For the Fallout games, install FOMM to the game directory in order for Mod Organizer to automatically add it to its list of executables. It may also be added manually by following the instructions in the Third Party Programs tab.

To install a FOMOD through FOMM:

  1. Ensure that your Overwrite directory is empty.
  2. Launch FOMM through MO.
  3. Click Package Manager. Select no to any popups.
  4. Click Add Package and browse to and select the FOMOD archive you wish to install. If it asks to make a copy, select no.
  5. Install the FOMOD with your desired settings, most likely selecting Yes to all to any conflicts, and exit FOMM.
  6. Right-click Overwrite, select Create Mod, enter the name of the mod, click OK and you're done.

Installing mods from the Steam Workshop

Despite lack of integration, Steam Workshop mods are not difficult to install into Mod Organizer.

  1. Ensure that Overwrite is empty.
  2. Subscribe to the mod on Steam Workshop.
  3. Open the game launcher through MO.
  4. Wait until all files are downloaded and exit the launcher.
  5. Right-click on Overwrite and select Create Mod.
  6. Name it whatever you want to call the mod and click OK.
  7. Unsubscribe from the mod on Steam Workshop.
  8. Rinse and repeat for all Steam Workshop mods you wish to install.

To update a mod from Steam Workshop in Mod Organizer, you must repeat the process again, removing the old version.

Updating mods

To check mods for updates, right-click within the Left Pane and select Check all for update. The success or failure of detecting all updates is dependent upon correct meta info for your mods (i.e., correct Nexus ID and version in the Nexus tab). Also, some mod authors use strange version systems that Mod Organizer may not detect. For this reason, it is wise to Track all your installed mods on the Nexus so you can refer to the tracking center for mod updates.

To update a mod, download the new archive and install it to the same mod it was installed last time, replacing if it is a full replacement of the mod or merging if it only updates certain files within the mod. Make certain to assess any new file conflicts and prioritize accordingly (see the Priorities tab).


Uninstalling mods

To uninstall a mod only from a given profile, simply uncheck it in the Left Pane. To uninstall a mod from all profiles, right-click the mod in the Left Pane and select Remove. The removed mod shall be deleted to the Recycle Bin. In the event that the removal was an accident, going into the Recycle Bin and restoring the mod folder will restore it to Mod Organizer. However, it will be treated like a new mod, being unchecked and last in priority.

Enabling mods

Once a mod is installed in the Left Pane, it needs to be enabled and any plugins activated in order for it to show up in game. To enable a mod, simply tick its checkbox in the Left Pane for your current profile. It will be enabled only for your current profile. If you see a lightning icon in the Flags column, some of the mod files conflict with one of your other enabled mods. Go to the Priorities tab to learn how to resolve conflicts in the manner you desire.

Activating mod plugins

Once a mod is installed and enabled, any plugins that the mod contains needs to be activated for them to show up in game. To activate a mod plugin, go to the Plugins tab in the Right Pane, find the plugins you desire to activate and tick their checkboxes.

Priorities

Priorities is a concept developed by Mod Organizer (MO) to manage conflict resolution between mod files. This eliminates many of the traditional functions of replacing other mod files with another mod's files by instead arranging it so that mods in higher priority overwrite mods in lesser priorities without actually replacing the other mod files.


Conflict resolution

Every time you install a mod, it automatically gains highest priority and will provide all conflicting files once enabled. The higher the priority number, the higher priority is given to the mod. If you wish another mod to provide the conflicting files, you must either drag and drop that mod into the higher priority position or drag and drop the freshly installed mod into a lower priority position. Alternatively you can click the mod's priority number, hit F2, change it to a different priority number, and hit enter. You can also CTRL+click and shift+click multiple mods to move many mods into a different priority position.

Most times, changing priorities will be all the conflict resolution you will need. Nevertheless, advanced mod users may desire more advanced control on conflict resolution. If you have two mods that overwrite different files from each and you prefer some from both, you can Hide the files from the mod you do not want to provide the files to cause the other mod's files to be used. This may be accomplished in either the Conflicts or the Filetree tab within the Mod Information window by right-clicking the file to be hidden and selecting Hide. Hiding a file appends a ".mohidden" file extension to the file so that it will effectively not show up in game.

BSA priorities

BSA files are archives that contain assets including textures, meshes, sounds, and scripts. All vanilla data resides in BSAs, and by default, the Skyrim Creation Kit packages assets for mods in BSAs. Traditionally you can not control priority between BSAs and loose files (that is: assets that came as individual files) as BSAs were always overwritten. Therefore, if you wanted to use files from a BSA to overwrite files from a mod that came as loose files, you would have to delete the conflicting loose files manually.

Mod Organizer (MO) adds a feature that changes this. When Have MO manage BSAs is checked in the Archives tab, all BSAs are treated exactly as if they were loose files. That means their priority depends solely on the mod priority order and not the plugin priority order (load order). Additionally, checking a BSA in this mode allows the BSA's assets to be loaded without the need for a dummy plugin. This means that you can, for example, load the Skyrim High Resolution Texture Pack by checking the BSAs and unchecking the plugins, effectively saving you three plugin slots.

MO's BSA management, however, makes mod priorities more important. If asset conflicts are not handled correctly, problems may ensue. Because of this, MO imports all mods/DLCs in the real Data directory that contain BSAs into the Left Pane as Non-MO mods. This ensures that any mod time when a DLC or other mod installed in Data must overwrite a mod installed in MO to get proper conflict resolution, you can do so by changing the priority just like MO mods. An example of this would be the Skyrim Dragonborn DLC and Unofficial Skyrim Patch. If you had installed the Unofficial Skyrim Patch and had it after the Dragonborn DLC, the dragonactorscript.pex would incorrectly overwrite the Dragonborn version, causing the user to not be able to absorb Dragon souls. Unofficial Skyrim Patch must be in a lower priority than Dragonborn for this to be fixed. The user should load the Non-MO mods to as low a priority as possible while maintaining proper conflict resolution. A good guide to this is observing your load order. The DLCs and any mods loaded between them should generally mimic this load order in order for the correct assets to be used.

MO's BSA management may be turned off by unticking the Have MO manage BSAs option. If you decide to do this, please note that you will have to load BSAs through dummy plugins. The game's built-in BSA versus loose files rules shall apply, and BSAs shall be loaded in plugin load order.

What is Overwrite?

In Mod Organizer (MO), in the Left Pane, if you sort by Priority ascending, at the very bottom of your mods, you will see Overwrite in italics. Double-clicking will show you the contents. This is the Overwrite directory (also known as Overwrite folder, Overwrite mod, or simply, Overwrite). It is always the last thing priority-wise, so anything conflicting inside it will overwrite any of your mods, hence the name. In the normal Windows file system, the Overwrite directory exists in <ModOrganizer>/Overwrite. It should not be confused with the real game data directory or the virtualized game data directory. The real game Data directory existing in <path-to-game>/Data. The virtual game data directory for the game doesn't exist anywhere in the Windows file system; it is virtual. It can be seen virtualized in Mod Organizer's Data tab in the Right Pane.

Overwrite is the place that MO dumps all generated files that otherwise would be dumped into the real game data directory. This is true for any tool or mod that is run through MO as long as the file being generated does not already exist in one of your enabled mods or in the real game data directory. If the file already exists in one of your enabled mods or in the real game data directory, it may or may not replace the changed file or create a new copy "overwriting" it in Overwrite, depending on how the tool/mod modifies the data.

How files end up in Overwrite

Any application launched through Mod Organizer (MO) that makes changes to files shall be handled as follows (This is an excerpt from a PM from Tannin):

  • If the application deletes a file, MO does not intervene. The file is deleted from the vfs and if there are multiple files by the same same the one in the highest priority mod gets deleted from disk. BUT all other files by the same name (in other mods) stay around so the next time the vfs is started, the file may exist again (provided by a different mod)
  • If the application moves a file to outside the vfs-directory (Skyrim/data) MO doesn't intervene
  • If the application moves a file into the vfs-directory and the absolute target filepath (that is: the whole virtualised path including filename, i.e. .../Skyrim/data/someplugin.esp) matches the absolute filepath of a file recently deleted (5 seconds I think) MO will move the file instead to the mod from which the file was previously deleted.
  • If the application moves a file into the vfs-directory and the filepath doesn't match a deleted file, the file goes to the overwrite directory.
  • If an application creates a new file, the same rules apply as for the move: If there was a file by the same name deleted recently, the new file goes to that mod, otherwise it goes to overwrite.

Tools that may generate files in Overwrite:

  • Automatic Variants (This SkyProc Patcher will remove all AV Package files and move them to overwrite and create a Automatic Variants.esp plugin. You will have to reinstall your packages if you deleted this generated output.)
  • Creation Kit (only when creating new files)
  • Fallout Mod Manager (FOMM)
  • Fore's New Idles in Skyrim (FNIS)
  • Realistic Colors and Real Nights (every time the RCRN Customizer is run)
  • SkyProc Patchers (may vary between different patchers)
  • Script Extender plugins (if they create a file(s) and only if the file(s) do not already exist). Some specific plugins:
    • Fuz Ro D-oh will create an INI file upon first run of Skyrim with it active. Move it to your Fuz Ro D-oh mod and it will no longer appear in Overwrite. You may edit this file in the INI-Files tab for the mod.
    • RaceMenu CharGen extension (All character presets will be moved into Overwrite. Additionally, each Skyrim run it will generate .tri files in a meshes/cache folder that will be written to Overwrite used as a cache. These .tri files may safely be deleted.)
    • SKSE-Elys-AltF4 will create a log file upon first run of Skyrim with it active. Move it to your SKSE-Elys-AltF4 mod and it will no longer appear in Overwrite and instead will write to that location.
    • Smart Souls will create an INI file upon first run of Skyrim with it active. Move it to your Smart Souls mod and it will no longer appear in Overwrite. You may edit this file in the INI-Files tab for the mod.
  • TES5Edit (only if the file does not exist or if Backup Plugins is checked)
  • Wrye Bash

Maintaining a clean Overwrite

Overwrite should be kept empty. This may require you to move files out of Overwrite. Every time you run the game or a tool through Mod Organizer, check Overwrite. If there are files present, right-click Overwrite and select Create Mod. Name it according to whatever tool or mod generated the file and activate it for your profile. Upon successive generations of the tool, move the files back to this mod, replacing all. This is accomplished by double-clicking Overwrite, highlighting the files to be moved, and dragging and dropping them onto their mod.

Advanced

For a discussion of more advanced topics related to Mod Organizer, please see Guide:Mod Organizer Advanced.

Adjusting Steam App ID

MO automatically fills in the Steam App ID based on the managed game:

  • Skyrim: 72850
  • Fallout NV: 22380
  • Fallout 3: 22300
  • Oblivion: 22330

If the game or Steam tool does not launch correctly, you may need to adjust the Steam App ID. This is rare. To locate the correct Steam App ID:

  1. Open Steam and go to the Library.
  2. Right-click on the game and choose Properties.
  3. On the General tab click the CREATE DESKTOP SHORTCUT button and select OK at the prompt.
  4. On the desktop, right-click the shortcut and select Properties.
  5. The URL field will say something like steam://rungameid/202480. The number is the SteamAppID (the number example here is for the Creation Kit).

Notes:

  • The Fallout 3 Game of the Year version's Steam App ID is 22370. This may fix crashing on Fallout 3 if you are using the that version.
  • Skyrim's Creation Kit's Steam App ID is 202480. If the Steam App ID is not set in the Configure Executables window with Overwrite Steam AppID checked with the value of 202480, the Creation Kit will not be able to see your mods.
  • Extensive info on Steam App IDs can be found in this thread: The Elder Scrolls Series and Fallout Series App ID's (By Uhuru).

FAQ

Q: Why is my Skyrim Data Folder [ …\Steam\SteamApps\Common\Skyrim\Data\ ] empty? Where are my Mods?

A: Mod Organizer installs each Mod into its own folder. The default location is [ …\Mod Organizer\Mods\ ] Only Bethesda Files, Skyrim, Dawnguard, Hearthfire, Dragonborn, High Resolution Texture Pack and Creation Kit are in [ …\Steam\SteamApps\Common\Skyrim\Data\ ] Mod Organizer creates a Virtual Data Folder which combines both the normal Skyrim Data Folder [ …\Steam\SteamApps\Common\Skyrim\Data\ ] with all Mods in Mod Organizer's Mods Folder [ …\Mod Organizer\Mods\ ] that are currently activated in Mod Organizer. It is the main feature of Mod Organizer and keeps your Skyrim Data Folder [ …\Steam\SteamApps\Common\Skyrim\Data\ ] pristine and untouched!

Q: I installed a mod and it's not working!

A: How do you know it's not working? The only reliable indicator is the game! The Skyrim launcher does not show mods installed through MO. The data directory does not contain new files. After installing a mod, start the game and see if the mod did what it said. If you did and the mod is really not working, please verify that the directory structure is correct. Many mods are not packaged for easy installation so you may have to shift files around (either during installation or after).

Q: How do I find out if MO is working?

A: Install a mod with a visible impact! Also, check that modorganizer.log gets created

  • Look into the modorganizer.txt that is created in your game folder. It should list all mods it loaded on startup of the game. If your mod appears there, it should work. For an alternative see 'Q: How to see MO's virtual filing system (VFS) in action'.

Q: How to see MO's virtual filing system (VFS) in action

A: Use Free Commander or any other suitable windows file manager. For details see 'Free Commander' in the Third Party Programs tab.

Q: Why does Overwrite gain .tri files in a meshes/cache folder ever time I run Skyrim?

A: These are files created by RaceMenu's CharGen extension. It is safe to delete them if you wish, as RaceMenu itself deletes these files and generates new ones every run.

Q: Which load mechanism should I use?

A: Please use the default unless you have a problem with it. If you have a Script Extender installed and do not want to use the Mod Organizer UI, you can use the Script Extender load mechanism. However, be aware that Script Extender Plugins installed through MO will not work if you do this. You will have to manually install them to the data directory. Also, whenever the game is updated, SE will stop working and with it MO. Use Proxy DLL only as a last resort. Also, keep in mind that when using proxy DLL you have to start MO at least once after every game update! Oblivion works best with the Script Extender load mechanism works. Skyrim works best with the Mod Organizer load mechanism.

Q: I'm using the proxy-dll loading mechanism and now MO/Skyrim does not work anymore.

A: I do not know how this happens, but it's easy to fix. Follow the following steps closely:

  1. First, deactivate proxy-dll loading in MO then close it.
  2. See what size the steam_api.dll in your Skyrim folder has. If it's around 116 kb, delete steam_api_orig.dll
  3. If steam_api.dll is ~11kb, you delete steam_api.dll instead. Then you rename steam_api_orig.dll to steam_api.dll
  4. In both cases you end up with a steam_api.dll that is around 116 kb and no other file called steam_api
  5. Now start MO again and re-activate proxy-dll

Q: Can I install SKSE or SKSE scripts via MO?

A: You cannot install SKSE as a mod via MO as then SKSE scripts will not load. You can install SKSE scripts as a mod in MO.

Q: Can I install ScriptDragon and its scripts via MO?

A: You cannot install ScriptDragon as a mod via MO as it is a no go at the moment. You may be able to install ScriptDragon scripts as a mod in MO if they go into the data directory or data\asi directory

Q: Can I install ENB mods or its assets via MO?

A: You cannot install ENB as a mod via MO. If an ENB has additonal assets like Shaders and Textures you can install those as a mod in MO.

Q: Can I install SweetFX Shader Suite mods or its assets via MO?

A: You cannot install SweetFX Shader Suite as a mod via MO. Unknown to me but if there are sweetFX based mods which have additonal assets like Shaders and Textures you can install those as a mod in MO.

Q: Can I install FXAA Post Process Injector or its assets via MO?

A: You cannot install FXAA Post Process Injector as a mod via MO. Unknown to me but if there are FXAA Post Process Injector based mods which have additonal assets like Shaders and Textures you can install those as a mod in MO.

Q: Can MO automatically check for mod updates?

A: MO does not automatically check for updates, as the author does not want to cause unnecessary spam to the Nexus. However, you can right-click the mod list and select Check all for update. This will check all mods for the newest version and mark those in red that have an update available.

Q: Why is the endorsement flag not set after I install a mod?

A: For technical reasons the plugins which install a mod cannot set that flag. Go to the Left Pane of MO, right click and select 'check all for updates'. This will also set the endorsement flag.

Q: I set Mod Organizer to automatically extract BSAs, and now I want to change this. How do I reset this setting?

A: Go to the Settings menu by clicking the wrench button in the toolbar. Click Reset Dialogs and click yes at the prompt.

Q: I want to uninstall MO, what do I do?

A: First, inside MO, go to Settings and select Mod Organizer for the load mechanism. Close MO and then just stop using it. You can delete the ModOrganizer directory if you're sure you need nothing from it anymore (like mod archives). Beyond that, no uninstallation is necessary. MO does not write to the registry or into any directory besides its own.
Note: The NXM association is still active, see 'Uninstalling MO and fixing NXM association in Windows' in the advanced guide on how to correct that.

Q: I want to report a bug!

A: Very good, but please provide as much information as possible. Keep in mind that I use MO constantly and unless your bug is very new, I did not encounter it yet, so you'll have to help me reproduce your situation.

  • Use the bug reporting mechanism on this site: Issues List and click on Report an Issue at top of page and select Bug report

Q: I want to ask for a new feature or enhancement, please

A: Use the feature request mechanism on this site: Issues List and click on Report an Issue at top of page and select Feature request

Q: How can I contact the Author of MO?

A: If you want to contact me, please use the Forum or send an eMail to sherb at gmx.net