Skip to content

Latest commit

 

History

History
122 lines (77 loc) · 7.46 KB

HELP.md

File metadata and controls

122 lines (77 loc) · 7.46 KB
Raw

Help

This file contains common questions for the manager.

Table of Contents

How do I use this?

  • Download the Outer Wilds Mod Manager installer from the latest release;
  • Run the downloaded .msi (you might need to ignore some Chrome / Windows warnings);
  • Shortcuts are added to the desktop and start menu, use them to run the manager;
  • Run the manager;
  • Install OWML;
  • Head to the "Get Mods" tab to install any mods you want;
  • Press the top right play button to launch the game;
  • You won't believe what happens next.

The manager has encountered a fatal error, the system cannot find the file specified (Windows)

If you're getting an error message like this:

The manager encountered a fatal error when starting: Runtime(CreateWebview(WebView2Error(WindowsError(Error { code: 0x80070002, message: The system cannot find the file specified. }))))

This is a result of not having the Microsoft Edge WebView2 Runtime installed. If you've used a "Window debloat" script, it's likely that this was removed, even though it's a critical component of Windows. To try and reinstall it, you can use the link above and download the evergreen bootstrapper.

The manager's installer is supposed to install Webview2 for you, but depending on how your debloating script works, it may have left rouge registry keys that make the manager think it's already installed. If you're still having issues, try inspecting the registry keys mentioned in this Webview2 article to see if they're pointing to bad folders.

How do I use this on Linux?

Using the manager on Linux should be easy proton and wine are not required. The manager requires Mono 6 to be installed and available on the PATH. If you're using the Flatpak, AUR, or Nix versions, Mono will be installed and set up automatically.

Mod folder not found on Flatpak version of Steam

This is an issue with sharing the manager's folder with Steam, as OWML will be running from within Steam's flatpak container it won't be able to access the mods folder. See this issue for details. tl;dr:

  1. Move the OWML folder from ~/.local/share/OuterWildsModManager/OWML to ~/.var/app/com.valvesoftware.Steam/.local/share/OuterWildsModManager/OWML, this will make it available to the Steam container
  2. Change your OWML path in the manager settings to ~/.var/app/com.valvesoftware.Steam/.local/share/OuterWildsModManager/OWML to point to the new OWML location
  3. Reverify your game files in Steam, this is to remove any possibly bad versions of OWML that still point to the old path
  4. Try to launch the game again through the manager

What About Steam Deck?

The manager can be installed on Steam Deck in Desktop Mode in the Discover app.

The mod manager requires that the game is installed in ~/.steam/steam/steamapps/common/Outer Wilds or ~/Games/Heroic/OuterWilds.

When selecting game path DO NOT use the browse button, on Flatpak this tries to open a portal which won't work, you'll need to enter the path manually or copy it.

Note that you won't be able to launch the game from the manager when in steam deck's game mode. But so long as you've pressed "Launch Game" at least once, you can launch the game directly and it will still be modded.

You'll also need to change your controller layout to the "Mouse Only" template.

How do I uninstall it?

You can uninstall the Mod Manager by searching for "Add or remove programs" in the start menu (or in the control panel) and then finding "Outer Wilds Mod Manager" in the list. However, this won't uninstall your mods.

To revert the game to its original state, verify the game files' integrity:

  • Steam: Library > Right-click Outer Wilds > Properties > Local Files > Verify integrity of game files.
  • Epic: Library > Click three dots under Outer Wilds > Verify.

How do I update it?

The manager will automatically check for updates when you launch it. If an update is available, you will be prompted to download it. On the Flatpak, AUR, and Nix versions, your system's package manager will handle updates.

The game won't launch on Linux

Please ensure you have Mono installed and available on your PATH.

To debug issues with mono set the MONO_LOG_LEVEL variable to debug. and look at the logs.

On steam deck, keep in mind the game won't launch if you click Launch Game from the manager while in game mode. You need to launch the game directly from the steam deck's game mode.

On Flatpak

Also, ensure the game is located in ~/.steam/steam/steamapps/common/Outer Wilds, otherwise the manager won't be able to find the game as it only has access to that folder.

I made a mod! How do I submit it?

The mod database is stored in a separate repository. Go here to find out how to add your mod to the list.

I have a question about modding

Please refer to the OWML documentation for information about creating mods.

I want to contribute to the manager

Depending on which package you want to contribute to, please refer to the following:

You can also take a look at The Architecture Doc for more info above the manager's behavior.

My issue isn't listed here

If you're encountering issues or have questions, please open an Issue. You can also view closed issues to see if your issue has already been resolved.

We also have a Discord server available if you want to chat.

You can also email [email protected] if your issue is sensitive / security related.