A server-side only mod for Valheim that stores player characters on the server, preventing item loss from network desync issues and providing centralized character management.

• Server-Side Character Storage: Characters are saved on the server, not client-side
• No Client Mod Required: Players don't need to install anything
• One-Time Migration: Existing players can migrate their characters once, controlled by admin
• Automatic Backups: Configurable number of backups before each save
• Easy Restore: Console commands to restore characters from backups
• Admin Controls: Full suite of management commands
• Auto-Update: Automatically checks for and downloads updates from GitHub

1. Install BepInEx on your server
2. Copy FractureCharacters.dll to BepInEx/plugins/
3. Start the server to generate the config file
4. Configure settings in BepInEx/config/com.fracture.characters.cfg

When a player connects for the first time:

1. If AllowNewMigrations is enabled and they haven't migrated before, their client character is saved server-side
2. The player's Steam ID is recorded in migrated_players.txt
3. Future logins use the server-side character

This is a one-time migration per player. Once migrated, they always use the server character.

Before every save:

1. The current character file is backed up to backups/{steamid}_{charname}/
2. Backups are timestamped and rotated (oldest deleted when exceeding BackupCount)
3. When restoring, a .pre_restore backup is created first

All commands require admin privileges and are prefixed with fc_:

fc_list
fc_backups Steam_12345678 Viking
fc_restore Steam_12345678 Viking 0
fc_migration off

1. Initial Setup:

   • Install mod with AllowNewMigrations = true
   • Notify players their characters will be migrated on first login

2. After Migration Period:

   • Set AllowNewMigrations = false via console: fc_migration off
   • New players will start fresh on the server

3. If Corruption Occurs:

   • Check available backups: fc_backups <steamid> <name>
   • Restore from backup: fc_restore <steamid> <name> 0
   • A pre-restore backup is automatically created

Client-side character storage can lead to:

• Item duplication exploits
• Item loss from network desync during death
• Character rollback from client crashes
• Cheating via save file editing

Server-side storage eliminates these issues by making the server the authoritative source.

• Valheim: 0.221.10+
• BepInEx: 5.4.2202+
• Server Only: Clients do not need this mod

FractureCharacters includes an automatic update system that:

1. Checks GitHub for new releases when the server starts
2. Downloads updates automatically in the background
3. Stages the update as a .update file
4. Applies on restart - the new version is loaded when the server restarts

Server Start → Check GitHub API → New version? → Download DLL
                                                       ↓
Server Restart → Detect .update file → Backup current → Apply update

If you prefer manual updates:

1. Set EnableAutoUpdate = false in the config
2. Download releases from the GitHub Releases page
3. Replace BepInEx/plugins/FractureCharacters.dll

• Added automatic update system from GitHub
• GitHub Actions workflow for automated releases
• DLL-only and full package releases

• Server-side only operation (no client mod required)
• One-time migration system with tracking
• Configurable backup retention
• Admin console commands
• Pre-restore backup safety

MIT License - See LICENSE file

• Inspired by blaxxun's ServerCharacters
• Built for the Fracture Valheim server