GAME SERVER HOSTING: 50% OFF first order with code GHOST50
Soulmask background

How To Upload Existing Soulmask Server Save

Learn how you can upload an existing Soulmask world and player data to your dedicated server.

In this tutorial, we will guide you through the process of uploading an existing world and player save file to your Soulmask server.

You may also refer to this guide on how to upload files to your game server.

If you get stuck at any time, GhostCap offers free world transfers. Just reach out to us on Discord.

Soulmask Save File Locations

There are 2 main files that you need for Soulmask. One is the game configuration (GameXishu.json) and the save data itself (world.db). The save is stored in a folder matching your map: Level01_Main (Cloud Mist Forest) or DLC_Level01_Main (Shifting of Sands).

Dedicated Server:

WS
└── Saved
    ├── GameplaySettings
    │   └── GameXishu.json
    └── Worlds
        └── Dedicated
            ├── Level01_Main (Cloud Mist Forest)
            │   └── world.db
            └── DLC_Level01_Main (Shifting of Sands)
                └── world.db

Local Windows PC:

%LOCALAPPDATA%
└── WS
    └── [YOUR-STEAM-ID]
        └── 2646460
            └── AutoGames
                └── [YOUR-GAME-INVITE-ID]
                    ├── GameXishu.json (Optional, this file contains your world settings.)
                    └── world.db

To quickly access these files locally, press Windows Key + R on your keyboard and enter

%LOCALAPPDATA%\WS

Transfer From Another Soulmask Dedicated Server

  1. On your existing server, open the file browser and download these files:
    • /WS/Saved/GameplaySettings/GameXishu.json
    • And your corresponding map:
      • /WS/Saved/Worlds/Dedicated/Level01_Main/world.db (Cloud Mist Forest)
      • /WS/Saved/Worlds/Dedicated/DLC_Level01_Main/world.db (Shifting of Sands)
    • If you're transferring a cross map cluster main server, also download /WS/Saved/Accounts/account.db
  2. Log in to the GhostCap Panel and Stop your Soulmask server.
  3. In the sidebar, go to File Manager.
  4. Once there, navigate to the same locations as above and delete the existing GameXishu.json and world.db files. Back them up first if you want to save them.
  5. Drag in your files from your previous server.
  6. In the sidebar, go to Server Options and under Basic, ensure Server Map is set to the map your save is from.
  7. Start your Soulmask server.

Transfer From A Local PC

  1. Press Windows Key + R on your keyboard and enter this:
    %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. Log in to the GhostCap Panel and Stop your Soulmask server.
  6. Go to File Manager.
  7. Navigate to /WS/Saved/GameplaySettings/ and replace the existing GameXishu.json file.
  8. Navigate to /WS/Saved/Worlds/Dedicated/Level01_Main/ or /WS/Saved/Worlds/Dedicated/DLC_Level01_Main/ depending on your map and replace the existing world.db file. Create these folders if they don't exist.
  9. In the sidebar, go to Server Options and ensure Server Map under Basic is set to the map your save is from.
  10. Start your Soulmask server.

Here's what your server should now look like:

WS
└── Saved
    ├── GameplaySettings
    │   └── GameXishu.json        ← Optionally, your uploaded world settings.
    └── Worlds
        └── Dedicated
            ├── Level01_Main (Cloud Mist Forest)
            │   └── world.db      ← Your uploaded save file.
            └── DLC_Level01_Main (Shifting of Sands)
                └── world.db      ← Your uploaded DLC save file.
Note

If you're uploading a Shifting of Sands DLC save, use the DLC_Level01_Main path instead of Level01_Main in the steps above. Ensure your Server Map under Basic in Server Options matches the map your save is from, and create the DLC_Level01_Main folder if necessary.