How to Configure Cross-Map on Your Soulmask Server

Updated June 10, 2026 · By Host Havoc Technical Support Team

The cross-map feature lets players transfer characters between two Soulmask servers running different maps. You need two active Soulmask servers. Make sure both servers are stopped before starting this setup.

If you have not yet set an admin password, do that first: see Change Admin Password.

Configure the main server (Server 1)

  1. On your main server, open the Command Line Manager.
    Command Line Manager open on the main Soulmask server showing available command line options
  2. Locate the Cross-Map Main Server command line and click Select.
  3. Edit the command line and set Cross-Map ServerID to 1.
  4. Click Apply.
  5. Open Configuration Files and select GameXishu.json with Text Editor.
  6. Locate KaiQiKuaFu. If its value is 0, change it to 1. If it is already 1, proceed to the next step.
    GameXishu.json open in the text editor with the KaiQiKuaFu field set to 1
  7. Click Save.

Enable character transfers on the main server

The KaiQiKuaFu field in GameXishu.json controls character transfers. Setting it to 1 enables players to transfer to and from this server.

Config editor showing KaiQiKuaFu value confirmed as 1 with Save button ready

Configure the client server (Server 2)

  1. On your second (client) server, open the Command Line Manager.
    Command Line Manager open on the client Soulmask server for cross-map client configuration
  2. Select Cross-Map Client Server and click to edit the command line.
  3. Set Cross-Map ServerID to 2.
  4. Set Cross-Map Client Server Connect to the IP address and port of your main server.
  5. Click Apply.
  6. Open GameXishu.json on the client server and set KaiQiKuaFu to 1 (same as Step 6 above).
  7. Click Save.

Start both servers

Once both servers are configured, start the main server first, then the client server. Players can now use the in-game cross-map menu to transfer characters between the two servers.

Troubleshooting

  • Transfers not working: verify the main server IP and port entered on the client server are correct and that the main server is running and reachable.
  • KaiQiKuaFu resets to 0: re-edit GameXishu.json while the server is stopped and save before starting.
  • For help editing configuration files, see Edit Server Settings.