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

1. Ensure the prerequisites listed above are installed.
2. Extract the downloaded .zip archive.
3. Copy CharactersVault.dll into your Valheim/BepInEx/plugins/ folder.
4. 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.

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.

v2.6.0

• Unified Player Reset Action: Streamlined unbinding and progression wipes into a single Reset Player action (/cv reset [playerId]) that safely wipes server-side progression, deletes old snapshots, and removes the character lock.
• Smoother Syncing & Performance: Fast actions (like sorting items in chests or rapid skilling) are now bundled intelligently, greatly reducing network lag and server load without risking any lost progress.
• Admin Commands Prefix: Updated admin commands to /cv (with /vault alias).

Bug Fixes

• Chat Formatting Fix: Fixed an issue where raw color tags were displayed in chat when running admin commands.
• Character Reset & Unbind Fix: Fixed an issue where unbinding a character would allow old inventory, skills, and appearance to carry over when the player rejoined with a new character.

v2.4.0

• Character Selection Warning: Added a reminder banner on the Character Selection screen to prevent accidental loss of existing character progression (can be toggled in config).
• Clear Disconnect Messages: If a connection fails or is rejected (such as a mod version mismatch), the exact reason is now displayed directly on the disconnect screen.

v2.3.4

• Resolved Thunderstore packaging and automated scanner compatibility issues.
• Excluded bundled Newtonsoft.Json.dll dependency from package output.
• General packaging and internal cleanup.

v2.3.1

• Platform ID Support: Added support for platform IDs (Steam_... and Xbox_...) for player bindings and snapshot files.
• Sync Reliability: Added transfer size limits, chunk validation, and timeout handling for safer profile syncs.
• Data Safety: Atomic file saves for bindings and snapshots to prevent corruption if the server crashes.
• Cleanup: Removed obsolete config options, unused mismatch reports, and legacy code.