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 Server Settings: Startup Fields and GameXishu.json

By the ChicagoServers team · Updated · 8 min read

Soulmask servers are configured in three layers: the Startup tab (name, map, mode, passwords, save timing), Engine.ini (the same basics as defaults), and GameXishu.json (every gameplay multiplier, with key names in Chinese pinyin). The panel applies your Startup values at every start, so they win over Engine.ini, and GameXishu.json only exists after the first successful start. You edit both files on the Configs tab.

Checked against the Soulmask wiki's private server notes, a developer statement on Steam and host references, current as of November 2026. One caution up front: only Survival Mode runs on private servers right now, so Tribe and Warrior mode settings are not something you can switch on with a flag.

Quick answer
  • The panel installs and updates the server for you: use Update now on the Steam update bar when an update is out. You never run SteamCMD or a start script yourself. The first map is Level01_Main.
  • Name, map, mode and passwords are fields on the Startup tab: Server name, Map, Mode, Join password and Admin (GM) password. Click Save startup, then Restart. Player slots come from your plan.
  • Ports are assigned by the panel (Startup tab, Network). The game's own defaults are game 8777 UDP and query 27015 UDP; the maintenance (telnet) port 18888 is local only.
  • Gameplay multipliers are in Gameplay settings (GameXishu.json) on the Configs tab. Stop the server before editing and keep the JSON valid.
On this page
  1. How Soulmask server settings are layered
  2. Installing and updating the server
  3. Startup settings and launch parameters
  4. Editing GameXishu.json safely
  5. Key GameXishu.json settings
  6. Saves, backups and shutting down
  7. Adding Workshop mods
  8. Frequently asked questions

How Soulmask server settings are layered

Settings can come from three places, and knowing which one wins saves a lot of confusion. Startup values (the fields on the Startup tab) have the highest priority, then Engine.ini under [Dedicated.Settings], then the defaults. GameXishu.json is separate: it holds gameplay tuning that has no Startup field.

File or locationOn the panelWindows pathLinux path
Engine.iniConfigs tab, Engine.ini (stop first)WS\Saved\Config\WindowsServer\Engine.iniWS/Saved/Config/LinuxServer/Engine.ini
GameXishu.jsonConfigs tab, Gameplay settings (GameXishu.json) (stop first)WS\Saved\GameplaySettings\GameXishu.jsonWS/Saved/GameplaySettings/GameXishu.json
Server logConsole tab (live output); the file is on the Files tabWS\Saved\Logs\WS.logWS/Saved/Logs/WS.log

The wiki's Engine.ini defaults are SteamServerName=UNNAMED_SERVER, MaxPlayers=20, pvp=False, backup=900 and saving=600, with Port=8777 under [URL] and GameServerQueryPort=27015 under [OnlineSubsystemSteam]. If a file does not exist yet, the Configs tab says so; most games create it on first start, and saving creates it right away.

Installing and updating the server

There is nothing to install by hand. The panel installs the server and keeps it updated: when the Steam update bar at the top of the page says an update is out, click Update now (a running server stops and starts again by itself). Validate repairs the files, and Update and validate files on the Settings tab does the same. For reference, the dedicated server tool is Steam app 3017310 (Windows) or 3017300 (Linux), and the game's own app ID is 2646460. If the server stops with a Steam initialization error, run Validate first and contact support if it persists.

The first boot downloads a lot of data and can take 20 to 30 minutes according to one host, so watch the Console tab until it says the server is ready before testing. Players connect from Online Game, then Connect to the server directly, using the address at the top of your server's page (click it to copy).

Startup settings and launch parameters

The panel builds the launch line from your Startup fields. The game's parameter names are listed here so you can read other guides and match them to the panel. Anything without a Startup field is staff-only: contact support rather than trying to change the command line.

Game parameterWhat it doesOn the panel
-server, -log, -forcepassthroughDedicated mode, console output (-forcepassthrough must be present)Part of the panel's launch setup; no Startup field
-SteamServerName="Name"Name in the server browser (default UNNAMED_SERVER)Server name
-MaxPlayers=NPlayer cap (20 in Engine.ini; hosts state a ceiling of 70)Set by your plan's player slots
-PSW="pass"Join password; omit for a public serverJoin password
-adminpsw="pass"Password for the in-game GM panelAdmin (GM) password
-pve / -pvpCombat mode (pvp=False in Engine.ini)Mode
-Port, -QueryPortGame and Steam query ports (UDP), 8777 and 27015 by defaultAssigned by the panel; see Startup tab, Network
-EchoPortMaintenance telnet port (TCP), 18888; keep it localNo Startup field; contact support
-MULTIHOME=IPBind to one addressNo Startup field; contact support
-saving=SECONDSHow often game objects are written to the database (600)Save objects every (s)
-backup=SECONDSHow often the database is written to disk (900)Write database every (s)
-initbackupBack up saves at every startNo Startup field; use the Backups tab or a schedule instead
-backupinterval=MINUTESInterval between world-save backups (no documented default)No Startup field; contact support
-GongHuiMaxMember=NMaximum tribe members (host references give differing defaults)No Startup field; contact support
-rconpsw, -rconportOptional RCON (port 19000)No Startup field; the Console tab handles console access for you
-mod="ID1,ID2"Steam Workshop modsWorkshop mods

To change any of these, open your server, go to the Startup tab, edit the field, click Save startup, then click Restart at the top of the page. A typical setup is a Server name such as My Soulmask Server, the base map in Map, Mode set to PvE, and a Join password and Admin (GM) password that differ from each other.

The Shifting Sands DLC map uses DLC_Level01_Main as the map name instead of Level01_Main. Pick it in the Map field; if you cannot find it there, ask support. CampFire's developers said a private server running that map needs its own dedicated server, so it is a separate server rather than a toggle (see the clustering guide for linking the two).

Editing GameXishu.json safely

This is where almost every gameplay rate lives. Follow this order every time:

  1. Click Stop at the top of the server's page and wait for it to stop. The server rewrites the file on shutdown and would overwrite live edits; the Configs tab shows Stop the server before editing this file to remind you.
  2. Make a backup first: on the Backups tab, choose World and settings and click Back up now.
  3. Open the Configs tab and pick Gameplay settings (GameXishu.json). Use the Settings view for labeled fields, or switch to Text for the whole file. In Text, keep the JSON valid: one missing comma can make the game ignore the file or fall back to defaults.
  4. Change each key everywhere it appears. A host reference reports every value appears three times in the file, and another describes numbered sections 0, 1 and 2.
  5. Click Save, then click Start, and test with a few changes at a time.

If you would rather not edit JSON, the in-game GM menu has a coefficient settings page. Press ~ in the game, run gm key YOUR_ADMIN_PASSWORD (the Admin (GM) password from the Startup tab), and open it. A host reference says those changes persist through restarts and apply without one.

Key GameXishu.json settings

Key names are pinyin. Multipliers default to 1 unless noted; the defaults below come from community key tables.

KeyControlsDefault
ExpRatioAll XP (also ShaGuaiExpRatio for kills, MJExpRatio for mask XP)1
MaxLevelMaximum character level60
CaiJiDiaoLuoRatio, FaMuDiaoLuoRatio, CaiKuangDiaoLuoRatioGathering, wood and mining yields1
ShiWuXiaoHaoRatio, ShuiXiaoHaoRatioFood and water consumption1
NaiJiuXiShuEquipment durability1
GeRenMaxZhaoMuCount / GongHuiMaxZhaoMuCountTribesmen per player / per tribe6 / 50
RuQinKaiGuanNPC raids on or off1
JianZhuFuLanKaiGuanBuilding decay on or off1
GameWorldTimePowerTime flow; community references say 24 means one real hour per game day24
WuLiYouHuaDistPhysics optimization distance6666
KaiQiKuaFuCross-server travel (see the clustering guide)0

Tribesman counts are the biggest performance lever. When tick rate drops, lower GeRenMaxZhaoMuCount and GongHuiMaxZhaoMuCount before anything else, and consider a daily restart during quiet hours (Schedules tab: add a task with a console warning, a wait, then Restart the server).

Saves, backups and shutting down

Two timers protect your world. Save objects every (s) (-saving) writes game objects to the database, and Write database every (s) (-backup) writes the database to disk. Both are on the Startup tab. Community references warn that very low saving values (below 300) can cause micro-stutters, and that long database-write intervals risk more lost progress after a crash.

The game never deletes its own old backups, and they sit on the same disk as the server. Use the Backups tab for real protection: Back up now (choose World and settings or Whole server), or set up Automatic backups and star a backup to keep it. Make one before every update. Hosting with ChicagoServers? The Soulmask server hosting page lists what is included, such as free server backups and SFTP file access.

Never kill the server to stop it, because that can roll the world back. Click Stop at the top of the page: it saves the world and shuts the game down properly. A Kill button only appears if the server is frozen and will not stop, and it ends the game without saving.

Adding Workshop mods

Open the Startup tab and enter the Steam Workshop IDs in Workshop mods (the game takes them comma-separated and without spaces, for example ID1,ID2,ID3). The ID is the number after filedetails/?id= in the Workshop URL. Click Save startup, then Restart. Mod files live in WS/Mods/, and a host reports you can copy a mod folder from your client's WS/Mods/ to the server if it cannot download one (use the Files tab or SFTP).

Players must subscribe to the same mods, and a major game update can disable a mod until its author updates it. Add one mod at a time. If the server will not start after adding one, remove it from Workshop mods and check the Troubleshoot tab.

Frequently asked questions

Where is the Soulmask GameXishu.json file?

On the Configs tab, as Gameplay settings (GameXishu.json); stop the server before editing. On disk it is WS/Saved/GameplaySettings/GameXishu.json. It is generated on first run, and the Configs tab tells you if it does not exist yet.

How many players can a Soulmask server hold?

Engine.ini defaults to 20 and host references state a ceiling of 70. On ChicagoServers the player slots come from your plan. Performance, not the cap, is usually the limit.

What ports does a Soulmask server use?

The game's defaults are 8777 UDP (game) and 27015 UDP (query). The maintenance (telnet) port 18888 TCP is local only, and RCON, if enabled, uses 19000 TCP. On the panel the ports are assigned for you and shown on the Startup tab under Network.

Can I run Tribe or Warrior mode on a private server?

Not currently. CampFire's developers disabled mode-switching on private servers and said Tribe and Warrior mode would come in a future update, so only Survival Mode is available.

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!