Step-by-step guide

How to update r2modman and a modpack safely

Separate manager, loader, dependency, and mod updates so every change has evidence and a rollback path.

GuideFor: New r2modman users and players who want repeatable, recoverable mod setups.Updated September 13, 2026
01

Identify what is actually being updated

The r2modman application, the game, the loader, shared dependency packages, and feature mods are independent layers. “Update r2modman” should not silently become “update everything.” Record the current versions and change one layer at a time so a regression has a bounded cause.

02

Create a recovery point

Export the stable profile as a code and .r2z, copy irreplaceable configuration and saves, and keep the exact old installer when compatibility matters. Clone Stable to Lab and perform the update there first. A cache may speed up downloads, but it is not a backup.

03

Use the safest update order

Update the manager and confirm it opens. In Lab, update the required loader and launch. Then update shared dependencies in a small batch, launch again, and finally update feature mods. This sequence reveals whether the break occurred in the application, runtime, API layer, or mod behavior.

04

Roll back the smallest change

If a regression appears, undo the most recent package or return to Stable. Do not simultaneously reinstall the game, clear every cache, change Proton, and delete profiles; that removes the evidence needed to find the cause.

05

Know when not to update

After a major game release, community loaders and mods may need time to catch up. If the current profile remains playable and no security or compatibility fix requires immediate action, waiting for documented compatibility can be safer than updating a multiplayer setup on day one.

Frequently asked questions

Clear answers before you change anything

Will updating r2modman delete profiles?

A normal app update should preserve them, but an export is still the correct precaution before any important change.

Can I update one mod at a time?

Yes. Small batches are strongly preferable when stability and diagnosis matter.

Where are older r2modman builds?

The download center indexes all public releases and links their original assets.

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.