View Categories

How to Upload Save Data to Your Soulmask Server

Contents
MIGRATION

How to move a Soulmask world you have been playing locally (single-player) to a BESTNET-GSERVER dedicated server. Your progress carries over exactly as it is.

v2.0 (revised August 2026) BESTNET LLC About 6 min read
Revision history
v2.0
August 2026 — Full revision. Added a backup step to carry out before you begin, and a procedure that renames existing files to set them aside instead of deleting them. Screen names now match the current game panel (English display), and a step to verify the result after migrating has been added.
v1.0
August 2024 — First edition

Before you begin

Carrying out this procedure replaces the existing world on the server and the progress of every player on it. This cannot be undone, so always complete these two things first.
1. Take a backup of the current server from the Backups screen in the game panel
2. Do not delete the files you are replacing — rename them to set them aside (following the steps in this article does exactly that)
What you will need:
  • The Windows PC where you play the world you want to migrate
  • Your game panel login details (from your order confirmation email)
If you have only just rented the server and nobody has played on it yet, there is no data that would be lost by the replacement. Even then, taking a backup first is reassuring.

Find your local save data

  1. Launch Soulmask and choose [Continue].
  2. Make a note of the invite code of the world you want to migrate.
  3. Press the Windows + R keys to open the Run dialog.
  4. Type %localappdata%\WS\ and press [OK].
  5. Open the folder named after your SteamID.
  6. Open 2646460 → AutoGames.
  7. Open the folder that matches the invite code you noted in step 2. You will use this folder later, so leave it open.
Choosing [Continue] on the Soulmask title screen
Launch the game and choose [Continue]
The Windows Run dialog with %localappdata%\WS\ typed in
Open it with Windows + R and type %localappdata%\WS\
This folder holds world.db, the world itself, and GameXishu_..., the gameplay settings.

Stop the server

Always stop the server before you replace any files.
  1. Log in to the game panel and select your Soulmask server.
  2. On the Console screen, press Stop and wait until the status shows that the server has stopped.
The server control buttons at the top of the game panel: Start, Restart and Stop
The server control buttons. Press Stop here.
Never replace files while the server is running. Data that is halfway through being written can be mixed in, and the world can be corrupted.

Replace the gameplay settings file

  1. Open the Files screen in the game panel.
  2. Open /home/container/WS/Saved/GameplaySettings.
  3. Use Rename to change the existing GameXishu.json to GameXishu.json.bak. Do not delete it.
  4. Upload GameXishu_... from your local folder.
  5. Use Rename to rename the uploaded file to GameXishu.json.
If this file does not exist, start the server once and then stop it, and the file will be generated.

Replace the world itself

  1. Open /home/container/WS/Saved/Worlds/Dedicated/, then open the folder named after the map you are running. The standard map (Cloud Mist Forest) is Level01_Main; the DLC map (Shifting Sands) is DLC_Level01_Main.
  2. Use Rename to change the existing world.db to world.db.bak. Do not delete it.
  3. Upload world.db from your local folder.
Save data cannot be shared between maps. The world.db you upload must be save data created on that map. Placing it in another map's folder will not load correctly. For switching maps, see How to change the map on your Soulmask server.
Opening the menu for world.db on the game panel Files screen and choosing Rename
Set existing files aside with Rename, not Delete
If you choose Delete here, the original world cannot be brought back. Always use Rename, so that if something goes wrong you can change the .bak names back and return to where you were.

Start the server and check

  1. Press Start on the Console screen in the game panel.
  2. Wait until the status becomes Online.
  3. Launch the game and join by searching for your server name in the in-game server list.
  4. Confirm that the world is in the state you migrated.
It can take a few minutes after starting before the server appears in the in-game list. For details, see Start the server and Join the server.
Once you have confirmed that the migration worked, you may delete the world.db.bak and GameXishu.json.bak files you set aside.
The folder layout on the local side can change when the game is updated. If you cannot follow these steps as written, leave the files as they are without deleting anything and contact us with a support ticket.
Scroll to top