How to Configure Cross-Map Travel in Soulmask

Expanding your tribe across multiple landscapes is one of the most exciting features in Soulmask. Similar to the popular cluster systems seen in other survival games, Soulmask allows you to link multiple servers together into a massive, interconnected network. This means your tribesmen, pets, and hard-earned items can travel seamlessly between different worlds. Whether you want to create a Cross-Map adventure featuring diverse terrains or connect multiple servers running the exact same map to support a huge population, the technical setup is exactly the same.

This guide will walk you through configuring your Main Server, connecting your Client Servers, and activating the travel portal.

Important Reminder: Lock Your Server IDs

Player account data is permanently tied to the Server ID. You must lock in your Server IDs before players join and create characters. If you change a Server ID later, players will lose access to their accounts and effectively have to start over.

Step 1: Designating the Main Server

One server must act as the Main Server. It hosts a world, but it also securely holds all the player account data for the entire cluster. If this server goes offline, the other connected servers will not function properly.

1. Log into the server panel of your Main Server and navigate to the Networking tab, and locate your assigned Cluster port (for example, 11444). Write this number down, as you will need it for all your other servers.

   

    

2. Navigate to Basic Settings.

   

    

3. Under the Server ID field, enter a unique number (for example, 1) and under the Cluster Main Server Port, enter the exact Cluster port you found in step 1.

   

   

    

4. Save your changes by clicking on Update Server and restart the server by going to Actions > Restart.

   

    

Step 2: Connecting the Client Servers

All other servers in your cluster are considered Client Servers. They must report back to the Main Server to function and share data.

1. Log in to the server panel for your Second Server and navigate to Basic Settings.

2. Under the Server ID field, enter a completely different, unique number (for example, 2). No two servers can share the same ID.

3. Locate the Client Server Cluster Connect field. Enter the exact IP address and the Cluster port of your Main Server, formatted as IP:PORT (for example, 138.199.46.91:11444).

Don't forget to add the Cluster Main Server Port on it as well.

1. Ensure both your Main Server and Second Server are using the exact same server join password.

2. Save your changes by clicking on Update Server, and restart the server by going to Actions > Restart.

   

    

Step 3: Enabling Character Transfers

For players to actually leave a server, you must enable the Cross-server Mode toggle. (Note: Servers always accept incoming players, this setting only controls allowing players to leave).

• Method 1 (In-Game): Open your admin panel while logged into the server and toggle Cross-server Mode on.

  

   

• Method 2 (File Manager): Navigate to WS/Saved/GameplaySettings/GameXishu.json. In section "1", add or change the variable "KaiQiKuaFu": 1 to enable the feature manually.

  

  

   

Step 4: The Correct Restart Order

Because the Client Servers rely on the Main Server for player data, they must be restarted in a specific order to prevent crashes or freezing.

• When Starting: Start the Main Server first. Wait for it to fully boot, then start your Client Servers.

• When Stopping: Shut down all Client Servers first. Once they are completely offline, you can safely shut down the Main Server.

How Players Travel In-Game

Once the cluster is online, players cannot simply teleport from a menu. To move between maps, they must do the following:

1. Travel to the Mysterious Island located in the ocean on the map.

   

    

2. They must be controlling a tribesman (players cannot transfer using their initial starting character).

3. Interact with the terminal in front of the portal. A menu will appear, allowing them to select the connected destination server!

   

Troubleshooting & Tips

• Migrating Existing Saves: If you are connecting servers that already have players on them, you cannot just link them up. Standalone servers store player data inside world.db, while clustered servers require a separate account.db file. You must use the official CopyRoles.exe tool (found in your server files at WS/Plugins/DBAgent/ThirdParty/Binaries/) to extract this data before clustering.

• Clients Failing to Connect: If a Client Server refuses to link, double-check that the IP and Port in the Client Server Cluster Connect field are perfectly typed and that both servers share the exact same join password.

   

Conclusion

Setting up a Soulmask server cluster takes a little bit of careful configuration, but the payoff is massive. By connecting multiple maps and servers, you create an expansive universe for your players to explore, conquer, and dominate. Just remember to always start your Main Server first, and your tribesmen will be traveling across the ocean in no time.

If you encounter any issues or have further questions, feel free to contact our support team for assistance! 

Happy gaming!