Soulmask Server Settings Explained

A Soulmask server is configured in two places: launch options read once at start, and GameXishu.json, about 280 gameplay coefficients. Here is what goes where.

Launch options

OptionWhat it does
Level01_Main / DLC_Level01_MainThe map: Cloud Mist Forest or Shifting Sands
-pve / -pvpThe mode
-SteamServerName=The name in the server list
-MaxPlayers=Player slots, up to 70
-PSW= / -adminpsw=The join password and the GM password
-Port= / -QueryPort= / -EchoPort=The game, query and console ports
-saving= / -backup=Seconds between writing objects to the database and the database to disk
-mod=Steam Workshop mod IDs, comma separated

On Flux these are Deployment Settings fields: name, map, mode, passwords, max players, mods and how often to save.

GameXishu.json

It lives in WS/Saved/GameplaySettings and appears after the first start. It holds three blocks, "0", "1" and "2", each with the same keys; a PvE server reads block "1" (we checked the console's live values against the file). Editing all three keeps a change in force whatever the mode. The server writes the file itself when a GM changes a value in game, so edit it with the server stopped.

KeyDefaultRangeWhat it does
ExpRatio10.1-5Awareness (character level) XP
CaiJiDiaoLuoRatio / FaMuDiaoLuoRatio / CaiKuangDiaoLuoRatio11-3Gathering, logging and mining yield
ZhiZuoTimeRatio10.1-100Crafting speed
ZuoWuShengZhangRatio10.1-100Crop growth speed
AddRenKeDuRatio10.1-10Barbarian taming speed
ShiWuXiaoHaoRatio / ShuiXiaoHaoRatio10-2Hunger and thirst
BinSiKaiGuan10 / 1The near-death state
JianZhuFuLanKaiGuan10 / 1Building decay
RuQinKaiGuan10 / 1Invasions
GongHuiMaxMember201-50Players per tribe
MaxLevel601-60Highest awareness level

Defaults and ranges are the game's own, from GameXishuConfig_Template.json in the server's files.

Presets

The server ships templates beside it: the difficulties (Casual, Easy, Normal, Hard, Master), the game modes (Warrior, Tribe Management, Creative, PvP) and boosted rates such as 3x and 5x. Each lists only what it changes from the base.

Tip:On Flux, the Server Settings tab has 84 of these coefficients as a form, with the game's defaults and ranges (any other can be set by its name in Advanced Edit), and the Gameplay tab applies a preset in one click. Your values are written into all three blocks before every start, a value a GM changes in game is kept, and "Apply to the running server" sets them live through the game's console, without a restart.

Frequently asked questions

Where is GameXishu.json?

In WS/Saved/GameplaySettings, created by the first start. On Flux you edit it through the Server Settings and Gameplay tabs instead.

Why does my change to GameXishu.json not work?

Usually because the server was running (it writes the file itself), or because only one of the three blocks was edited. A PvE server reads block "1".

Can I change rates without a restart?

Yes, with the console command sc <name> <value>, which applies at once and is saved. On Flux the Gameplay tab does it for every changed value.

Related Soulmask guides