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.
CharactersVault
Server-authoritative Valheim character storage with one-character-per-player bindings.
| Last updated | 2 weeks ago |
| Total downloads | 470 |
| Total rating | 3 |
| Categories | Mods Server-side Client-side Utility AI Generated |
| Dependency string | BigAI-CharactersVault-2.6.1 |
| Dependants | 0 other packages depend on this package |
This mod requires the following mods to function
denikson-BepInExPack_Valheim
BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.
Preferred version: 5.4.2333README
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
CharacterVaultfolder 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
.ziparchive. - Copy
CharactersVault.dllinto yourValheim/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 <playerId>(alias/vault status <playerId>): Views the character binding and last saved snapshot timestamp for a player./cv reset <playerId>(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.
