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 | 2 days ago |
| Version | 1.0.9 |
| Download link | Landoria-CharacterVault-1.0.9.zip |
| Downloads | 15 |
| Dependency string | Landoria-CharacterVault-1.0.9 |
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 | Validates and saves a newly created character before allowing it into the world. |
| Automatic world save | Saves every connected character with the world. |
Manual save command |
Saves the world and every connected character. |
| Log out | Sends and validates a final character save before disconnecting. |
| Quit from the menu | Saves your character before closing Valheim. |
| Server kick | Saves the affected character before the server disconnects it. |
| Graceful server stop or restart | Saves all connected characters before the final world save and shutdown. |
| Client crash or lost network | Cannot request a final save because the connection is already lost. |
When you join again, CharacterVault loads the latest trusted server copy before your character enters the world. If a character cannot join, Valheim returns to the main menu and explains why.
New characters must be created during the current game session. Depending on the server settings, an account may use one or several characters and may receive starting items on first enrollment.
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.
Server configuration and graceful restart 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.
