How To Migrate Existing Player Data To A Soulmask Server Cluster

This guide will show you how to keep your existing player data after enabling a cross map server cluster on your Soulmask server. We'll be using the CopyRoles.exe tool that comes included with the game to copy your player data from world.db into account.db.

Downloading Your Save

1. Log in to the GhostCap Panel and Stop your main Soulmask cluster server.
2. In the sidebar, go to File Manager.
3. Navigate to the save folder for your map:
   • /WS/Saved/Worlds/Dedicated/Level01_Main/ (Cloud Mist Forest)
   • /WS/Saved/Worlds/Dedicated/DLC_Level01_Main/ (Shifting of Sands)
4. Download the world.db file and copy it to a location you can find easily.

WS
└── Saved
    └── Worlds
        └── Dedicated
            ├── Level01_Main (Cloud Mist Forest)
            │   └── world.db      ← Download me!
            └── DLC_Level01_Main (Shifting of Sands)
                └── world.db      ← Download me!

Copying Player Data With CopyRoles

1. Open Steam, right-click Soulmask, and select Manage > Browse Local Files.
2. Navigate to WS\Plugins\DBAgent\ThirdParty\Binaries.
3. Paste a copy of the world.db file you downloaded into this folder.
4. Click the address bar at the top of the folder window, type cmd and press Enter. This will open a Command Prompt in the correct directory.
5. Run the following command:

   CopyRoles.exe -src=world.db -dst=account.db -type=1
   

Once completed you should see a generated account.db file.

Uploading account.db To Your Server

1. Return to the GhostCap Panel and select your main Soulmask cluster server.
2. In the sidebar, go to File Manager.
3. Navigate to /WS/Saved/Accounts/.
4. Upload your generated account.db file from the previous steps.
5. Start your server.

WS
└── Saved
    ├── Accounts
    │   └── account.db    ← Your uploaded file!
    └── Worlds
        └── Dedicated
            └── Level01_Main
                └── world.db