FAQs

This document is designed to provide detailed answers regarding Soulmask game server management. It covers server configuration, saves, modding, connectivity, admin tools, and more.

🔢 What version of Soulmask is running on my server?

By default, your Soulmask server is always updated to the latest stable version. Downgrading or selecting previous versions is not supported.

⚙️ How do I configure my Soulmask server?

Soulmask uses two main configuration files:

• Engine.ini: Found at /Server/WS/Saved/Config/WindowsServer/Engine.ini. Controls overall server behavior.
• GameXishu.json: Located at /Server/WS/Saved/GameplaySettings/GameXishu.json. This handles gameplay-related settings similar to sandbox tuning. To modify the sandbox (coefficient as the game calls it), edit this file or use Admin panel in-game.

⚠️ Engine.ini must be edited through the Config Manager. Manual changes via FTP or File Manager will be reverted on server restart.

🗂️ What do the configuration categories in GameXishu.json mean?

The config file uses numeric sections "0", "1", and "2", likely representing different game modes (e.g., official, custom, PvE). Inside these, settings are categorized as follows:

• Here’s a breakdown of what the values represent:

   

• 🔢 Sections: "0", "1", "2"

• These are likely different server modes, possibly:

• "0" = Official/default

• "1" = Custom or restricted

• "2" = PvE-focused or event

   

• 📘 GENERAL CATEGORIES:

• 📈 EXP & GROWTH

• ExpRatio: Base experience multiplier

• ChengZhangExpRatio, MJExpRatio, ShuLianDuExpRatio, etc.: Different types of EXP gains (growth, job, skill)

• MaxLevel: Maximum character level (set to 60)

• ZuoWuShengZhangRatio, DongWuShengZhangRatio: Crop/animal growth speed

   

• 💎 RESOURCE & DROP RATIOS

• CaiJiDiaoLuoRatio, FaMuDiaoLuoRatio, CaiKuangDiaoLuoRatio: Drop rates for gathering, lumber, mining

• BossRenDiaoLuoRatio, JingYingRenDiaoLuoRatio, PuTongRenDiaoLuoRatio: Loot drop ratios for different NPC types

• BaoXiangDropRatio: Chest drop rate

• ZuoWuDropRatio: Crop yield rate

• TeShuDaoJuDropXiShuJiaChengKaiGuan: Special item drop boost toggle

   

• ⚔️ COMBAT & DAMAGE

• DamageYeShengRatio, BeDamageByYeShengRatio: Wild monster damage given/received

• PVP_ShangHaiRatio_*: PvP damage ratios (melee, ranged, player-to-player)

• HuXIangShangHaiKaiGuan: Mutual damage toggle (PvP friendly fire)

• WanJiaHitJianZhuShangHaiRatio: Player damage to buildings

• YeShengHitJianZhuShangHaiRatio: Wild animals damaging buildings

• RollingInvincibleTimeRatio: Roll/dodge invincibility duration

   

• 🧍‍♂️ NPC & CREATURE LIMITS

• GongHuiMaxDongWuCount, GeRenMaxDongWuCount: Guild/personal animal max

• GongHuiMaxSpecDongWuCount: Guild limit for special animals

• AnimalFollowerMaxCount: Max companions

• ManRenChuZhanCount: Deployed humanoid ally count

   

• 🧱 BUILDINGS

• JianZhuFuLanMul, JianZhuXiuLiMul: Building damage & repair modifiers

• JianZhuGaoDuLimit: Max building height

• JianZhuMirageKaiGuan: Illusion buildings toggle

• KaiQiJianZhuHuiXueBuilding: Health-regenerating buildings enabled

   

• 🔄 RESPAWN & REVIVE

• FuHuoMoveSiWangBaoKaiGuan: Respawn-on-move toggle

• ZhiBeiChongShengRatio: Resurrection ratio

   

• ⏰ WORLD TIME

• GameWorldDayTimePortion: Fraction of day that's daylight (0.7 = 70%)

• GameWorldTimePower: Game day duration multiplier

   

• 🛡️ RAID / INVASION

• RuQinKaiGuan: Enable invasion mode

• RuQinGuaiCountMin/Max: Min/max invader count

• RuQinBeginHour/EndHour: Time window for invasions

• RuQinShaoChengXiShu, RuQinTuShaXiShu: Raid penalties/modifiers

   

• 🗺️ EXPLORATION & EVENTS

• TribalExplorationKaiGuan, RuinsExplorationKaiGuan: Exploration toggles

• SpecialEventSwitch, BossDeathEventSwitch, etc.: Control event types

• SpecialEventTriggerInterval: Time between possible event triggers

• SpecialEventTriggerPercent: Chance of event occurring

• SpecialEventTriggetLimitNum: Max active events at once

   

• ⚙️ CRAFTING, REPAIR, ITEM DECAY

• ZhiZuoTimeRatio: Crafting time modifier

• WuPinFuHuaiRatio, WuPinXiaoHuiTime: Item decay rate & destruction timer

• XiuLiXuYaoCaiLiaoRatio: Repair material cost ratio

   

• 💼 INVENTORY & LIMITS

• RoleBagCapacity: Inventory slots

• MaxFuZhongRatio: Max weight capacity ratio

• GeRenBiaoJiMaxCount, GongHuiBiaoJiMaxCount: Max map markers

   

• 🏹 PvP CONTROLS

• HuXIangShangHaiKaiGuan: Friendly fire

• PlayerYouFangShangHaiKaiGuan, YouFangShangHaiKaiGuan: Damage among same group

• KaiQiKuaFu: Cross-server PvP toggle

• WarKaiGuan: PvP war events enabled

   

• 💬 SOCIAL / GUILD

• GongHuiMaxMember: Max guild members

• GeRenMaxZhaoMuCount, GongHuiMaxZhaoMuCount: Max summon/recruit count

• TransDoorInterworkKaiGuan: Cross-area teleport

   

• 🌍 ENVIRONMENT

• XiuMianDistance, HuanXingDistance: Sleep/wake proximity

• WuLiYouHuaKaiGuan: Physics optimization switch

• MovementYouHua: Movement optimization switch

   

• 🟢 KEY DIFFERENCES AMONG "0", "1", "2"

• Some toggles are off in "1" or "2" (e.g. JianZhuChuanSongMenPlusKaiGuan)

• "1" has fewer deployable allies (ManRenChuZhanCount = 1 instead of 3)

• "1" and "2" both set ConverPropsSpeedRatio to 5 (possibly speeding up some process), while "0" uses 1

• "1" has fewer special animals allowed than "0" or "2"

Repeat: The only way to modify the sandbox (coefficient as the game calls it) is through Admin panel in-game

💾 How are saves handled?

Saves are stored at:
/Server/WS/Saved/Worlds/Dedicated/Level01_Main/world.db

You can upload a single-player save or one from another host by:

1. Stopping the server.
2. Deleting the existing world.db.
3. Replacing it with your backed-up save.

To save manually in-game (as an admin), use:

gm BaoCun

🔑 How do I become an admin?

1. Press the tilde ~ key (twice to expand console, layout must be set to English).

2. Use the command:

   gm key <admin password=""></admin>

3. The password is defined in the Basic Settings panel.

🔒 How do I ban or unban a player?

After becoming admin:

• To ban:

  gm AddServerPermissionList 1 <steamid64></steamid64>

• To unban:

  gm RemoveServerPermissionList 1 <steamid64></steamid64>

💬 What admin commands are available?

🧩 How do I install mods?

• Add Steam Workshop mod IDs to the Mods variable in Basic Settings.

• Separate each ID with a comma and no spaces, e.g.:

  3325034091,3400177243

• Players must also install and activate the mods via their in-game Mods menu to connect.

🌐 How do I connect to the server?

There are two ways to join a Soulmask server:

1. Direct Connect:
   Use the server's IP and port to connect directly.
2. Server List (via "Invitation Code" field):
   Open the in-game server browser and enter your server's exact name into the "Invitation Code" field in the top-right corner.
   This will search for and display your specific server, even if it's not publicly listed.

✅ Make sure the server name matches what you set in the Basic Settings.

📄 Can I customize config files via FTP?

Not directly. Edits to Engine.ini must be made via the Config Manager, or they'll revert on restart.

🛠️ Can I upload a save from another server?

Yes. Upload a compatible world.db file to:

/Server/WS/Saved/Worlds/Dedicated/Level01_Main/

Then restart the server to load the save.

Can I use RCON on this server?

Yes, RCON is compatible with Pingplayers Soulmask servers. It's required to whitelist the IP source that will connect through RCON in the a line for Engine.ini and restarting the server. Then, IP:RCON PORT and RCON password can be used to connect and use commands. Multiple IPs can be added if multiple players want to use RCON to issue commands (do not remove the first IP=179.19.0.1 line)

[Server.SafeIP]
IP=179.19.0.1
IP=YOUR PUBLIC IP 1
IP=YOUR PUBLIC IP 2

⚠️ Known Issues

• Admin console only works with English keyboard layout.
• Incorrectly edited config files will revert or may prevent startup.
• Mods not installed client-side will result in connection failure.
• Admin commands are case-sensitive and spacing-sensitive.