Why Migration is Needed
v0.8.5+ Breaking Changes
VEIN v0.8.5 introduced significant changes to save file structure:
- • New world data compression format
- • Updated player data structure
- • Modified building and storage systems
- • Enhanced mod compatibility framework
Compatibility Issues
Save files from v0.8.4 and earlier are not compatible with v0.8.5+ without proper migration. Attempting to load old saves directly will result in corruption or crashes.
Before You Begin
Backup Requirements
Always create complete backups before migration:
- • Download entire server save folder via FTP
- • Create control panel backup snapshot
- • Document current server configuration
- • Note active mods and their versions
Preparation Checklist
- • Stop the server completely
- • Verify current VEIN version (must be v0.8.4 or earlier)
- • Check available disk space (needs 2x current save size)
- • Schedule maintenance window (migration can take 10-30 minutes)
Migration Process
- 1
Stop Server & Backup
Stop the server and create full backup of save files
- 2
Update Server Files
Update VEIN server to v0.8.5+ through control panel
- 3
Run Migration Tool
Execute the built-in migration command via server console
- 4
Verify Migration
Check migration log for errors and test server startup
- 5
Test with Players
Have players verify their characters and progress are intact
Migration Commands
Console Commands
Execute these commands in server console:
# Check current version
version
# Start migration process
migrate savefile v0.8.5
# Verify migration status
migration status
Expected Output
Successful migration will show:
[INFO] Migration started for savefile v0.8.4
[INFO] Converting world data...
[INFO] Migrating player data...
[INFO] Updating mod references...
[SUCCESS] Migration completed in 12.3 seconds
Common Migration Issues
Insufficient Disk Space
- • Migration needs temporary space equal to save file size
- • Free up disk space or upgrade storage plan
- • Delete old backups before attempting migration
Corrupted Save Files
- • Migration will fail on corrupted save data
- • Try restoring from earlier backup
- • Consider starting fresh world if corruption is severe
Mod Compatibility
- • Some mods may not be compatible with v0.8.5+
- • Remove outdated mods before migration
- • Update mods to v0.8.5+ compatible versions
Timeout Errors
- • Large worlds may take longer to migrate
- • Increase server timeout settings if needed
- • Try migration during off-peak hours
Post-Migration Checklist
Server Verification
- • Server starts without errors
- • World loads correctly
- • Console shows v0.8.5+ version
- • No error messages in server log
Player Verification
- • Players can join without issues
- • Character positions and inventory intact
- • Building progress preserved
- • Mod functionality working correctly
Final Steps
- • Create new backup of migrated save
- • Remove old pre-migration backup files
- • Update server documentation
- • Notify players of successful migration
Rollback Plan
If Migration Fails
Steps to rollback to previous version:
- 1. Stop the server immediately
- 2. Restore pre-migration backup files
- 3. Revert server to previous version (v0.8.4)
- 4. Start server and verify functionality
- 5. Contact support if issues persist
When to Rollback
- • Migration fails with critical errors
- • Significant data corruption detected
- • Essential mods incompatible with new version
- • Players experience major issues