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.
CharacterVault
CharacterVault saves character profiles on the server to prevent item duplication.
| Date uploaded | a day ago |
| Version | 1.0.11 |
| Download link | Landoria-CharacterVault-1.0.11.zip |
| Downloads | 30 |
| Dependency string | Landoria-CharacterVault-1.0.11 |
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.2333
Landoria-ModSentry
Validates required and optional client mods before joining a Valheim server.
Preferred version: 1.0.1README
CharacterVault
CharacterVault keeps your Valheim character on the server. When you join, the server loads its trusted copy, preventing items from being imported or duplicated with another save or a restored backup.
When characters are saved
| Event | What CharacterVault does |
|---|---|
| First enrollment | Waits for Player.OnSpawned(), then validates and saves the new character. |
| Automatic world save | Saves every connected character with the world. |
Manual save command |
Saves the world and every connected character. |
| Pause-menu Save button | Saves the character through CharacterVault and retains the vanilla save behavior. |
| Log out | Sends and validates a final character save before disconnecting. |
| Quit from the menu | After entering the world, waits at most 10 seconds to save your character before closing Valheim. |
| Server kick | Saves the affected character before the server disconnects it. |
| Graceful server stop or restart (optional) | Saves all connected characters before the final world save and shutdown. Requires Linux server configuration. |
| Client crash or lost network | Cannot request a final save because the connection is already lost. |
What players should know
- The server loads its latest trusted copy before your character enters the world; local saves still work normally.
- The status below the minimap progresses from
Saving character...toSaving character......, thenCharacter savedonce the server has written the save. Failedappears when the server does not confirm the save in time.- The server keeps up to 15 automatic backups per character, including the 5 most recent saves and older daily snapshots.
- Rejected accounts are never saved and receive a clear error. New characters must be created during the current game session; character limits and starting items depend on the server.
Compatibility
| Valheim channel | Version | Status |
|---|---|---|
| Current release | 0.221.12 |
Compatible |
| Public Test | 0.221.13 |
Compatible |
CharacterVault supports local and Steam Cloud characters.
Installation
| Client | Server |
|---|---|
| Required | Required |
Install matching versions of CharacterVault and Landoria.ModSentry on the server and every client.
Graceful server stop and restart support is optional and requires configuration on the Linux server. Setup instructions are available in the full documentation.
Contact
Report bugs through GitHub Issues. For questions and feedback, use GitHub Discussions.
CHANGELOG
Changelog
1.0.11
- Add unit tests.
- Limit retained character backups and log every retention deletion.
1.0.10
- Bug fix
1.0.9
- Display the server's admission rejection reason and return rejected players to the main menu instead of leaving them on a black screen.
1.0.8
- Updated documentation
1.0.7
- Resolve the local save source by name across stable and public test enum layouts.
- Document Valheim version compatibility
- Support Valheim save API variants
- Fix CharacterVault save API compatibility
- Fix Valheim public test compatibility
1.0.6
- Update thunderstore readme
1.0.5
- Enforce CharacterVault rejection before Valheim can admit or spawn the peer.
- Require an unregistered character to have been created during the current game session.
1.0.4
- Replace ServerCharacters with an independently implemented authoritative server vault.
- Admit new characters only after ModSentry validation and the first durable profile commit.
- Save connected characters whenever Valheim starts a world save.
- Add server-authoritative starting items and command-line configuration overrides.
- Preserve the existing graceful dedicated-server shutdown trigger.
1.0.3
- Log when the mod is unloaded.
1.0.2
- Rebuild the package as an immutable artifact shared by test and production.
1.0.1
- Update the package icon.
1.0.0
- Initial version.
