Transfer Soulmask World Save: Upload Your Save to a Server

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:

1. Stop your server.

2. On your existing server, download these 2 files /WS/Saved/GameplaySettings/GameXishu.json and /WS/Saved/Worlds/Dedicated/Level01_Main/world.db

3. 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 and world.db files. (Assuming you don’t want to save them, otherwise back them up)

4. Copy your files from your previous server.

5. 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:

1. Press WIN + R on your keyboard and type %LOCALAPPDATA%\WS\.

2. You will now see some folders, navigate to the one that has your Steam ID. (Example: 76561198106341655)

3. Navigate to 2646460\AutoGames\ and then select the folder with the same invite code as the world you want to transfer.

4. Copy the world.db and the latest GameXishu.json file. If your file is called GameXishu_2.json , then rename it to GameXishu.json .

5. Login and stop your Soulmask server.

6. Navigate to /WS/Saved/GameplaySettings/ and replace the existing GameXishu.json file.

7. Navigate to /WS/Saved/Worlds/Dedicated/Level01_Main/ and replace the existing world.db file.

8. 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:

1. Test all player inventories and bases load correctly
2. Verify your admin commands still work
3. Consider adjusting server settings for your new hosting environment
4. 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.