Guide:Mod Organizer/Instances vs Profiles

From Step Mods | Change The Game

First, a few terms to aid with conceptualization of the distinction between instances and profiles:

  • VFS - The "Virtual File System" that MO creates each time it is used to launch a game. Virtualization creates a simulated (aka virtual) game directory location as opposed to a physical one. This prevents the occurrence and accumulation of 'mistakes' in the actual game directory location, which itself remains 'clean'.
  • Mod Priority - (aka, install order) The order of mods in the MO left pane, which corresponds to the order each is loaded into the VFS. This determines how mod assets (i.e., folders and files) are 'overridden' and the resulting asset-conflict 'winners'. It's the same result as physically installing two mods with asset conflicts into a directory location: The second mod installed will physically 'overwrite' the conflicting assets of the first mod installed.
  • Plugin Priority - (aka, load order or 'LO') The order that plugins are loaded by the game. This determines how mod data (i.e., plugin records) are overridden and the resulting data-conflict 'winners'.
  • Mod Build - An coordinated assemblage of mods and plugins resulting in a specific outcome and governed by a synergy of asset patches, plugin patches and inter-compatible mod configurations.
  • Mod List - A complete listing of mods (and possibly their prioritization) within a given mod build. This is sometimes conceptualized as a plugin list or referenced interchangeably with a plugin list, but mod priority and plugin priority are completely independent, and each is 'unaware' of the other.
  • Game Guide - The instructions to recreate or reproduce a given mod build.

Recall that it is recommended to configure MO in "instanced mode" on first launch to allow game-specific mod management of multiple different games using a single MO installation.

By extension, instanced mode also allows multiple, independent mod builds under a single game. Upgrading a mod build is a good use case for mod-build instances. This is because instanced mod lists and individual mod configurations are independent among mod-build instances under the same game just as they are among mod-build instances under different games.

To achieve complete separation of mod builds, MO can alternatively be installed in "portable mode", whereby one can have multiple MO installations associated with a particular game and/or mod build. The outcome is identical to that of MO instances (independence of all aspects of a build); however, portable mode has unnecessary redundancy and maintenance headaches. Each MO portable installation must be updated whenever a new MO release becomes available, and small differences in each independent MO installation can accumulate, resulting in inconsistency. Portable mode may still be valid for certain edge cases, like when running MO on Linux or when there is need for actual 'portability' between two different PCs. Nevertheless, instanced mode is a much more practical and efficient way to utilize MO on a Windows OS.

Instances

Instances in Mod Organizer allow configuration of ALL aspects of a build independent of other instances and easily switching between them. This essentially means that instances can accomplish everything profiles do and much more more, largely obviating the usefulness of profiles when MO is configured in instanced mode at first launch. The following are some things to consider about instances:

  1. When first created, an instance consumes < 200 Kb of disk space under %LOCALAPPDATA%, which is on the OS drive by default (usually the C:\ drive).
  2. Since the instance will typically include downloads and mods at some point, the disk space requirements will dramatically increase. As a basis for comparison, the Step SkyrimSE 2.2.0 build with all downloads and mods consumes about 250 Gb of disk space.
  3. Excluding/removing assets in the ..\downloads folder reduces the instance size by a little more than half (required disk space reduced to about 90 Gb for Step SkyrimSE 2.2.0).
  4. Instances cannot be 'cloned' via the GUI, so duplicating an instance requires manual copy/paste from one instance into another via Explorer or analogous methods.
  5. Since new instances are completely distinct from others, customizations like themes and separators will not be configured in the new instance. This is easily resolved by copying specific files/folders from the source instance into the new one.

Creating an Instance

To create a new instance, begin by clicking on the MOInstanceManager.png button at top left of MO. Refer to the following images to create and clone an instance. Once the new instance is created and optionally cloned, launch MO and change instances using the MOInstanceManager.png button at top left of MO.

To replicate all customizations (e.g., MO theme [Settings] and configured separators) from a source instance, CLOSE MO, and copy ModOrganizer.ini from the source instance into the new one. To replicate an entire instance, copy the other folders indicated below in addition to the INI. Then restart MO.

Profiles

Profiles in Mod Organizer allow configuring all except mod-list and mod-configuration aspects of a build independent from each other and quickly switch between them. They are most useful when working with a particular build having two or more different mods and plugins enabled and prioritized independently. The most notable use case is mod testing and troubleshooting where convenience is a priority.

Every aspect of the build other than the mod list and mod configurations are independently configurable among profiles, so each profile can have distinct control over the following without affecting other profiles:

  • 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 chapter.
  • 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

NOTE

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 lists and mod configurations are NOT independently configurable among profiles, so all profiles share control of the mod list and individual mod configurations as follows:

  • 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 a Profile

To create a new profile:

  1. Click the Profiles MO.png button. (or click [<Manage...>] from the drop-down list at top left of the left pane.)
  2. Click [Create], or select an existing profile and click [Copy].
  3. Type a name.
    To revert to default ini game settings, tick the Default Game INI Settings box
  4. Click [OK]
  5. Click [Close]

Mouse-hover over any of the other settings in the Profiles configuration window for a description of each. In most situations, ticking both Use profile-specific ... options is desirable.

Info-Logo.png
NOTE:
Only enable Automatic Archive Invalidation if running any game other than Skyrim. If running Skyrim, clicking the Back-date BSAs button in Settings > Workarounds is all that is necessary.

The new profile can be selected from the drop-down list at top left of the left pane.