ModsmithCycle

Modsmith Cycle

Modsmith Cycle provides a faster restart and troubleshooting cycle for modded Valheim on Windows.

Open the Escape menu and choose SAVE & RESTART MODDED to save your game, close Valheim cleanly, relaunch through Steam with your active r2modman/BepInEx profile, and automatically return to the same character and local world.

Modsmith Cycle can also preserve the current BepInEx session log during shutdown. Recent logs are retained locally as LogOutput-1.txt and LogOutput-2.txt, with LogOutput-PendingSession.txt used during rotation. This makes it easier to compare recent sessions while testing and troubleshooting mods.

What it does

Modsmith Cycle will:

• give you a short countdown with time to cancel;
• use Valheim's normal save-and-quit path;
• wait until Valheim has fully exited;
• ask Steam to relaunch Valheim through the same -applaunch 892970 route used by r2modman;
• preserve the active profile's Doorstop/BepInEx launch arguments;
• select the same character after relaunch;
• reopen the same local world automatically;
• restore the world's hosted-session settings when applicable so friends can reconnect normally.
• preserve recent BepInEx session logs locally to make troubleshooting between test sessions easier.

The active mod profile is preserved through its launch arguments. Modsmith Cycle does not automate or click through the r2modman interface.

Version 1.0.0 continues to use Steam for the relaunch because launching Valheim.exe directly can result in an unmodded session.

In-game restart interface

Modsmith Cycle adds a native-style section to Valheim's Escape menu:

[ gold Valheim ornament ]

SAVE & RESTART MODDED

During the restart countdown, the button changes to:

CANCEL RESTART (N)

A notice below the button confirms whether the restart is queued or cancelled.

The restart can also be triggered with the configured keyboard shortcut while the Escape menu is open.

Default shortcut:

Left Ctrl + F9

Local hosting behavior

• Local world: Modsmith Cycle reopens the same world with the same character.
• Locally hosted multiplayer world: hosted-session settings can be restored so friends can reconnect normally after the world returns.
• By default, a restart is blocked while another player remains connected.
• If friends are playing in your locally hosted world, have them return to the main menu before restarting.
• Each auto-resume uses a unique one-use token.
• Resume requests expire after a configurable amount of time.
• A detached helper waits for Valheim to fully exit before starting the replacement process.
• If character or world resolution fails, Modsmith Cycle stops safely at Valheim's menus.

Remote servers

Automatic guest reconnect to a remote server is not currently available in 1.0.0 and is planned for a future update.

The configuration entry remains reserved for future hosted co-op / remote reconnect work, but currently returns the player to Valheim's menus instead of attempting an automatic remote reconnect.

Dedicated-server restart support is not part of Modsmith Cycle's scope.

Requirements

• Windows 10 or 11
• Valheim 1.0.16
• BepInExPack Valheim 5.4.2351
• An active local-world or locally hosted Valheim session for automatic world resume

The small restart helper targets.NET Framework 4.8.

Installation

Keep both files together in the same plugin folder:

BepInEx/plugins/ModsmithCycle/ModsmithCycle.dll

BepInEx/plugins/ModsmithCycle/ModsmithCycle.Restarter.exe

Start Valheim with Start modded in r2modman.

Enter a world, press Escape, and choose SAVE & RESTART MODDED.

You can also use Left Ctrl + F9 while the Escape menu is open.

Configuration

Settings are written to:

BepInEx/config/MaddCatter365.ModsmithCycle.cfg

Current settings include:

• Restart.CountdownSeconds — length of the cancel countdown.
• Restart.AutoResumeLocalWorld — when enabled, automatically reopens the previous local world.
• Restart.ResumeHostedSession — restores locally hosted-session settings so friend