CharactersVault
Server-authoritative Valheim character storage with one-character-per-player bindings.
About this mod Author’s original text
CharactersVault
CharactersVault is a lightweight mod designed to store Character Data to a Server instead of the Player's disk.
Features
- Character Data Persistence: Characters are saved to the server's CharacterVault folder inside of /config/bepinex/ instead of the player's local folder.
- Server-Side Character Management: Admins can see which players have bound characters on the server, and unbind if needed.
Installation Type
- Location: Must be installed on both the Server and the Client.
- Enforcement: Client versions must match the server version.
Manual Install
- Ensure the prerequisites listed above are installed.
- Extract the downloaded.zip archive.
- Copy CharactersVault.dll into your Valheim/BepInEx/plugins/ folder.
- Launch the game once to generate the default configuration file.
Configuration
The configuration file is automatically created at BepInEx/config/com.charactervault.valheim.cfg after running the game once.
| Section | Setting | Default | Description |
|:--- |:--- |:--- |:--- |
| Enforcement | EnforceCharacterBinding | true | If true, each account/platform ID is locked to their first registered character. |
| ClientSync | AutoSaveIntervalMinutes | 5.0 | How often (in minutes) client profiles automatically sync to the server in the background. |
| ClientSync | ProfileSyncTimeoutSeconds | 15.0 | Max seconds to wait for server profile data on join before timing out. |
| Messages | KickMessageWrongCharacter | Wrong Character | Message displayed when a player is kicked for attempting to join with the wrong character. |
| UI | ShowCharacterSelectWarning | true | Displays a warning banner on the character select screen reminding players about server-side character progression. |
| Debug | VerboseLogging | false | Enables extra diagnostic logging in the BepInEx console and log file. |
Controls & Commands
- Keybinds: None.
- Admin Commands: (Chat or Console; requires admin permissions in adminlist.txt)
- /cv list (alias /vault list): Lists all registered player platform IDs and their bound character names.
- /cv status (alias /vault status ): Views the character binding and last saved snapshot timestamp for a player.
- /cv reset (aliases /cv wipe, /cv remove, /cv unbind, /cv delete): Wipes a player's server-side progression snapshot and removes their character lock so they can start fresh.
- /cv help (alias /vault help): Displays the in-game command help overview.
Compatibility & Safe Removal
- Save Integrity: Always join a server with CharactersVault with a new character! Joining with old characters WILL wipe their inventory!
AI Disclosure
I made this mod using AI. Most of the code in this mod was AI generated. If you have an issue with this, I completely understand and urge you to not use this mod. This mod ("CharactersVault") is meant as a lightweight mod for small servers that don't need all the bells and whistles of a more complex mod.
Install & use Install: BepInEx plugin
- The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
- Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
- Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
- Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.
Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file. In multiplayer, the host and every client need the same mods installed.
Install these first, or the mod will not work: