Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
ModsmithCycle
Save, exit, relaunch, resume, and preserve recent BepInEx logs to speed up Valheim mod testing and troubleshooting.
CHANGELOG
Changelog
1.1.0
Added
- Optional rolling backups for Valheim character and world saves.
- Support for verified local and Steam Cloud save backups.
- Up to three retained backups per character and per world, with separate save identities.
- Configurable parent data folder, defaulting to
BepInEx/ModsmithCycle, with save backups in itsBackupSavessubfolder. - Configurable backup triggers: Disabled, Normal Exit Only, Modsmith Restart Only, or Both.
- Native save observation and verification to identify successfully completed character and world saves.
- Staged backup creation, verification, and transactional rotation with interrupted-operation recovery.
- Additional diagnostic logging options for save operations, backup activity, and the external restart helper.
Changed
- Backup creation is disabled by default to preserve existing behavior.
- Backup rotation retains existing recovery copies when new save data cannot be verified or committed successfully.
- Backup cleanup distinguishes completed temporary operations from active backups and recovery material.
- Backup, temporary cloud-capture, and restart-helper log files are now organized under one ModsmithCycle data folder; BepInEx
LogOutputhistory remains in its usual location. - An unavailable custom data folder falls back to
BepInEx/ModsmithCycleand records a warning. - The native Quit confirmation displays a wait notice when normal-exit backups are enabled; the notice is hidden when that backup trigger is disabled.
Notes
- World backups apply to locally hosted worlds; multiplayer guests cannot back up another player's world.
- Backups are created during eligible normal exits or Modsmith Cycle restarts, not during every in-game save.
- Backup restoration remains a manual process.
- Automatic guest reconnection to multiplayer hosts remains under development and is not enabled in this release.
1.0.0
- First full release of Modsmith Cycle's intended restart, resume, and troubleshooting workflow.
- Added optional local BepInEx session-log history for easier troubleshooting between test sessions.
- The current BepInEx
LogOutput.logis preserved during normal game exit and before Save & Restart closes Valheim. - Recent log history is retained as
LogOutput-1.txtandLogOutput-2.txt. LogOutput-PendingSession.txtis used as the temporary current-session copy before the history is advanced at the next launch.LogOutput-1.txtis the most recent previous session andLogOutput-2.txtis the older retained session.- Added
Logging.BackupSessionLog, enabled by default, to allow log backup, migration, and rotation to be disabled. - Existing Test 1 log-backup names are migrated safely to the numbered history names on the first upgraded launch.
- Log backups remain local beside the normal BepInEx
LogOutput.logand are never transmitted by Modsmith Cycle. - Updated and revalidated Modsmith Cycle for Valheim 1.0.16 and BepInExPack Valheim 5.4.2351.
- Automatic remote-server guest reconnect remains planned for a future update and is not enabled in 1.0.0.
- Standardized the ModsmithCycle plugin ID and configuration filename to
MaddCatter365.ModsmithCyclefor consistent creator branding. Users upgrading from an earlier version will receive a fresh configuration file and may delete the oldMaddCatter.ModsmithCycle.cfgafter transferring any custom settings they wish to keep.
0.1.6
- Hotfix: corrected the restart helper to read the V2 launch-request format written by the current plugin.
- Preserved every repeated
Argument=entry so the active r2modman/BepInEx launch arguments are passed back to Steam correctly. - Restored the save → shutdown → Steam relaunch → character/world resume sequence.
- The main
ModsmithCycle.dllbehavior is unchanged from 0.1.5; this hotfix replaces the mismatched helper packaged with 0.1.5.
0.1.5
- Reworked the Escape-menu restart control to use Valheim's native button styling.
- Added a matching native gold ornament above the Modsmith Cycle restart button.
- Moved restart status and cancellation messages directly below the button and stabilized their layout.
- Fixed inherited native-button behavior that could trigger the original Settings action.
- Removed temporary UI diagnostics after final placement was verified.
- Cleaned obsolete fields from the plugin-to-restarter launch contract.
- Removed the retired opening-cinematic skip functionality and stale configuration references.
- Disabled unfinished automatic remote-server reconnect behavior while preserving the framework for future co-op work.
- Preserved same-character and same-local-world automatic resume.
- Preserved locally hosted-session settings so friends can reconnect normally after the host restarts.
- Revalidated the full save, shutdown, Steam relaunch, character restore, and local-world resume cycle on Valheim 1.0.15.
0.1.4
- Updated the packaged Modsmith Cycle plugin to build 0.1.4.
- Updated the support link to https://discord.gg/ZxJ8wRtxhQ.
- Bundled the restart helper and Thunderstore package metadata for the 0.1.4 release.
0.1.3
- Reissued the cinematic-skip and same-server reconnect update under a fresh Thunderstore version after the removed listing retained version 0.1.2.
- Kept the same
ModsmithCyclepackage identity so existing installations can update normally. - Added the Mod Support Discord channel to the package documentation and metadata.
0.1.2
- Added a configurable skip for Valheim's opening cinematic, enabled by default.
- Added immediate title-menu advancement when a valid Modsmith auto-resume is pending.
- Restores hosted-server, public-listing, crossplay, and salted password-verifier settings so friends can reconnect after the world reloads.
- Added guest-client restart and automatic reconnection to the same Steam, PlayFab/crossplay, or direct-address server.
- Uses Valheim's normal password prompt for guest reconnection; readable server passwords are not stored.
- Kept ordinary title-menu access unchanged when no auto-resume request exists.
- Left engine and publisher splash screens that occur before BepInEx initialization untouched.
0.1.1
- Changed relaunching from direct
Valheim.exeexecution to Steam-applaunch 892970, matching r2modman's Windows launch route. - Rebuilds the active profile's Doorstop 3 or Doorstop 4 arguments from the currently loaded BepInEx directory.
- Added automatic
Steam.exediscovery from the running Steam process and standard installation folders. - Added an optional Steam executable override for nonstandard installations.
- Increased the post-exit delay to give Steam time to release the previous game session.
- Corrected an empty launch-argument request edge condition found by the helper smoke test.
- Verified the complete save, modded relaunch, active-profile preservation, and same-local-world resume cycle on Valheim 1.0.12.
0.1.0
- Added an Escape-menu save-and-restart button.
- Added a configurable five-second countdown and cancel action.
- Added a hidden Windows helper that waits for Valheim to exit before relaunching.
- Preserved the current r2modman profile through the existing Doorstop/BepInEx launch arguments.
- Added same-character and same-local-world automatic resume.
- Added private-session enforcement for automatic local-world resume.
- Added connected-player blocking, expiring requests, one-use tokens, and restart-loop protection.
- Added an optional Left Ctrl + F9 menu shortcut.