Soulmask Admin Commands, RCON and Cross-Server Clusters
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.
- Admin access: set Admin (GM) password on the Startup tab, click Save startup and Restart, then in game press
~, rungm key pass, and enter the password again in the GM panel. - Ban:
AddServerPermissionList 1 steamID. Mute:AddServerPermissionList 4 steamID. Remove withRemoveServerPermissionList. - 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
KaiQiKuaFuto 1 in GameXishu.json on each. - Start the main server first and stop it last; client servers depend on it.
On this page
Becoming an admin
- 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).
- Open the console
In the Soulmask client, press
~while connected to your server. - 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).
| Command | What it does |
|---|---|
gm key PASSWORD | Opens the GM panel (password from -adminpsw) |
gm BaoCun | Saves the world from in game |
gm go x y z | Teleports to coordinates |
AddServerPermissionList 1 steamID | Bans a player |
RemoveServerPermissionList 1 steamID | Unbans a player |
AddServerPermissionList 4 steamID | Mutes a player |
RemoveServerPermissionList 4 steamID | Unmutes 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:
help
saveworld 1
quit 180To 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.
| Setting | Main server | Client server |
|---|---|---|
| Map | Map field: Level01_Main | Map field: DLC_Level01_Main |
| Server ID | Server ID in the cluster: 1 (the game's -serverid=1) | Server ID in the cluster: 2 (unique per server) |
| Cluster link | Cluster 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 ports | Assigned by the panel | Assigned 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.
- 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.
- 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.
- Turn on cross-server travel
Stop each server, open Configs, Gameplay settings (GameXishu.json), set
"KaiQiKuaFu": 1, and click Save. - 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.