Troubleshooting playbook

r2modman not opening: installer, permission, and sandbox checks

A symptom-first workflow for “double-clicking produces no window or the app exits immediately”: preserve evidence, isolate one layer, and avoid an unnecessary full reinstall.

TroubleshootingFor: Players who already installed r2modman or a modpack and need a reproducible diagnosis.Updated September 13, 2026
01

Record the failure before changing it

Write down the operating system, r2modman version, game build, active profile, and last known change. Capture the first meaningful error from the manager or loader log. Later lines often describe the consequence of the first failure, not its cause.

02

Check the highest-value evidence first

Follow this order and change only one variable between launches.

  • Start from a terminal or command prompt to preserve the first error.
  • Confirm the platform package, exact version, file size, and SHA-512.
  • Check whether security software quarantined an application file.
  • On Linux, separate execute permission, missing libraries, and Electron sandbox errors.
03

Create a five-minute minimal reproduction

Clone or create a profile containing only the community-required loader and one target mod. Confirm the game path, then use Start modded. If this works, restore packages in batches; if it fails, the cause is now bounded to the manager, path, loader, platform, or one package.

04

Avoid fixes that destroy evidence

Do not simultaneously reinstall the game, clear every cache, change Proton, delete profiles, and update all mods. Those actions can appear productive while making the original cause impossible to identify. Back up first and prefer reversible tests such as disabling a package or switching profiles.

05

Escalate with a useful report

When the path, permissions, loader, and minimal profile have been verified, collect the smallest reproducible profile, exact versions, first error, and steps. Remove usernames, tokens, and private paths before sharing. A focused report is more useful to project or mod maintainers than a screenshot of a generic exit code.

06

Verify the repair

A repair should survive two launches, a profile switch, and a vanilla comparison. Record the successful versions and what changed. If multiplayer is involved, repeat the check with one client before bringing the full group back.

Frequently asked questions

Clear answers before you change anything

Will reinstalling r2modman fix this?

Only when the application installation itself is damaged. Path, loader, profile, and mod conflicts survive or return after a blind reinstall.

Should I share the complete log?

Provide enough context around the first error and remove sensitive information. The exact version and reproduction steps matter as much as the log.

Why use a minimal profile?

It reduces dozens of interacting packages to a small set of testable layers and preserves the working profile.

Research note: September 13, 2026 snapshot. Release assets and platform behavior can change; verify important details again before installation.

Recommended path: read this guide → download or create a minimal profile → record the result → expand to the full modpack.