Common Errors and Troubleshooting - trumank/mint GitHub Wiki

Failure While Updating Cache (403, 404)

You may see the following message

ERROR mint::gui::message: modio::Error {
    kind: Status(
        403,
    ),
    source: Error {
        code: 403,
        error_ref: 15024,
        message: "The mod ID you have included in your request could not be found.",
        errors: None,
    },
}

when trying to update your cache. One of your mod.io mods may be renamed or deleted by its author. This is currently a bug in Mint that the cache update might get stuck on 403/404 if there is a mod which got renamed, deleted or hidden. The workaround is to:

  • Remove the renamed/deleted mod.io mod.
  • Remove the cache directory: delete C:\Users\<username>\AppData\Local\mint\cache.
    • Or C:\Users\<username>\AppData\Local\drg-mod-integration\cache (as the legacy cache directory).
  • Press Install Mods again.

Before this cache update bug is fixed, https://github.com/jieyouxu/modio-modcheck is a temporary utility to check your mods list (you can copy/paste mod URLs into it) for any renamed, hidden or removed mod.io mods.

Config failed to deserialize or you want to fully wipe mint install

If mint fails to launch the GUI and says the config cannot be deserialized, you may have to backup your config files and do a wipe of mint's config and data directory.

  • v0.2.10 or before:
    • %AppData%\Roaming\drg-mod-integration\config
    • %AppData%\Local\drg-mod-integration\cache
    • %AppData%\Roaming\drg-mod-integration\data
  • Mint newer than v0.2.10:
    • %AppData%\Roaming\mint\config
    • %AppData%\Local\mint\cache
    • %AppData%\Roaming\mint\data
  • <drg_install_directory>\FSD\Binaries\Win64\x3daudio1_7.dll is the hook that you'll need to remove if you can't click Uninstall Mods for whatever reason

Mod Compatibility Issues

Some mods may work under official mod integration but not in mint. This can be because:

  • Official mod integration does not load all the files in a mod, but Mint does. Additionally loaded files may cause issues in game.
    • May require the mod to be updated to remove extra files.
  • The mod interacts with AssetRegister.bin. The official mod integration partially handles AssetRegister.bin merging, but Mint currently does not implement it.

Mint also does not and cannot check mod compatibility with game updates. Mods that worked fine in previous versions of the game can crash in newer game versions.

Install mods failed with "An existing connection was forcibly closed by the remote host" (OS error 10054)

This can be due to strange mod.io rate limit or network issues. Try waiting for a few minutes and then try installing mods again.

ureq error: discord attachment/oo2core_9_win64.dll: status code 403

Please see https://github.com/trumank/mint/issues/134.

⚠️ **GitHub.com Fallback** ⚠️