Skip to content

Mod Organizer 2

Eamonn Rea edited this page Sep 22, 2022 · 22 revisions
Clone this wiki locally

Mod-Organizer 2

(GitHub Project Page) (Nexus Mods Page)

Mod Organizer 2 (MO2) is a graphical mod manager application that allows for modding a wide variety of games, commonly with mods found on Nexus Mods. It is the predecessor to Vortex Mod Manager, though MO2 is still actively developed by the open source community and is still a popular choice among the modding community.

SteamTinkerLaunch offers automated installation and configuration of ModOrganizer 2, it does the installation and configuration for you. Please note however that ModOrganizer 2 only supports modding Windows releases of games. Even though some supported games may have a native Linux port and some mods may support the native port, you will not be able to mod them with ModOrganizer 2.

SteamTinkerLaunch also has built-in support for Vortex Mod Manager if you would like to use that. You can install and use both mod managers to mod different games, though you may run into issues if you try to mod the same game at the same time with two different mod managers.

Refer to the ModOrganizer 2 documentation for general guidance on how to get started.

Features

ModOrganizer 2 is only officially available for Windows (though the developers do try to improve compatibility with Linux), but SteamTinkerLaunch tries to close this gap through seamless integration with Wine/Proton and automating a lot of the configuration required to get ModOrganizer 2 running on Linux. All processes are fully automated and should not require user intervention!

Below is an overview of some of the features SteamTinkerLaunch offers when installing ModOrganizer 2:

  • Automatically downloads and installs the latest release of ModOrganizer 2 from GitHub.
  • Installs ModOrganizer 2 into a separate, isolated Wineprefix/Compatdata directory, keeping its files separate from your game installation.
  • Commands to list all supported ModOrganizer 2 games and all currently installed games that support ModOrganizer 2.
  • Once your initial instance is configured, MO2 can identify all other supported games currently installed from Steam. All you have to do is switch your instance each time your want to use it.
    • SteamTinkerLaunch automatically generates its own libraryfolders.vdf pointing to all real Steam Library Paths for all currently installed games supported by ModOrganizer 2.
    • SteamTInkerLaunch also creates relevant registry entries pointing to game folders if requires (most Bethesda games require this).
  • Creation and automatic updating of game configuration symlinks pointing to all supported installed games within the SteamUser directory.
  • Support for handling NXM links to download mods from Nexus Mods with the "Mod Manager" button, if your Nexus account has been linked with ModOrganizer 2. You will need to have launched your game from Gmae Mode to do this (see below).
  • Support for launching ModOrganizer 2 from the Main Menu or from the command line, called "Standalone Mode", or when you press the "Play" button, called "Game Mode" (See Usage section).

There may be some hiccups from time to time, so if anything does not work correctly feel free to open an issue.

Installation

ModOrganizer 2 can be installed either from the command line or from the SteamTinkerLaunch Main Menu.

Command Line

To install from the command line, you can install SteamTinkerLaunch with steamtinkerlaunch mo2 start. This will download, install and start ModOrganizer 2.

If you only want to download the ModOrganizer 2 executable, you can run steamtinkerlaunch mo2 download. If you want to download and install ModOrganizer 2 but you don't want it to run, you can run steamtinkerlaunch mo2 install.

Main Menu

You can install ModOrganizer 2 from the Main Menu by pressing the "ModOrganizer 2" button. This will download, install and start ModOrganizer 2.

Usage

You can start ModOrganizer 2 either in Standalone Mode or Game Mode.

Standalone Mode is good for generic mod configuration and setup, as it can be used without closing SteamTinkerLaunch, whereas Game Mode is good for launching your game from ModOrganizer 2.

Game Mode

In Game Mode, ModOrganizer 2 is started inside the game Wineprefix/Compatdata using the same Proton Version that your game uses. To use Game Mode, ModOrganizer 2 is started by launching your game with SteamTinkerLaunch. You will be prompted after starting your game to use ModOrganizer to in MO2 GUI mode.

You can start ModOrganizer 2 through Game Mode by either enabling ModOrganizer 2 in the Game Menu, or using a Steam Collection. Note that ModOrganizer 2 options will not be available unless you have installed it.

To use ModOrganizer 2 with Steam Collections, create a "MO2" Collection and add the games you want to use ModOrganizer 2 with to that Collection. This will automatically enable MO2 in GUI mode for all games in that category.

It should be fine to install and configure mods from Game Mode, but only for the game you are trying to launch. It is not adviseable to switch instances and mod other games when running ModOrganizer 2 from Game Mode.

(Note: There is also a currently not implemented MO2 SKIP Silent Mode, which aims to eventually start your game with your mods via MO2 without showing the MO2 GUI.)

Standalone Mode

In Standalone Mode, ModOrganizer 2 is launched in its own Wineprefix/Compatdata, which can optionally use its own Proton version. I can be used to configure mods for multiple games. However, it is not meant to be used to launch games. If you wish to run your games, you should use [Game Mode](#Game Mode).

To use Standalone Mode, you can launch ModOrganizer 2 via the Command Line with steamtinkerlaunch mo2 start. You can also use the "ModOrganizer 2" Extra Button on the Main Menu, or use the Tray Icon.

No matter which mode is used, all ModOrganizer 2 data (configs, downloads and so on) are stored in the MO2 Compatdata and are just symlinked into the Steam game's Compatdata when using [Game Mode](#Game Mode).

Command line options

There are several more Command Line options for ModOrganizer 2 besides those mentioned above. Run steamtinkerlaunch help and look under the MO2 section for a list of available commands.

Configuration

Overview

Mod-Organizer 2 Options

Although SteamTinkerLaunch automatically configures much of ModOrganizer 2 for you, there are several configuration options available in the Cateogry Menu) to give you extra flexibility. Some of the configuration options include:

  • Changing the default Standalone Mode Compatdata path (the default is typically ~/.config/steamtinkerlaunch/mo2/compatdata/).
  • The Proton Version for the standalone mode can be configured (the default is typically the same version Game Mode uses).
    • ModOrganizer 2 is mostly compatible with Wine's Mono implementation, but some versions of Proton use custom Wine themes that may cause graphical glitches. To fix this, you can use Winecfg to disable custom themes, or change the theme that ModOrganizer 2 uses (several very cool ones are built-in at the time of writing).
  • You can enable/disable ModOrganizer per-game, allowing you to disable it with games you no longer wish to use it with. You can set MO2 to either "disabled" or "gui". This can also be useful for troubleshooting games to ensure they work without ModOrganizer 2.
  • The timeout (in seconds) of the requester dialog asking how to start ModOrganizer (see MO2 Requester).

MO2 Requester

image

The timeout value (WAITMO2) for the ModOrganizer 2 wait requester dialog is 2. If the configured value is greather than 0 and MO2MODE is not disabled, a requester dialog will open when you start your game. The default action is to start ModOrganizer 2 in gui mode, which you can select by either pressing spacebar or letting the requester time out.

(Note: There is a not-yet-implemented MO2 SILENT option, which when added aims to allow you to start your game with mods enabled without showing ModOrganizer 2).

Files

As there is no (?) official way to list all games supported by ModOrganizer 2 with each name and SteamAppID SteamTinkerLaunch ships and utilizes an own hardcoded list of supported games in an attempt to improve further automation. SteamTinkerLaunch can list the name, SteamAppID and the Nexus Mods gamename (used to categorize the Nexus Mods downloads) for each supported game.

The hardcoded list of supported games can be found in the global misc directory of your SteamTinkerLaunch installation. Common locations include:

  • Package Manager: /usr/share/steamtinkerlaunch/misc/mo2games.txt.
  • Steam Deck/ProtonUp-Qt: ~/stl/prefix/misc/mo2games.txt.
  • Flatpak: ~/.var/lib/steamtinkerlaunch/misc/mo2games.txt.

This list will need to be updated when MO2 adds support for new games, or when a SteamAppID is missing in the list. Some games have different ids in different countries.

Feel free to either open an issue about a missing/incorrect game, or submit a pull request to fix it yourself. Contributions are always welcome!

Troubleshooting

You may encounter some issues when using ModOrganizer 2. Below are some common issues and steps to resolve them. If you issue is not listed, feel free to request its addition in an issue.

If you encounter an issue with modding a specific game or using a specific mod, check the Modding wiki to see if there is a documented fix or workaround. If not, and you are able to fix the game yourself, please open an issue describing the fix in as much detail as possible, so that we can add it to the wiki and help other users!

MO2 Won't Start

For troubleshooting/reporting a bug you might want to do the following clean test:

  1. Move/Rename your SteamTinkerLaunch configuration directory (typically ~/.config/steamtinkerlaunch). Doing this "hides" all your SteamTinkerLaunch configuration files from SteamTinkerLaunch, so it will set itself up again like a fresh install. Doing this is better than deleting the folder because it means you can recover all your configuration information later!
  2. Delete /dev/shm/steamtinkerlaunch to remove any lingering files from previous launches
  3. Reinstall ModOrganizer 2 with the following command: steamtinkerlaunch mo2 start
  4. Many things happen under the hood, so be patient and wait for installation to finish up. The more modable games that you have installed, the longer it can take. Watch the status windows for updates. You might also want to read the SteamTinkerLaunch wiki or ModOrganizer 2 documentation in the meantime.
  5. ModOrganizer 2 should eventually start.

If ModOrganizer 2 still does not launch after this, feel free to open an issue and make sure to include your steamtinkerlaunch.log file. The relevant log for the last launch can be found in /dev/shm/steamtinkerlaunch. Make sure to try and launch ModOrganizer 2 before attaching the log, so we can see the log from your attempted launch.

"Mod Manager" button on Nexus Mods isn't working

The most prominant issue you might run into is that using the "Mod Manager" button on Nexus Mods may not work. This seems to only happen if you are running ModOrganizer 2 in Standalone Mode. Try running in Game Mode and then try again.

If you still run into issues, check ~/.local/share/applications and see if you have a file called ModOrganizer-steamtinkerlaunch-dl.desktop. If you don't have this file, copy the template below and replace <stl_config_dir_path> with the path to your SteamTinkerLaunch configuration folder (typically this is ~/.config/steamtinkerlaunch but may be different on Flatpak).

[Desktop Entry]
Type=Application
Categories=Game;
Name=ModOrganizer (SteamTinkerLaunch - steamtinkerlaunch)
MimeType=x-scheme-handler/nxm;x-scheme-handler/nxm-protocol
Terminal=false
X-KeepTerminal=false
Path=<stl_config_dir_path>/mo2/compatdata/pfx/drive_c/Modding/MO2
Exec=/usr/bin/steamtinkerlaunch mo2 u %u
NoDisplay=true

Once you have filled out the path, save the file to ~/.local/share/applications/ and name it ModOrganizer-steamtinkerlaunch-dl.desktop. After this, close SteamTinkerLaunch and remove the /dev/shm/steamtinkerlaunch/ folder.

If this still does not resolve the problem, feel free to open an issue.

MO2 Won't Let Me Select Native Games

Unfortunately, ModOrganizer 2 does not support modding native Linux games. When selecting the path to the game for your instance it will tell you that it can't find the game executable, or something to this effect. Even if your game has a native Linux port you will unfortunately have to use the Proton version of this game.

Notes

Disclaimer

As noted earlier, ModOrganizer 2 is not officially supported on Linux. You may encounter issues, but SteamTinkerLaunch does its best to bridge the gap. You may not get very much support when asking about issues from the ModOrganizer team, as they will likely focus their efforts on Windows. Having said that, the team have previously helped fix critical compatibility issues to help Linux users.

SteamTinkerLaunch offers ModOrganizer 2 support to help make it easier to install and mod games, but it does not guarantee full mod compatibility with Wine. It it probably quite rare as many users have been modding games on Linux for a long time, but you might run into cases where some mods may be incompatible with running games through Wine. You can research your mods on your own and politely ask mod creators to investigate/improve support with Wine, but you may not get the answer you are hoping for.

If you do encounter an issue with a mod and you are able to fix it, please tell us about it in an issue so we can document it on the Modding wiki page.

As with other programs, you are using ModOrganizer 2 to mod your games at your own risk. You may get banned from multiplayer games for using some mods, please mod responsibly!

DotNet and Mono

Previously, SteamTinkerLaunch would've attempted to install DotNet 4.8 for use with ModOrganizer 2. It was found that Wine's own implementation of DotNet (called "Mono") should allow ModOrganizer 2 to function correctly, apart from some minor cosmetical issues. There may be a lot of warnings in the ModOrganizer 2 logging box at the bottom of the screen but these can typically be safely ignored. If you experience any functionality issues that you know are fixed by using DotNet 4.8, please open an issue and describe this in detail.