Have you just bought a Soulmask server and need to upload your existing local save to the server? Or maybe you already have a server and need to transfer your world and player data between the two.
This guide will walk you through migrating your Soulmask server without losing any data. Understanding the save system is crucial - all player data is contained in the world.db file, and there's currently no way to modify or merge saves. If you're also looking to customize your server after migration, our Soulmask server settings guide covers all configuration options.
Soulmask Save Locations
Here is where you will find both the Soulmask world save file and config.
Dedicated Server:
-
/WS/Saved/GameplaySettings/GameXishu.json
-
/WS/Saved/Worlds/Dedicated/Level01_Main/world.db
Local Windows PC:
-
%LOCALAPPDATA%\WS\{YOUR-STEAM-ID}\2646460\AutoGames\{YOUR-GAME-INVITE-ID}\GameXishu.json
-
%LOCALAPPDATA%\WS\{YOUR-STEAM-ID}\2646460\AutoGames\{YOUR-GAME-INVITE-ID}\world.db
Transfer From Another Soulmask Dedicated Server
Transferring between dedicated servers is straightforward when you know which files to move. Here's the process:
-
Stop your server.
-
On your existing server, download these 2 files /WS/Saved/GameplaySettings/GameXishu.json and /WS/Saved/Worlds/Dedicated/Level01_Main/world.db
-
Log into your new server using the file manager or FTP and navigate to the same locations as above and delete the existing
GameXishu.json
andworld.db
files. (Assuming you don’t want to save them, otherwise back them up) -
Copy your files from your previous server.
-
Start your Soulmask server.
Transfer From a Local PC (Co-op Save)
Moving from single-player or local co-op to a dedicated server lets you play with friends 24/7. The process requires finding your local save files in Windows' hidden folders:
-
Press
WIN + R
on your keyboard and type%LOCALAPPDATA%\WS\
. -
You will now see some folders, navigate to the one that has your Steam ID. (Example: 76561198106341655)
-
Navigate to
2646460\AutoGames\
and then select the folder with the same invite code as the world you want to transfer. -
Copy the
world.db
and the latestGameXishu.json
file. If your file is calledGameXishu_2.json
, then rename it toGameXishu.json
. -
Login and stop your Soulmask server.
-
Navigate to
/WS/Saved/GameplaySettings/
and replace the existingGameXishu.json
file. -
Navigate to
/WS/Saved/Worlds/Dedicated/Level01_Main/
and replace the existingworld.db
file. -
Start your Soulmask server.
Troubleshooting Common Transfer Issues
World Not Loading
If your world doesn't load after transfer:
- Verify file permissions are correct (readable by the server)
- Ensure you renamed any numbered config files (GameXishu_2.json → GameXishu.json)
- Check that file paths match exactly - Linux servers are case-sensitive
Missing Player Data
Player data is stored entirely in world.db. If players are missing:
- Confirm you transferred the correct world.db file
- Check the file size matches your original (should be several MB)
- Ensure the server fully stopped before replacing files
Professional Migration Services
Many dedicated game server providers offer free migration services. This can be helpful if:
- You're uncomfortable with file transfers
- You're moving large worlds (100MB+)
- You need to migrate multiple servers
Simply open a support ticket with your host for assistance.
Next Steps After Migration
Once your world is successfully transferred:
- Test all player inventories and bases load correctly
- Verify your admin commands still work
- Consider adjusting server settings for your new hosting environment
- Set up automated backups to prevent future data loss
If you encounter issues during migration, the GhostCap Discord community can provide additional support and troubleshooting help.