We are your new 5-Star Hosting Company. At least according to ★ Trustpilot

Following along with a Soulmask server? Deploy yours in minutes.

All servers come with a 24-Hour Trial, Free Backups, and 40Gbps DDoS Protection included!

Use code SAVE15 to take 15% OFF Your First Invoice with ChicagoServers! Limited Time!
Soulmask guide

Soulmask Admin Commands, RCON and Cross-Server Clusters

By the ChicagoServers team · Updated · 6 min read

To administer a Soulmask server you set the Admin (GM) password on the Startup tab, then press ~ in game and run gm key YOUR_PASSWORD. From there you can use the GM panel, ban and mute players with server permission lists, and manage the server from the Console tab. Linking the base map with the Shifting Sands DLC map uses a separate, documented cluster setup, which the Startup tab has fields for.

Checked against the Soulmask wiki's private server notes and several host guides, current as of November 2026. Single-source details are labeled.

Quick answer
  • Admin access: set Admin (GM) password on the Startup tab, click Save startup and Restart, then in game press ~, run gm key pass, and enter the password again in the GM panel.
  • Ban: AddServerPermissionList 1 steamID. Mute: AddServerPermissionList 4 steamID. Remove with RemoveServerPermissionList.
  • Cluster: on the main server set Server ID in the cluster and Cluster port (main server only); on every other server set its own Server ID in the cluster and Main server address (other servers only). Set KaiQiKuaFu to 1 in GameXishu.json on each.
  • Start the main server first and stop it last; client servers depend on it.
On this page
  1. Becoming an admin
  2. Joining your server and the invitation code
  3. Admin and moderation commands
  4. Maintenance port, RCON and the Console tab
  5. How to cluster the base map and Shifting Sands
  6. What travels between servers
  7. Player counts and keeping it fast
  8. Frequently asked questions

Becoming an admin

  1. Set the admin password

    Open your server in the panel, go to the Startup tab, and fill in Admin (GM) password. Click Save startup, then Restart (also do this whenever you change the password later).

  2. Open the console

    In the Soulmask client, press ~ while connected to your server.

  3. Activate the GM panel

    Run the command below, then enter the same password again in the GM panel and confirm to become an administrator.

    gm key YOUR_ADMIN_PASSWORD

Host references list spawning items, teleporting, kicking and banning, and weather and time control among the admin tools. The GM panel also has a cross-server toggle used for clusters, covered below.

Joining your server and the invitation code

Players can join through Online Game, then Connect to the server directly, with the address at the top of your server's page (click it to copy). The server also generates a 25-character invitation code on its first run. It appears in WS/Saved/Logs/WS.log after the text [SERVER UNIQUE ID:]; you can read it on the Console tab or open the log from the Files tab. The wiki notes have an FAQ entry on how the code is used, so check it for the current method.

If the server does not show in the browser, you do not need to open anything: the panel assigns the game and query ports (Startup tab, Network). Check the Troubleshoot tab and the last lines on the Console tab, and make sure you are not running two servers on the same port. If it still does not appear, contact support, since the launch options such as -forcepassthrough are staff-only.

Admin and moderation commands

The gm commands are typed in the in-game console (~) after you activate the GM panel. AddServerPermissionList and RemoveServerPermissionList are server commands: type them on the Console tab and click Send (RCON is handled for you).

CommandWhat it does
gm key PASSWORDOpens the GM panel (password from -adminpsw)
gm BaoCunSaves the world from in game
gm go x y zTeleports to coordinates
AddServerPermissionList 1 steamIDBans a player
RemoveServerPermissionList 1 steamIDUnbans a player
AddServerPermissionList 4 steamIDMutes a player
RemoveServerPermissionList 4 steamIDUnmutes a player

The official notes also list tribe-management GM commands such as gm join_tribe [index], gm take_over_target_tribe and gm DeleteGuild Index. There is also a -serverpm startup parameter for player permission lists, but it takes a bitmask that the sources we found do not explain, so we are not going to guess values. It has no Startup field, so contact support if you need it.

Maintenance port, RCON and the Console tab

On the panel you use the Console tab: type a command and click Send. RCON is handled for you, and there is no RCON password to set in the Startup tab. The game's maintenance port (-EchoPort, default 18888, TCP) is for local telnet use only and is not something you connect to yourself. For reference, its commands are:

Game maintenance commands: help lists commands; quit N shuts down after N seconds
help
saveworld 1
quit 180

To save and shut down cleanly, click Stop at the top of the page: it saves the world and shuts the game down properly. Kill only appears when the server is frozen, and it ends the game without saving.

RCON is optional in the game itself and uses -rconpsw and -rconport (default 19000). A host reference adds that RCON is restricted to allowed IPs listed under [Server.SafeIP] in Engine.ini, and that -rconaddr=127.0.0.1 keeps it local. Both details come from single host sources, and neither is a customer setting on the panel; contact support if you need a custom RCON setup. Use a different password from your join and admin passwords.

How to cluster the base map and Shifting Sands

Clustering lets players travel between separate Soulmask servers. The documented example pairs the base map, Cloud Mist Forest (Level01_Main), as the main server with Shifting Sands (DLC_Level01_Main) as a client. The main server stores the account database; client servers connect to it. Each map is its own server in your panel.

SettingMain serverClient server
MapMap field: Level01_MainMap field: DLC_Level01_Main
Server IDServer ID in the cluster: 1 (the game's -serverid=1)Server ID in the cluster: 2 (unique per server)
Cluster linkCluster port (main server only), for example 20000 (the game's -mainserverport)Main server address (other servers only), in the form MAIN_IP:PORT (the game's -clientserverconnect)
Game and query portsAssigned by the panelAssigned by the panel; each server gets its own
GameXishu.json"KaiQiKuaFu": 1 on the Configs tab"KaiQiKuaFu": 1 on the Configs tab

Guides also say to use the same join password and the same game mode on every server in the cluster, and the same Soulmask version everywhere (use Update now on each server). Cross-server mode can alternatively be switched on in the GM panel. The main server's cluster port must be reachable from every client; if a plugin or cluster link needs an extra port, you can reserve one on the Startup tab under Network, Extra ports.

  1. Set up the main server

    On the main server's Startup tab, set Map, Server ID in the cluster and Cluster port (main server only). Click Save startup.

  2. Set up each client server

    On each other server's Startup tab, set Map, a different Server ID in the cluster, and Main server address (other servers only). Use the same Join password on all servers and click Save startup.

  3. Turn on cross-server travel

    Stop each server, open Configs, Gameplay settings (GameXishu.json), set "KaiQiKuaFu": 1, and click Save.

  4. Start in order

    Start the main server first, wait for it to finish loading on the Console tab, then start the client servers.

What travels between servers

  • Character progression (the character, awareness and tech unlocks) lives in the main server's account database and follows the player.
  • World data does not travel: buildings, placed resources, local inventory and tribesmen stay on the server where they were built.
  • Players travel through a portal terminal on the mysterious island. Two host guides say this works while controlling a tribesman rather than a player's first character, so test with a spare account before announcing it.
  • Every player entering Shifting Sands must own the DLC, according to one host guide.
  • Converting an existing standalone server to a cluster node is possible, but a host reference says a migration tool (CopyRoles.exe) is Windows-only, the map names must match, and you should back up the world first.

Player counts and keeping it fast

The default cap is 20 players and host references state a ceiling of 70; on ChicagoServers the player slots come from your plan. Most communities run far fewer. A server needs roughly 11 to 12 GB of RAM just to start, and tribesman AI, which is heavily single-threaded, grows with the world. Keep an eye on the tribesman caps first when performance drops, and restart on a schedule during quiet hours: on the Schedules tab, add a task with a console warning, a wait, then Restart the server.

Hosting with ChicagoServers? The Soulmask server hosting page lists what is included, such as free server backups and SFTP file access. For a cluster you need one server per map, and you set the fields shown above on each.

Frequently asked questions

How do I get admin on a Soulmask server?

Set the Admin (GM) password on the Startup tab, click Save startup and Restart, then press ~ in game, run gm key YOUR_PASSWORD, and enter the password again in the GM panel.

How do I ban a player on a Soulmask server?

On the Console tab, type AddServerPermissionList 1 steamID and click Send. To unban, use RemoveServerPermissionList 1 steamID. Using 4 instead of 1 mutes and unmutes.

Does Soulmask support cross-server travel?

Yes, through a main and client server setup. On the Startup tab set Server ID in the cluster on every server, Cluster port on the main server and Main server address on the others, and set KaiQiKuaFu to 1 in GameXishu.json (Configs tab). Buildings and local inventory do not transfer.

How do I shut down a Soulmask server without losing data?

Click Stop at the top of the server's page. It saves the world and shuts the game down properly. Do not use Kill unless the server is frozen, because it ends the game without saving and can roll data back.

We are your new 5-Star Hosting Company. At least according to ★ Trustpilot

Following along with a Soulmask server? Deploy yours in minutes.

All servers come with a 24-Hour Trial, Free Backups, and 40Gbps DDoS Protection included!

We offer quality support, a detailed knowledgebase, video tutorials on most topics, and even live support in case you prefer a live human.

Use code SAVE15 to take 15% OFF Your First Invoice with ChicagoServers! Limited Time!