Troubleshooting

Common Vintage Story issues and solutions

Troubleshooting Vintage Story

Common issues and solutions for Vintage Story servers.

Server Won’t Start

Check Console Output

Always read the console for specific error messages.

Common Startup Issues

Missing Dependencies

[Error] Missing required library

Solution: Reinstall server or contact support

Port Already in Use

[Error] Port 42420 is already in use

Solution:

• Wait for old instance to fully stop
• Check for duplicate processes
• Contact support if persists

Corrupted Files

[Error] Failed to load assembly

Solution:

1. Backup your world (/Saves/)
2. Reinstall server
3. Restore world

Invalid Configuration

[Error] Failed to parse serverconfig.json

Solution:

1. Validate JSON at jsonlint.com
2. Check for syntax errors
3. Restore from backup

Out of Memory

[Error] Out of memory exception

Solution:

• Upgrade server RAM
• Reduce world size
• Remove memory-heavy mods

Connection Issues

Players Can’t Connect

”Connection refused”

Causes & Solutions:

1. Server not running → Start the server
2. Wrong IP/port → Verify address
3. Server still starting → Wait and retry

”Connection timed out”

Causes & Solutions:

1. Server overloaded → Reduce player count
2. Network issues → Check server status
3. DDoS protection → Wait and retry

”Version mismatch”

Solution: Players must use same VS version as server

”Authentication failed”

Causes:

• Invalid game license
• Account issues

Solution: Verify game purchase and account

Frequent Disconnections

Causes & Solutions:

1. Server lag → Check performance
2. Network issues → Check connectivity
3. Client-side problems → Player checks their connection

Mod Issues

Mod Not Loading

[Error] Failed to load mod: ModName

Causes:

• Wrong VS version
• Missing dependencies
• Corrupted file

Solutions:

1. Check mod version compatibility
2. Install required dependencies
3. Re-download mod

Mod Version Mismatch

[Error] Client mod version differs from server

Solution: Ensure identical mod versions on server and client

Mod Conflicts

Symptoms:

• Crashes
• Missing features
• Strange behavior

Solutions:

1. Remove mods one by one to identify conflict
2. Check mod compatibility notes
3. Update conflicting mods

Missing Mod Error

[Error] Server requires mod: ModName

Solution: Player must install the required mod

Performance Issues

Server Lag

Symptoms:

• Slow response
• Rubber-banding
• Delayed actions

Common Causes:

Cause	Solution
Too many players	Reduce max players
Heavy mods	Remove/optimize mods
World too large	Reduce world size
Low RAM	Upgrade plan

Memory Issues

[Warning] Low memory

Solutions:

1. Upgrade server RAM
2. Reduce view distance
3. Lower max players
4. Remove heavy mods

Chunk Loading Lag

Symptoms: Lag when players explore new areas

Solutions:

1. Pre-generate the world
2. Reduce chunk loading distance
3. Increase RAM

World Issues

World Won’t Load

[Error] Failed to load world

Causes:

• Corrupted world files
• Incompatible version
• Disk space issues

Solutions:

1. Restore from backup
2. Verify VS version matches world
3. Check disk space

Missing Chunks

Symptoms: Holes in the world, missing terrain

Causes:

• Corruption
• Improper shutdown
• Mod issues

Solutions:

1. Restore from backup
2. Let chunks regenerate (loses builds)

Corrupted World

Prevention:

• Use proper stop commands
• Regular backups
• Graceful shutdowns

Recovery:

1. Stop server immediately
2. Restore latest backup
3. Investigate cause

Player Issues

Players Can’t Move/Stuck

Solutions:

1. Use /tp <player> spawn
2. Player reconnect
3. Check for mod conflicts

Players Losing Items

Causes:

• Server crash without save
• Bug in mod

Prevention:

• Frequent autosaves
• Regular backups
• Test mods

Permission Issues

“You don’t have permission”

Solution: Grant appropriate role:

/role PlayerName admin

Common Error Messages

”Server is full”

Solution: Increase MaxClients in config or upgrade plan

”Banned from server”

Solution: Admin unban with /unban <player>

”Whitelist enabled”

Solution: Admin add with /whitelist add <player>

”Invalid password”

Solution: Use correct password or admin removes password

Diagnostic Steps

1. Check Server Status

• Is server online?
• Any errors in console?
• Resource usage normal?

2. Check Configuration

• Valid JSON?
• Correct settings?
• Recent changes?

3. Check Mods

• All compatible?
• Any new mods?
• Any updates needed?

4. Check World

• Backup available?
• Corruption signs?
• Size reasonable?

Getting Help

Information to Provide

When contacting support, include:

1. Full console log
2. Server version
3. List of installed mods
4. Steps to reproduce issue
5. When problem started

Support Channels

1. Check this knowledge base
2. Vexium Discord
3. Official VS Forums
4. Open a Support Ticket

Prevention Tips

1. Regular backups - At least daily
2. Proper shutdowns - Use /stop command
3. Test updates - Before applying to main server
4. Monitor resources - Check RAM/CPU regularly
5. Document changes - Keep notes on modifications
6. Update carefully - Test mods after VS updates