Soulmask Server Config Generator
Soulmask's dedicated-server config, GameXishu.json, is written in romanized Chinese (pinyin) and
wrapped in a confusing three-block structure that trips up almost everyone who hand-edits it. This tool fixes both:
fill one clean, English-labelled form and it writes your values — correctly typed — into all three
0 / 1 / 2 blocks at once, the practice multiple admins and host KBs confirm
always applies. Every field shows its exact pinyin key so you can match your file, and the
toggle-vs-multiplier traps are handled for you: HuXIangShangHaiKaiGuan is rendered as
the on/off friendly-fire switch it actually is, not a slider. The second tab builds a ready-to-run
start script (.bat and .sh) with the right launch flags — ports, player cap, passwords, ruleset and
the SteamCMD update line. Accuracy is the whole point, so anything single-source or unconfirmed carries a
⚠ verify badge rather than a confident guess — we never invent keys or
translations.
Experience & Progression
XP rates and the level cap. All the rate fields are multipliers (1.0 = vanilla); MaxLevel is a whole number.
Master XP multiplier applied to every XP source. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ExpRatio. Default 1 confirmed by 2 host KBs + SDK dump.
Character level XP gain. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ChengZhangExpRatio.
Mask skill XP. ('MJ' = MianJia = the mask.) Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: MJExpRatio. GHOSTCAP labeled this 'MJ Experience Ratio'; SDK dump clarifies = mask/mastery.
Weapon/tool proficiency XP. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ShuLianDuExpRatio.
XP from mining/chopping/picking. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: CaiJiExpRatio.
XP from crafting. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ZhiZuoExpRatio.
XP from killing creatures. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ShaGuaiExpRatio.
Miscellaneous XP sources. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: QiTaExpRatio.
XP from training activities. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: TrainingExpRatio.
Share of kill XP when several players participate. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ShaGuaiExpShareRatio. Default 0.2 from GHOSTCAP.
Share for indirect contributors. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: OtherShaGuaiExpShareRatio.
XP share for deployed tribe members fighting with you. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ChuZhanZuRenShaGuaiExpShareRatio.
Level ceiling for players. Whole number. Pinyin key in the file: MaxLevel. Default 60 confirmed 2 sources.
Initial proficiency level on start. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: CurProfInitRatio.
Gathering, Drops & Production
Harvest yields, loot drop rates, and crafting/production speed — almost all multipliers. Watch the one toggle here: TeShuDaoJuDropXiShuJiaChengKaiGuan ends in KaiGuan, so it is an on/off switch despite the XiShu (coefficient) in its name.
General harvest yield. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: CaiJiDiaoLuoRatio.
Wood yield. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: FaMuDiaoLuoRatio.
Ore/stone yield. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: CaiKuangDiaoLuoRatio.
Loot from animal carcasses. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: DongWuShiTiDiaoLuoRatio.
Rare item drops from animals. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: DongWuShiTiZhongYaoDiaoLuoRatio.
Output of resource-producing buildings. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: CaiJiShengChanJianZhuDiaoLuoRatio.
Loot from common human NPCs. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: PuTongRenDiaoLuoRatio.
Loot from elite NPCs. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: JingYingRenDiaoLuoRatio.
Loot from boss NPCs. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: BossRenDiaoLuoRatio.
Yield from harvesting crops. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ZuoWuDropRatio.
Loot quantity from chests. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: BaoXiangDropRatio.
Quality grade of chest loot. Whole number. Pinyin key in the file: BaoXiangDiaoLuoDengJi. Default 0 (GHOSTCAP).
Crafting duration; <1 = faster. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ZhiZuoTimeRatio.
Speed of converters/furnaces. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ConverPropsSpeedRatio.
Quantity of animal-produced goods. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: DongWuChanChuRatio.
Time between animal production cycles. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: DongWuShengChanJianGeRatio.
Quality of tamed/spawned animals. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: DongWuPinZhiRatio.
Quality grade of recruitable humans. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ManRenPinZhiRatio. GHOSTCAP 'Marauder Quality Ratio'.
Sculpting station rate. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ChongsuRatio.
Speed of gaining NPC favor toward recruitment. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: AddRenKeDuRatio.
Hatching speed. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: FuHuaSpeed.
Adjusts normal-grade gear drop chance. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: NormalEquipDropRatioCorrection.
Adjusts starting durability of normal gear. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: NormalEquipDurabilityCorrection.
Adjusts elite gear drop chance. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: EliteEquipDropRatioCorrection.
Adjusts elite gear durability. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: EliteEquipDurabilityCorrection.
Adjusts boss gear drop chance. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: BossEquipDropRatioCorrection.
Adjusts boss gear durability. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: BossEquipDurabilityCorrection.
TOGGLE: cap quality of gear from chests. Toggle (0=any quality | 1=cap at max) — an on/off switch, not a multiplier. Pinyin key in the file: ChestDropEquipmentMaxQualitySwitch.
TOGGLE: enable bonus multiplier on special-item drops. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: TeShuDaoJuDropXiShuJiaChengKaiGuan. TRAP: ends in KaiGuan = toggle, despite 'XiShu' (coefficient) in the name. Confirmed bool by 2 sources.
Survival: Needs, Consumption & Recovery
How fast hunger, thirst, sanity and similar needs drain, and how fast health/stamina recover. Multipliers throughout.
Hunger drain speed. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ShiWuXiaoHaoRatio.
Thirst drain speed. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ShuiXiaoHaoRatio.
Stamina drain. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: QiXiXiaoHaoRatio. GHOSTCAP 'Breath Consumption'.
Furnace/torch fuel burn. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: RanLiaoXiaoHaoRatio.
Tamed-animal hunger drain. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: DongWuXiaoHaoShiWuRatio.
Tamed-animal thirst drain. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: DongWuXiaoHaoShuiRatio.
TOGGLE: turn off mental-energy consumption. Toggle (1=disable drain | 0=normal) — an on/off switch, not a multiplier. Pinyin key in the file: JingShenNoXiaoHao.
HP regen speed. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ShengMingHuiFuRatio.
Stamina regen speed. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: TiLiHuiFuRatio.
Breath/stamina regen. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: QiXiHuiFuRatio.
HP/needs recovery while logged out. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: JiaSiHuiFuRatio.
Sanity regen. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: MentalRecoveryRate.
Interval between passive recovery ticks. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: PhysicalRecoveryIntervalRate.
Strength of temperature effects. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ReDuXiShu.
How fast follower mood drops. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: XinQingJianShao.
How fast follower mood rises. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: XinQingZengZhang.
Combat & Damage
Damage scaling and the combat rules. The headline trap lives here: HuXIangShangHaiKaiGuan is the friendly-fire toggle (on/off), not a damage multiplier. Keys ending in Ratio are the multipliers.
TOGGLE: whether players can damage each other. THE classic trap — this is a switch, NOT a multiplier. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: HuXIangShangHaiKaiGuan. CRITICAL. Ends in KaiGuan; confirmed bool. Note exact casing 'HuXIang' (capital I) as in real file.
Damage players deal to wildlife. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: DamageYeShengRatio.
Damage players take from wildlife. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: BeDamageByYeShengRatio.
Damage your tamed animals deal. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: DongWuDamageRatio.
Damage reduction for tamed animals. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: DongWuJianShangRatio.
Damage your recruited humans deal. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: MaRenDamageRatio. GHOSTCAP 'Marauder Damage'.
Incoming-damage reduction for players. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ManRenJianShangRatio. GHOSTCAP 'Marauder Damage Reduction' — SDK dump assigns to player.
Damage tools deal to nodes (gather speed). Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: CaiJiDamageRatio.
Length of dodge invincibility window. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: RollingInvincibleTimeRatio.
TOGGLE: enable defensive/attacker damage rule. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: YouFangShangHaiKaiGuan. KaiGuan = toggle.
TOGGLE: player-specific variant of above. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: PlayerYouFangShangHaiKaiGuan. KaiGuan = toggle. Default 1 (GHOSTCAP).
Poise damage players deal. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ManRenTenacityDamageRatio.
Stamina damage players deal. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ManRenTiLiDamageRatio.
Poise damage from tamed animals. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: DongWuTenacityDamageRatio.
Stamina damage from tamed animals. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: DongWuTiLiDamageRatio.
Poise damage players deal to bosses. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ManRenBossTenacityDamageRatio.
Stamina damage players deal to bosses. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ManRenBossTiLiDamageRatio.
Poise damage tamed animals deal to bosses. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: DongWuBossTenacityDamageRatio.
Stamina damage tamed animals deal to bosses. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: DongWuBossTiLiDamageRatio.
Max recruited humans that follow you into battle at once. Whole number. Pinyin key in the file: ManRenChuZhanCount. Default 3 (GHOSTCAP/secondary).
Max tamed animals deployed at once. Whole number. Pinyin key in the file: DongWuChuZhanCount.
TOGGLE: scale boss stats to number of players. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: DynamicBossStats.
Difficulty of rebound/knockback mechanic. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ReboundDifficulty.
Size of melee hitbox/sweep. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: PlayerSweepRangeScale.
TOGGLE: enable incapacitated state instead of instant death. Toggle (1=downed state on | 0=instant death) — an on/off switch, not a multiplier. Pinyin key in the file: BinSiKaiGuan. KaiGuan = toggle. Default 1.
TOGGLE: allow relocating your loot bag when you respawn. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: FuHuoMoveSiWangBaoKaiGuan. KaiGuan = toggle.
TOGGLE: prevent dropping inventory on death. Toggle (0=drop items | 1=keep items) — an on/off switch, not a multiplier. Pinyin key in the file: PlayerDeathCantDropItemKaiGuan.
TOGGLE/flag: reset body stats on respawn. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: HuiFuChuShiBodyData.
TOGGLE: allow free appearance/respec reset. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: WanMeiChongSu.
Cooldown for main cannon/siege weapon use. Whole number. Pinyin key in the file: MainGunUseTimeCD.
Range for summoning/recalling. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ZhaoHuanDisRatio.
Distance for wake/transform ability. Whole number. Pinyin key in the file: HuanXingDistance.
TOGGLE: allow surface climbing. Toggle (1=on | 0=off) — an on/off switch, not a multiplier. Pinyin key in the file: PanpaKaiGuan. KaiGuan = toggle. Default 1. GHOSTCAP mislabeled 'Punishment' — SDK dump = climbing (PanPa=climb).
Cooldown between dance emotes. Whole number. Pinyin key in the file: TiaoWuLengQueTime. Default 4 (GHOSTCAP).
TOGGLE: enable forbidden build/safe zones. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: JinJianQuKaiGuan.
TOGGLE: ban glider use. Toggle (0=glider allowed | 1=disabled) — an on/off switch, not a multiplier. Pinyin key in the file: BanGlider.
PvP Damage & Time Windows
PvP damage scaling and the regional PvP time windows. The melee/ranged PvP damage multipliers default to 0.4, not 1.0 — PvP hits softer than PvE out of the box.
Overall PvP damage scaling. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: PVP_GAPVPDamageRatio.
Melee damage in PvP. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: PVP_ShangHaiRatio_JinZhan. Default 0.4 confirmed 2 sources. ('JinZhan'=melee.)
Ranged damage in PvP. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: PVP_ShangHaiRatio_YuanCheng. Default 0.4. ('YuanCheng'=ranged.)
Player-to-player damage, attacker side. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: PVP_ShangHaiRatio_PlayerToPlayer_YouFang. GHOSTCAP labels YouFang as attacker; verify in-game.
Player-to-player damage, defender side. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: PVP_ShangHaiRatio_PlayerToPlayer_DiFang.
PvP damage outside direct player-vs-player (e.g. to structures/followers). Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: PVP_ShangHaiRatio_WithoutP2P_YouFang.
Scheduled PvP window start, Asia, weekdays. Whole number. Pinyin key in the file: PVPTimeAsiaWorkStartTime. 12 PVPTime* keys (Asia/Europe/America x Work/NoWork x Start/End), defaults Start=0 End=24.
PvP window end, Asia, weekdays. Whole number. Pinyin key in the file: PVPTimeAsiaWorkEndTime.
PvP window start, Asia, weekends. Whole number. Pinyin key in the file: PVPTimeAsiaNoWorkStartTime.
PvP window end, Asia, weekends. Whole number. Pinyin key in the file: PVPTimeAsiaNoWorkEndTime.
PvP window start, Europe, weekdays. Whole number. Pinyin key in the file: PVPTimeEuropeWorkStartTime.
PvP window end, Europe, weekdays. Whole number. Pinyin key in the file: PVPTimeEuropeWorkEndTime.
PvP window start, Europe, weekends. Whole number. Pinyin key in the file: PVPTimeEuropeNoWorkStartTime.
PvP window end, Europe, weekends. Whole number. Pinyin key in the file: PVPTimeEuropeNoWorkEndTime.
PvP window start, America, weekdays. Whole number. Pinyin key in the file: PVPTimeAmericaWorkStartTime.
PvP window end, America, weekdays. Whole number. Pinyin key in the file: PVPTimeAmericaWorkEndTime.
PvP window start, America, weekends. Whole number. Pinyin key in the file: PVPTimeAmericaNoWorkStartTime.
PvP window end, America, weekends. Whole number. Pinyin key in the file: PVPTimeAmericaNoWorkEndTime.
War System
The declarable tribe-war system. Mostly toggles and a few scaling values; several are single-source, so verify before relying on them.
TOGGLE: enable declarable tribe wars. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: WarKaiGuan.
TOGGLE: enable lockdown rules. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: SuoDingKaiGuan.
War-window start, Asia. Whole number. Pinyin key in the file: AsiaWarTimeStart.
War-window end, Asia. Whole number. Pinyin key in the file: AsiaWarTimeEnd.
War-window start, Europe. Whole number. Pinyin key in the file: EuropeWarTimeStart.
War-window end, Europe. Whole number. Pinyin key in the file: EuropeWarTimeEnd.
War-window start, America. Whole number. Pinyin key in the file: AmericaWarTimeStart.
War-window end, America. Whole number. Pinyin key in the file: AmericaWarTimeEnd.
NPCs, Animals & Taming Limits
NPC and animal spawning, growth, and the per-player recruit/tame caps.
Speed baby animals mature. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: DongWuShengZhangRatio.
Time between breeding. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: FanZhiJianGeRatio.
Carry/load capacity for Kurma mounts. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: KurmaFuZhongRatio.
Max NPCs one player can recruit. Whole number. Pinyin key in the file: GeRenMaxZhaoMuCount. Default 6 confirmed 2 sources.
Tier-2 recruit cap. Whole number. Pinyin key in the file: GeRenMaxZhaoMuCount_Two. Default 10 (GHOSTCAP).
Tier-3 recruit cap. Whole number. Pinyin key in the file: GeRenMaxZhaoMuCount_Three. Default 15 (GHOSTCAP).
Max tamed animals per player. Whole number. Pinyin key in the file: GeRenMaxDongWuCount. Default 10 (GHOSTCAP).
Max special tamed animals per player. Whole number. Pinyin key in the file: GeRenMaxSpecDongWuCount.
Animals that can actively follow. Whole number. Pinyin key in the file: AnimalFollowerMaxCount.
Max raft slots per player. Whole number. Pinyin key in the file: GeRenMaxRaftSpaceCount.
Max special raft slots per player. Whole number. Pinyin key in the file: GeRenMaxSpecRaftSpaceCount.
Max map markers per player. Whole number. Pinyin key in the file: GeRenBiaoJiMaxCount.
Scaling for player-captured NPCs. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: WanJiaBeiXiaoRenRatio.
Scaling for player-tamed animals. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: WanJiaBeiXiaoTiRatio.
Scaling for crew size. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: CrewCountRatio.
TOGGLE: whether NPCs respawn. Toggle (1=on | 0=off) — an on/off switch, not a multiplier. Pinyin key in the file: ShuaXinNPCKaiGuan. KaiGuan = toggle.
Player Attributes & Inventory
Player carry weight, durability, bag size and related attribute multipliers.
Growth of passive primary attributes. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: BeiDongYiJiShuXingRatio.
Growth of active primary attributes. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ZhuDongYiJiShuXingRatio.
Growth of secondary attributes. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ErJiShuXingRatio.
Follower passive attribute growth. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: MaRenBeiDongYiJiShuXingRatio.
Follower active attribute growth. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: MaRenZhuDongYiJiShuXingRatio.
Follower secondary attribute growth. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: MaRenErJiShuXingRatio.
Animal passive attribute growth. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: DongWuBeiDongYiJiShuXingRatio.
Animal active attribute growth. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: DongWuZhuDongYiJiShuXingRatio.
Animal secondary attribute growth. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: DongWuErJiShuXingRatio.
How fast gear loses durability. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: NaiJiuXiShu.
Backpack slot count. Whole number. Pinyin key in the file: RoleBagCapacity.
Encumbrance limit scaling. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: MaxFuZhongRatio.
Building, Decay & Repair
Structure decay, repair and building rules. Note the classic toggle-vs-multiplier pair: JianZhuFuLanKaiGuan turns decay on/off, while JianZhuFuLanMul scales how fast it decays.
TOGGLE: master switch for structure decay. Toggle (1=decay on | 0=off) — an on/off switch, not a multiplier. Pinyin key in the file: JianZhuFuLanKaiGuan. KaiGuan = toggle. Default 1. PAIRS with the multiplier below — classic toggle-vs-multiplier pair.
Speed of decay when enabled. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: JianZhuFuLanMul. MULTIPLIER (suffix 'Mul'). Pairs with the KaiGuan toggle above.
How much repair restores. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: JianZhuXiuLiMul.
Materials needed to repair. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: XiuLiXuYaoCaiLiaoRatio.
How much max durability drops each repair. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: XiuLiJiangNaiJiuShangXianRatio.
Damage players deal to structures (raid damage). Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: GongJiJianZhuDamageRatio. MULTIPLIER, not a toggle.
Player melee damage to buildings. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: WanJiaHitJianZhuShangHaiRatio.
Damage wildlife deals to structures. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: YeShengHitJianZhuShangHaiRatio. Default 4 (GHOSTCAP).
Cap on structures within a radius. Whole number. Pinyin key in the file: JianZhuAroundNumLimit.
Per-hit damage cap on buildings. Whole number. Pinyin key in the file: JianZhuBeDamageLimit.
Build height ceiling. Whole number. Pinyin key in the file: JianZhuGaoDuLimit.
TOGGLE: ghost preview display. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: JianZhuMirageKaiGuan.
TOGGLE: enable enhanced teleport doors. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: JianZhuChuanSongMenPlusKaiGuan. KaiGuan = toggle. Default 0.
Teleporter limit. Whole number. Pinyin key in the file: MaxChuanSongMenNumber.
TOGGLE: structures regenerate HP over time. Toggle (1=on | 0=off) — an on/off switch, not a multiplier. Pinyin key in the file: KaiQiJianZhuHuiXueBuilding. Toggle ('KaiQi'=enable). Default 1.
TOGGLE: shield structures within campfire/territory. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: ProtectJianZhuInYingHuoSwitch.
TOGGLE: platforms block/affect navigation. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: PingTaiAffectNavigation.
Build radius from platforms. Whole number. Pinyin key in the file: PingTaiBuildRangeLimit.
Structures allowed per platform. Whole number. Pinyin key in the file: PingTaiJianZhuNumLimit.
Global scaler for platform building cap. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: MaxPingTaiJianZhuNumMul.
Resource nodes won't respawn this close to players. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: WanJiaZiYuanJinShuaBanJing.
Resource nodes won't respawn this close to buildings. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: JianZhuZiYuanJinShuaBanJing.
Fuel burn rate for campfires. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: YingHuoRanShaoSuDuRatio.
Personal territory-marker cap. Whole number. Pinyin key in the file: MaxGenRenYingHuoNumber.
Guild territory-marker cap. Whole number. Pinyin key in the file: MaxGongHuiYingHuoNumber.
TOGGLE: disregard enemy structures inside your territory. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: IgnoreEnemyJianZhuInSelfYingHuo.
TOGGLE: link doors across territories. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: TransDoorInterworkKaiGuan.
Converter station limit. Whole number. Pinyin key in the file: MaxConvertCount.
Conveyor limit. Whole number. Pinyin key in the file: MaxConveyorCount.
Ground-spike/trap limit. Whole number. Pinyin key in the file: MaxDiCiCount.
Powered mine limit. Whole number. Pinyin key in the file: MaxDongLiKuangChangCount.
TOGGLE: craft/pull from nearby containers. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: MakeUseAroundRongQiKaiGuan.
TOGGLE: outsiders may use your crafting stations. Toggle (0=no | 1=yes) — an on/off switch, not a multiplier. Pinyin key in the file: YunXuOtherDaKaiGongZuoTai. Toggle by meaning. Default 0.
TOGGLE: outsiders may open your chests. Toggle (0=no | 1=yes) — an on/off switch, not a multiplier. Pinyin key in the file: YunXuOtherDaKaiXiangZi. Toggle by meaning. Default 0.
TOGGLE: restrict container access to tribe in PVE. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: PVEOnlyTongGuiShuCanOpenKaiGuan. KaiGuan = toggle. Default 1.
TOGGLE: shared tribe storage access. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: ZuRenDirectCunQu.
TOGGLE: tribe duplication permission. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: ZuRenFuZhi.
TOGGLE: whether blueprint ship builds cost resources. Toggle (0=free | 1=consume) — an on/off switch, not a multiplier. Pinyin key in the file: ShipBlueprintBuildConsumeSwitch.
Dormitory/berth capacity. Whole number. Pinyin key in the file: MaxXiuMianCangCount.
Range to bind/use a respawn bed. Whole number. Pinyin key in the file: XiuMianDistance.
Expiry for inactive respawn points. Whole number. Pinyin key in the file: XiuMianOfflineDays. Default 7 confirmed 2 sources.
Invasions / Raids
The tribe-invasion (raid) system — the master toggle RuQinKaiGuan plus scale/intensity multipliers.
TOGGLE: master switch for tribe invasions. Toggle (1=on | 0=off) — an on/off switch, not a multiplier. Pinyin key in the file: RuQinKaiGuan. KaiGuan = toggle. Default 1.
TOGGLE: unscheduled invasions. Toggle (1=on | 0=off) — an on/off switch, not a multiplier. Pinyin key in the file: SuiJiRuQinKaiGuan. KaiGuan = toggle. Default 1.
Overall invasion size. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: RuQinGuiMoXiShu. MULTIPLIER ('XiShu'=coefficient), NOT a toggle despite suffix similarity.
Invasion difficulty. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: RuQinQiangDuXiShu. MULTIPLIER.
Lower bound on total invaders. Whole number. Pinyin key in the file: RuQinGuaiCountMin. Default 8 (GHOSTCAP).
Upper bound on total invaders. Whole number. Pinyin key in the file: RuQinGuaiCountMax. Default 128 (GHOSTCAP).
Lower bound per wave. Whole number. Pinyin key in the file: RuQinPerBoGuaiMin. Default 3 (GHOSTCAP).
Upper bound per wave. Whole number. Pinyin key in the file: RuQinPerBoGuaiMax. Default 16 (GHOSTCAP).
Scales invader level. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: RuQinGuaiLevelXiShu. MULTIPLIER.
Earliest in-game hour invasions can begin. Whole number. Pinyin key in the file: RuQinBeginHour. Default 0.
Latest in-game hour invasions run. Whole number. Pinyin key in the file: RuQinEndHour. Default 24.
Length of pre-invasion scouting. Whole number. Pinyin key in the file: TanChaMinuteLimit. Default 20 (GHOSTCAP).
Length of the assault phase. Whole number. Pinyin key in the file: JinGongMinuteLimit. Default 90 (GHOSTCAP).
Cooldown between invasions. Whole number. Pinyin key in the file: LengQueMinuteLimit. Default 1440 (=24h) (GHOSTCAP).
Daily invasion cap. Whole number. Pinyin key in the file: RuQinMaxChangCiCount. Default 2 (GHOSTCAP).
Building burn damage during invasions. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: RuQinShaoChengXiShu. Default 0.6 (GHOSTCAP).
Slaughter intensity during invasions. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: RuQinTuShaXiShu. Default 0.3 (GHOSTCAP).
Reward boost for repelling an invasion. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: RuQinSucceedPrizeTimes.
TOGGLE: invasions in management mode. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: ManageModeRuQin.
Countdown scaling in management mode. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ManageModeRuQinCountDownTimeRatio.
Time / Day Length & World
Day length, day/night split, and world regrowth rates. GameWorldTimePower (default 24) sets how long a full day takes; GameWorldDayTimePortion (default 0.7) is the share of that day that is daytime.
Share of the day/night cycle spent in daylight. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: GameWorldDayTimePortion. Exact stored default 0.6999999881 (float). GHOSTCAP.
Day-length scalar; 24 ≈ 1 real hour per in-game day. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: GameWorldTimePower. Default 24 confirmed 2 sources. SDK dump notes 24 = 1 real hr/day.
Crop maturation speed. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ZuoWuShengZhangRatio.
Fertilizer use rate. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ZuoWuFeiLiaoXiaoHaoRatio.
Crop water use rate. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ZuoWuShuiXiaoHaoRatio.
How fast crops wither. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ZuoWuXiaoHuiRatio.
Hits needed to deplete a node. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ZiYuanShengMingRatio.
Tree/plant regrowth speed. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: ZhiBeiChongShengRatio.
Food/perishable decay speed. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: WuPinFuHuaiRatio.
Time before loose items disappear. Whole number. Pinyin key in the file: WuPinXiaoHuiTime.
Guild / Tribe Limits
Tribe (guild) size and related caps. GongHuiMaxMember can also be set with the -GongHuiMaxMember launch flag — keep the two consistent.
Tribe size cap. NOTE: also settable via launch flag -GongHuiMaxMember. Whole number. Pinyin key in the file: GongHuiMaxMember. Default ~50; also a startup flag.
Tribe-wide animal cap. Whole number. Pinyin key in the file: GongHuiMaxDongWuCount. Default 50 (GHOSTCAP).
Tribe special-animal cap. Whole number. Pinyin key in the file: GongHuiMaxSpecDongWuCount.
Tribe-wide recruit cap. Whole number. Pinyin key in the file: GongHuiMaxZhaoMuCount. Default 50 (GHOSTCAP).
Tribe raft slots. Whole number. Pinyin key in the file: GongHuiMaxRaftSpaceCount.
Tribe special raft slots. Whole number. Pinyin key in the file: GongHuiMaxSpecRaftSpaceCount.
Tribe map-marker cap. Whole number. Pinyin key in the file: GongHuiBiaoJiMaxCount.
TOGGLE: cross-server/cluster functionality. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: KaiQiKuaFu. Toggle ('KaiQi'=enable). Default 0.
Spawning, AI & Awareness
Enemy AI level and the day-by-day awareness ramp. The per-day awareness ceilings are single-source with unverified defaults — they carry a ⚠ verify badge and default to 0.
Overall AI aggressiveness/skill tier. Whole number. Pinyin key in the file: AIDengJi.
TOGGLE: machine combat units. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: JiQiChuZhanKaiGuan.
Baseline enemy alertness for new players. Whole number. Pinyin key in the file: InitialDefaultAwarenessLevel.
Awareness ceiling on day 1. Whole number. Pinyin key in the file: FirstDayMaxAwarenessLevel.
Awareness ceiling on day 2. Whole number. Pinyin key in the file: SecondDayMaxAwarenessLevel.
Awareness ceiling day 3. Whole number. Pinyin key in the file: ThirdDayMaxAwarenessLevel.
Awareness ceiling day 4. Whole number. Pinyin key in the file: FourthDayMaxAwarenessLevel.
Awareness ceiling day 5. Whole number. Pinyin key in the file: FifthDayMaxAwarenessLevel.
Awareness ceiling day 6. Whole number. Pinyin key in the file: SixthDayMaxAwarenessLevel.
Awareness ceiling day 7. Whole number. Pinyin key in the file: SeventhDayMaxAwarenessLevel.
Awareness ceiling day 8. Whole number. Pinyin key in the file: EighthDayMaxAwarenessLevel.
Awareness ceiling day 9. Whole number. Pinyin key in the file: NinthDayMaxAwarenessLevel.
Awareness ceiling day 10 and beyond. Whole number. Pinyin key in the file: TenthDayMaxAwarenessLevel.
TOGGLE: special boss spawns. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: SpecialBossSwitch.
TOGGLE: boss death rewards/events. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: BossDeathEventSwitch.
TOGGLE: dungeon mobs respawn. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: DungeonReborn.
TOGGLE: developer debug overlay — leave off. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: DrawDebugDungeon.
Exploration & World Events
Ruins and tribal exploration events.
TOGGLE: ruins exploration rewards. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: RuinsExplorationKaiGuan.
TOGGLE: tribal exploration events. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: TribalExplorationKaiGuan.
TOGGLE: tribal transport feature. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: TribalTransportSwitch.
TOGGLE: relic chest spawns. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: RelicChestEventSwitch.
TOGGLE: new-player guide quests. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: IsOpenGuideTask.
TOGGLE: boss intro cutscene. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: IsPlayBossAppearanceSequence.
Special Events (regional)
Regional / seasonal special-event settings. These come from the SDK dump without confirmed defaults — verify against a generated file before relying on them.
TOGGLE: master switch for special events. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: SpecialEventConfigSwitch.
Event window start, Asia. Whole number. Pinyin key in the file: SpecialEventAsiaStartTime.
Event window end, Asia. Whole number. Pinyin key in the file: SpecialEventAsiaEndTime.
Event window start, Europe. Whole number. Pinyin key in the file: SpecialEventEuropeStartTime.
Event window end, Europe. Whole number. Pinyin key in the file: SpecialEventEuropeEndTime.
Event window start, America. Whole number. Pinyin key in the file: SpecialEventAmericaStartTime.
Event window end, America. Whole number. Pinyin key in the file: SpecialEventAmericaEndTime.
Days after launch before events start. Whole number. Pinyin key in the file: SpecialEventServerOpenDay.
Cooldown between events. Whole number. Pinyin key in the file: SpecialEventTriggerInterval.
Probability of triggering an event. Multiplier — 1.0 is the vanilla rate; higher is more/faster, lower is less/slower. Pinyin key in the file: SpecialEventTriggerPercent.
Cap on event triggers (note: 'Trigget' is the real misspelled key). Whole number. Pinyin key in the file: SpecialEventTriggetLimitNum.
Distance check for event proximity. Whole number. Pinyin key in the file: SpecialEventGameDist.
Performance / Optimization
Server-side physics and optimization toggles. Leave these at default unless you have a specific performance reason.
TOGGLE: reduce server load from movement. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: MovementYouHua. Toggle by meaning. Default 1 (GHOSTCAP).
TOGGLE: physics LOD optimization. Toggle (1=on | 0=off) — an on/off switch, not a multiplier. Pinyin key in the file: WuLiYouHuaKaiGuan. KaiGuan = toggle. Default 1.
Range at which physics simplifies. Whole number. Pinyin key in the file: WuLiYouHuaDist. Default 6666 (GHOSTCAP).
TOGGLE: optimization flag for interaction tracing. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: HuDongExcludeBetweenCameraCharacter.
TOGGLE: inventory network optimization. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: BagRepOptimizeSwitch.
TOGGLE: mask repair/upgrade feature. Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: MaskRepairUpgradeSwitch.
TOGGLE: unlimited build via menu (creative-ish). Toggle (0=off | 1=on) — an on/off switch, not a multiplier. Pinyin key in the file: OpenEscMenuInfJianZao.
Miscellaneous / Debug
Leftover and debug keys. XiShuWeiLing is a debug switch that zeroes every coefficient — do not enable it on a live server.
DEBUG TOGGLE: resets all coefficients to zero — do NOT enable on a live server. Toggle (0=normal | 1=zero all) — an on/off switch, not a multiplier. Pinyin key in the file: XiShuWeiLing.
Controls an info-input behavior mode. Mode index (integer). Pinyin key in the file: XinXiLuRu.
Server-process settings — everything below is a launch flag on the server executable, not an entry in GameXishu.json. These feed the start_server.bat / start_server.sh tabs. The server name, ports, player cap and passwords all live here.
Start Script & Launch Flags
The script wraps WSServer-Win64-Shipping.exe (Windows) or StartServer.sh (Linux) with the boot-time flags. -server and -forcepassthrough are required. -pve/-pvp picks the base ruleset. Game port 8777/UDP and query port 27015/UDP must both be open — the query port is the usual culprit when a server won't appear in the browser.
The name shown in the server browser, passed as -SteamServerName. This is the server-process name and is separate from anything in GameXishu.json.
UDP game port players connect on, passed as -Port. Default 8777. Must be open in your firewall. Change it only if you run multiple servers on one box (give each its own port set).
UDP Steam query port, passed as -QueryPort. Default 27015. The server browser reads your name and player count through this — if it's closed, the server often won't list even though players can connect directly. Open it.
Telnet/echo console port, passed as -EchoPort. Default 18888. Used for the remote console — restrict it to localhost or your admin IP; don't expose it publicly.
Player cap, passed as -MaxPlayers. Higher counts lean harder on the host. (The documented launch command uses 60; 50 is a sensible everyday default — set whatever your box can carry.)
The base ruleset flag: -pve (no open player-vs-player damage) or -pvp. This is how game mode is actually chosen — separate from the GameXishu.json 0/1/2 blocks. Picks exactly one of the two flags in the script.
Server join password, passed as -PSW. Leave blank for an open server. If set, players must enter it to connect.
Admin password, passed as -adminpsw. Grants GM/admin rights in-game. Set a strong one — anyone with it controls the server. Leave blank to disable admin login.
Autosave period in seconds, passed as -saving. Default 300 (5 minutes). Lower it for less rollback on a crash; very low values cost performance.
Backup period in seconds, passed as -backup. Default 900 (15 minutes). Writes a recoverable snapshot on this cadence.
Maximum tribe (clan) size, passed as -GongHuiMaxMember. This can also be set inside GameXishu.json (the GongHuiMaxMember key under Guild / Tribe Limits) — keep the two consistent to avoid confusion.
Runs steamcmd +app_update (app 3017310 Windows / 3017300 Linux) before each launch so the server pulls the latest build. Requires steamcmd on PATH or beside the script.
Wraps the launch in a loop so the server comes back automatically after a crash or planned restart. Recommended for unattended servers.
About the Soulmask Server Config Generator
Soulmask (Qooland Games, 2026) is an unusually awkward survival game to self-host, for one specific reason: its gameplay config file, GameXishu.json, is written in romanized Chinese (pinyin) and wrapped in a three-block structure that almost nobody understands at a glance. Keys like ShiWuXiaoHaoRatio (food consumption) and HuXIangShangHaiKaiGuan (friendly fire) give no hint of their meaning, and the file repeats every setting three times. This generator is the clean English front-end: you tune readable sliders and toggles, and it writes a correct GameXishu.json — and a matching start script — in the exact on-disk format. Outbound reference: the Soulmask dedicated server setup guide.
The three blocks: 0, 1 and 2 (and why we write all three)
Open a real GameXishu.json and you find a JSON object with three child objects keyed "0", "1" and "2", each holding the complete set of settings. So every value lives in the file three times. The honest truth is that what those keys mean is undocumented and disputed — the running consensus among admins is that no one is certain which set the server actually reads, and they look like difficulty or preset slots rather than the tribe/survival/warrior game modes (game mode is chosen separately by the -pve/-pvp launch flag and the in-game picker). What is confirmed, by multiple host knowledge-bases and admins holding the file, is the reliable workaround: set every value identically across all three blocks and your settings apply no matter which block is authoritative. One admin found only block "1" took effect; another confirmed setting all three to the same value just works. So that is exactly what this tool does — you fill one form, it stamps your values into 0, 1 and 2. We deliberately do not dress the three blocks up as game modes, because the sources don't support that.
Toggles vs multipliers — the trap that breaks configs
Soulmask's keys follow a naming convention that is easy to miss. Anything ending in KaiGuan (or Switch) is a boolean toggle — 0 for off, 1 for on. Anything ending in Ratio, Mul or XiShu (coefficient) is a multiplier. Get them backwards and the server either ignores the value or behaves bizarrely. The headline example is HuXIangShangHaiKaiGuan: it is the friendly-fire switch, not a damage multiplier, and people set it to 2.0 expecting double damage. There are sneakier ones: TeShuDaoJuDropXiShuJiaChengKaiGuan contains XiShu yet ends in KaiGuan, so it is a toggle; and the pair JianZhuFuLanKaiGuan (decay on/off) plus JianZhuFuLanMul (how fast it decays) looks like one setting but is two. This generator renders each one as the correct input type — a switch for toggles, a number for multipliers — so you physically can't enter the wrong kind of value.
English labels, with the pinyin key shown
Every setting in the form has a plain English label and, right beside it, the exact pinyin key as it appears in the file (e.g. ExpRatio, RuQinKaiGuan). That dual display is deliberate: the English tells you what the setting does, and the pinyin lets you find the same line in your own GameXishu.json or cross-check against another guide. Translations were reconciled across a community-translated settings list, the game's own UE4 SDK dump, and several host knowledge-bases — and where a single source disagreed (or where a popular list was simply wrong, like calling the climbing toggle "Punishment"), we sided with the SDK dump and noted it.
Server name, ports and the start script
A common confusion: the server's name, ports, player cap and passwords are not in GameXishu.json. They are launch flags on the server executable. The Start Script tab builds both a Windows .bat and a Linux .sh that run the server with the right arguments — -SteamServerName, -Port (8777), -QueryPort (27015), -EchoPort (18888), -MaxPlayers, -PSW (join password), -adminpsw, -pve/-pvp for the ruleset, -saving (autosave, 300s) and -backup (900s) — plus the mandatory -server and -forcepassthrough, and an optional SteamCMD update line. It installs from app 3017310 (Windows) / 3017300 (Linux) — not the game's app id 2646460 — and it omits the deprecated -gamedistindex region flag, which was superseded at 1.0.
Edit while stopped — and other footguns
The big one: a running Soulmask server silently overwrites GameXishu.json from memory, so any edit you make while it's up is discarded on the next save. Always stop the server, edit, then start. The file also doesn't exist until the first launch, so generate it once by booting the server before you try to replace it. Editing through the in-game GM/admin panel writes to the live config too and will clobber file edits — pick one method. And GongHuiMaxMember (tribe size) can be set both in the file and via the -GongHuiMaxMember launch flag, so keep the two consistent.
How complete is this, and what's flagged?
This tool exposes the full reconciled setting set — well over 250 keys across 17 categories — not just the popular dozen. Where a key, translation, type or default is single-source or inferred rather than confirmed against a freshly generated 1.0 file, it carries a ⚠ verify badge: that includes the day-by-day enemy-awareness ramp (whose defaults are unconfirmed and default to 0 here), several obscure building caps, the regional special-event block, and one "information input mode" key whose meaning is genuinely uncertain. We also deliberately left things out: a couple of keys that float around in scraped lists but don't actually exist in the game, plus the deprecated -gamedistindex flag. If you confirm or correct any flagged value on your own server, hit the ⚠ Report an issue button so we can tighten the page. Paste an existing GameXishu.json back in and import carries through any keys this tool doesn't model, so a round-trip never silently drops settings.
More GamesOMG server tools
- Windrose Server Config Generator — another multi-file survival config with a fiddly nested format
- V Rising Server Config Generator — multi-JSON server settings
- Conan Exiles Server Config Generator — Unreal INI + start-script pattern
- All GamesOMG generators