Confirm with your password

Keepsake

Keep your own value for any mod setting on a shared profile. Kept settings survive profile syncs and are back in place before mods load. Browse and search every mod's settings in one panel, with descriptions, defaults and what changed this session.

· MIT license

Stars
0
Downloads
14
Version
0.4.2
Updated
Author
isimp
Virus scan
✓ Scan successful
Runs on
Client-only

Compatibility

Required 1

Install these too — Gale pulls them in for you.
  • Jotunn ValheimModding ·2.30.1

Description

Keepsake

Keep your own value for any mod setting on a shared profile. When a profile sync would put the profile's value back, Keepsake puts yours in first, before any mod reads it.

The Keepsake panel

AI notice

Most of Keepsake was written by Claude Code (Anthropic), which did the heavy lifting on implementation and design. Heads-up so you can judge for yourself.

Getting started

Press Home to open the panel. Pick a mod on the left or search, select a setting and press Keep. You can change a kept value right there or in any config manager, and Keepsake follows along. Release hands the setting back to the profile.

What else it does

Changed this session lists what you just tried out in a config manager, and Keep all keeps that whole list, or all of a mod's settings, in one click.

When the profile changes a value you keep, Keepsake tells you once your character appears, and you choose whether to take the new value. A setting the profile changes all the time, such as a volume, can be made quiet.

Files a mod keeps its state in, such as Seasonality's timer for each world, can be kept whole from the Files place, so your own worlds carry on where you left them.

Good to know

Settings a server hands out while you are connected still follow the server, and your value is back when you leave. Keepsake runs on your own machine only and needs Jotunn.

If you are the one sharing the profile, what you keep goes out to everyone who follows it, because kept values are written into the mods' own config files.

Keybinds are left to Bindrune when it is installed, which keeps them the same way and shows every keybind of the game and your mods in one panel. Bindrune is on Thunderstore at https://thunderstore.io/c/valheim/p/isimp/Bindrune/ and on Hexium at https://valheim.hexium.gg/mods/isimp/Bindrune

Profile updates

Update Kept settings Kept files
Gale profile sync, or a Gale import into the same profile Yes Yes
Installing or updating a modpack, in any mod manager Yes Yes, when the game last closed normally
Thunderstore Mod Manager or r2modman, Update existing profile No No
Importing as a new profile, in any mod manager Carried over by hand Carried over by hand

Update existing profile in Thunderstore Mod Manager and r2modman replaces the whole profile folder, so what you kept is gone with it. A profile imported as new starts with nothing kept; to bring it along, copy keepsake.pins, keepsake.files, keepsake.changes and the keepsake-files folder from the old profile's BepInEx folder into the new one's.

Settings

All settings are in BepInEx/config/isimp.Keepsake.cfg, each with a description. They include the key that opens the panel, the panel's size, its sounds and the notice about profile changes.

More

Technical notes and build instructions are on GitHub at https://github.com/isimp/Keepsake

Changelog

0.4.2 Latest

Kept files now hold through modpack installs and updates in any mod manager. Mod managers give the files they extract the time stored in the zip, which made a modpack's file look older than your own, so it was taken as yours; after a game Keepsake saw close, any change is now put back, whatever time the file carries.

The README lists which ways of updating a profile keep what you kept, and how to carry it over to a profile imported as new.

0.4.1

Kept files are copied as the game closes instead of every ten seconds. At launch, a kept file that differs from its copy is judged by when it was written. Written during the last game, it is yours and its copy is updated. Written after the game closed, a profile sync replaced it and your copy goes back. Before, an outdated copy could be put back over a newer file after a crash, after a game in which Keepsake did not load, or when Keepsake was turned back on after a while.

When Keepsake cannot tell, after a game it did not see close, the file is left as it is and waits in Files for you to put your copy back or keep the file as it is. Both versions are shown one over the other to compare: texts in viewers with the line where they first differ, images as thumbnails.

Lists count numbers in names as numbers, so 2 comes before 10, for files as well as mods, sections and settings.

0.4.0

Files and folders in BepInEx/config can be kept whole, from the new Files place in the panel. Keepsake saves a copy while the game runs and puts it back at launch when a profile sync replaced or removed the file, so a mod that keeps state in files, such as Seasonality's timer for each world, carries on where you left it. The Files list leaves out images unless asked, and shows a text file whole in a viewer of its own, or the image itself.

Keep all over a mod's settings keeps every one of them at once, and Release all releases them again.

3 older entries, full version history & downloads →

Manual download
Just this mod One .zip — Keepsake 0.4.2
Files you'll get 2
  • Keepsake 0.4.2 isimp this mod Get
  • Jotunn 2.30.1 ValheimModding Get

Your browser may ask permission to download several files at once. How to install these manually

Manual installation instructions
1

Install BepInExPack Valheim

BepInExPack Valheim is required to run mods in Valheim.

Download BepInExPack Valheim 5.4.2351 · View mod page

Check out the mod page for detailed installation instructions.

2

Install Keepsake

This mod only needs to be installed on the client.

Download Keepsake 0.4.2

Extract the ZIP and place the file(s) into the BepInEx/plugins/ folder inside your Valheim game folder.