Create a Soulmask server cluster by setting one server as the master and the others as slaves in Start.bat, then enabling Cross-server Mode, so players can travel between maps and servers.
This guide links your Soulmask servers into a cluster. We cover how to configure both the master server and the slave server so everything works. Follow each step carefully and in order.
On this page
Important notes before you create a Soulmask server cluster
- You need at least 2 servers to create a cluster.
- Players must visit the mysterious island portal on either map to transfer between servers. See the travel location in the maps.
- Your initial character cannot travel between servers; you must use a tribesman.
- If using a password, both servers must have the same password.
- The Cross-server Mode admin setting must be enabled on all servers.
- The master server should always start first and stop last.
How to set up the master server
- Open your Master Server game panel.
- Stop the server.
- Go to Configuration Files and edit the
Start.batfile. - Enable This is a Master Server from the Crossplay dropdown.
- Start the server and join it.
- Login as admin.
- Open the admin menu, then go to the coefficients menu.
- Find Cross-server Mode and enable it.
How to set up the slave server
You must copy the Master Connection Info from the master server before configuring the slave server.
- Open the Master Server panel.
- Click Server Details and copy the Master Connection Info.
- Open the Slave Server panel.
- Edit the
Start.batfile under Configuration Files. - Enable This is a Slave Server from the Crossplay dropdown.
- Paste the Master Connection Info you copied.
- Start the server and join it.
- Login as admin.
- Open the admin menu, go to the coefficients menu.
- Enable Cross-server Mode.
Tips and warnings
- Always ensure both servers are online before attempting transfers.
- Keep server configurations consistent across the cluster.
- Using the same password avoids transfer interruptions.
- Restart servers in the correct order to prevent issues.
Common transfer errors
- Server restart issues: the master server must start first and stop last; otherwise, transfers may fail or servers may hang.
- Password mismatch: if passwords differ, players may be kicked to the main menu during transfer.
- Initial character restriction: your starting character cannot transfer; use a tribesman instead.
- Cross-server disabled: transfers will fail if "Cross-server Mode" is not enabled in server settings.
With everything set up, your players can explore multiple maps from one cluster. Make sure all settings are correctly configured on both servers for smooth, reliable transfers.
Soulmask cluster questions
How do I create a Soulmask server cluster?
You need at least 2 servers. In the master server's Start.bat choose This is a Master Server from the Crossplay dropdown. Copy the Master Connection Info from its Server Details, then in each slave server's Start.bat choose This is a Slave Server and paste that info. Finally enable Cross-server Mode in the admin coefficients menu on every server.
How do players travel between Soulmask servers in a cluster?
Players use the mysterious island portal on either map. The initial character cannot travel; you must use a tribesman.
Why are players kicked to the main menu during a transfer?
Usually the servers have different passwords. If you use a password, every server in the cluster must have the same one. Also check that Cross-server Mode is enabled on all servers and that the master started first.
Want your own Soulmask servers to link into a cluster? GTX Soulmask servers come with the Crossplay settings in Start.bat and full file access: see Soulmask server hosting.
Related guides
Any questions? Our support team is available 24/7: open a support ticket.
