background image

Soulmask Server Setup Guide - Base de Conhecimento

  1. Suporte
  2. Base de Conhecimento
  3. Soulmask
  4. Soulmask Server Setup Guide
Base de Conhecimento Abrir Chamado Chamados Abertos
Game Servers 380 7 Days to Die 4 Abiotic Factor 2 Aloft 2 alt:V 2 Americas Army Proving Grounds 2 Among Us 2 Archean 2 ARK Survival Ascended 6 ARK Survival Evolved 3 Arma 3 3 Arma Reforger 2 Aska 2 AssaultCube 2 Assetto Corsa 3 Astro Colony 2 Astroneer 2 Automobilista 2 2 Avorion 2 Banana Shooter 2 Barotrauma 3 BATTALION Legacy 2 BeamNG.drive (BeamMP) 2 Black Mesa 2 Brickadia 2 Call of Duty 2 Citadel: Forged with Fire 2 ClassiCube 2 Clone Hero 2 Colony Survival 2 Conan Exiles 4 Contagion 2 Core Keeper 2 Counter-Strike 2 3 Craftopia 2 CryoFall 2 CS2D 2 Cube 2: Sauerbraten 2 Cubic Odyssey 2 DayZ 4 DDNet 2 DDRaceNetwork 2 Dead Matter 2 Dont Starve Together 4 Eco 2 Empyrion Galactic Survival 2 Enshrouded 3 Escape from Tarkov 2 Euro Truck Simulator 2 2 Factorio 2 Farming Simulator 25 2 Fistful of Frags 2 FiveM 3 FortressCraft Evolved 2 Foundry 2 Foundry VTT 2 Frozen Flame 2 FTL Tachyon 2 Garrys Mod 3 Ground Branch 2 Half-Life 2 Deathmatch 2 Hogwarp 2 Holdfast: Nations at War 2 HumanitZ 2 Hurtworld 2 Hytale 1 Icarus 2 Insurgency Sandstorm 2 IOSoccer 2 Just Cause 3 Multiplayer 2 Kerbal Space Program 2 Killing Floor 2 3 LeagueSandbox 2 Left 4 Dead 2 Left 4 Dead 2 3 Longvinter 2 Los Angeles Crimes 2 Medal of Honor 2 Midnight Ghost Hunt 2 Mindustry 2 Minecraft 4 Minetest 2 Modiverse 2 Mordhau 3 Mount & Blade II: Bannerlord 2 Myth of Empires 2 Nazi Zombies Portable 2 Necesse 2 NeosVR 2 Neverwinter Nights EE 2 Night of the Dead 2 Nightingale 2 No Love Lost 2 No More Room in Hell 2 No One Survived 2 Nova-Life Amboise 2 Nuclear Option 2 Onset 2 Open Fortress 2 OpenArena 2 OpenRA 2 OpenRCT2 2 OpenTTD 2 Operation Harsh Doorstop 2 Palworld 3 Path of Titans 2 Pavlov VR 3 PixARK 2 Plains of Pain 2 Portal Knights 2 Post Scriptum 2 Project Zomboid 8 Puck 2 Quake Live 2 R5Reloaded 2 RedM 2 Renown 2 Resonite 2 Return to Moria 2 Rimworld Together 2 Rising World 2 Risk of Rain 2 1 Rust 4 Satisfactory 1 SCP Secret Laboratory 3 SCUM 2 Smalland 2 Solace Crafting 2 Soldat 2 Soldat 2 2 Sonic Robo Blast 2 2 Sons of the Forest 2 Soulmask 2 SourceCoop 2 Space Engineers 3 Space Station 14 2 Squad 3 Starbound 3 StarMade 2 Stationeers 2 Stormworks 2 Subnautica Nitrox 2 Sunkenland 2 SuperTuxKart 2 Sven Co-op 2 Swords 'n Magic and Stuff 2 Team Fortress 2 3 Teeworlds 2 Terraria 3 TerraTech Worlds 2 TF2 Classified 2 The Forest 3 The Front 2 The Isle 2 Tower Unite 2 Trackmania 2 Unturned 4 Urban Terror 2 V Rising 3 Valheim 3 VEIN 2 Veloren 2 Vintage Story 3 Voyagers of Nera 2 Wolfenstein: Enemy Territory 2 Wreckfest 2 Wurm Unlimited 2 Xonotic 2 Zandronum 2 Getting Started 2 Network & Connectivity 1 Server Management 2
Suporte
Categorias

Soulmask Server Setup Guide

soulmask setup config survival 0 acharam isto útil
Disponível em: ESPAÑOL

This guide covers everything you need to set up and configure your Soulmask dedicated server on Legion Hosting, including first start, GPanel startup variables, server configuration, PvE vs PvP modes, map and world settings, connecting to your server, and save management. For admin setup and in-game commands, see Soulmask Admin Commands.

What Is Soulmask

Soulmask is an open-world survival crafting game where players awaken wearing a mysterious ancient mask that grants supernatural abilities. Set in a lush, expansive world, players must gather resources, craft tools and weapons, build settlements, and recruit and manage a tribe of NPCs. The mask system is central to gameplay -- players can possess and control different tribespeople, each with unique skills and traits, to optimize their settlement and combat effectiveness.

Key features of the dedicated server include:

  • Support for up to 70 concurrent players on a single server
  • PvE and PvP game modes with configurable rules
  • Extensive gameplay tuning through the GameXishu.json configuration file
  • Tribe (guild) system with configurable member limits
  • RCON and Telnet support for remote server management
  • Automatic backup and save management
Stop your server before editing any configuration files. Always stop your server from the Console tab in GPanel before editing configuration files. Changes made while the server is running may be overwritten or cause corruption.

First Start

When you first receive your Soulmask server from Legion Hosting, it needs to complete an initial installation before it can be played on.

  1. Log in to GPanel and select your Soulmask server from the server list.
  2. Click the Console tab and press Start.
  3. The server will download and install the Soulmask dedicated server files via Steam. This initial download can take several minutes as the game requires significant disk space.
  4. Once the download completes, the server will start automatically. The first boot takes longer than subsequent starts while the server generates the initial world database.
  5. Wait until the console output indicates the server is ready and listening for connections.
RAM requirements. Soulmask is a memory-intensive game. The dedicated server requires at least 11 GB of free RAM to start. Make sure your hosting plan provides sufficient memory for your expected player count. Higher player counts and larger worlds will use more RAM.

GPanel Startup Variables

Core server settings are configured as startup variables in GPanel. These values are passed to the server process as command-line parameters when it launches.

  1. In GPanel, select your Soulmask server.
  2. Click the Startup tab.
  3. Set the variables listed below. Changes take effect the next time you start or restart the server.
Variable Default Description
SERVER_NAME My Soulmask Server The name displayed in the Steam server browser and in-game server list. Make it descriptive so players can find your server easily.
SERVER_PASSWORD (empty) Password required for players to join (-PSW parameter). Leave empty for a public server. Set a password to restrict access to invited players only.
ADMIN_PASSWORD (empty) GM administrator password (-adminpsw parameter). Required to access the in-game admin panel and run admin commands. Keep this secret.
MAX_PLAYERS 60 Maximum number of simultaneous players (-MaxPlayers parameter). Soulmask supports up to 70 players, but higher counts require more RAM and CPU.
GAME_MODE pve Server game mode. Set to pve for PvE or pvp for PvP. See the PvE vs PvP section below.
GAME_PORT 8777 The primary UDP port for game connections (-Port parameter). Automatically configured by your hosting plan.
QUERY_PORT 27015 The UDP port used by Steam for server browser queries (-QueryPort parameter). Automatically configured.
Startup variables override config files. If a setting is configured both as a startup variable and inside a configuration file, the startup variable takes precedence. Use startup variables for core identity settings and configuration files for detailed gameplay tuning.

Server Configuration (Command-Line Parameters)

Soulmask uses extensive command-line parameters for server configuration. Below is the full reference of available parameters:

Parameter Default Description
-SteamServerName="Name" - Server display name in the server browser.
-MaxPlayers=N 60 Maximum concurrent player connections (up to 70).
-PSW="password" (none) Server join password. Omit for a public server.
-adminpsw="password" (none) Administrator/GM password for in-game admin commands.
-pve - Forces PvE mode. Players cannot damage each other.
-pvp - Forces PvP mode. Players can damage each other.
-Port=N 8777 Game connection port (UDP).
-QueryPort=N 27015 Steam query port (UDP).
-EchoPort=N 18888 Telnet console port (TCP, local only). Used for local remote management.
-saving=N - World state save interval to memory (in seconds).
-backup=N - In-memory database backup to disk interval (in seconds).
-initbackup - Creates a backup copy of the world each time the server starts.
-backupinterval=N - Automatic backup creation interval (in minutes).
-GongHuiMaxMember=N - Maximum number of members per tribe (guild).
-MULTIHOME=IP - Binds the server to a specific local IP address (multi-homed servers only).
-rconpsw="password" (none) Enables RCON remote console access with the specified password.
-rconport=N 19000 RCON listener TCP port. Only relevant if RCON is enabled.
-rconaddr=IP - RCON listener IP binding. Use 0.0.0.0 to listen on all interfaces.
-log - Enables console window and logging output.
-UTF8Output - Enables correct handling of non-Latin characters in output.
GPanel handles most of these automatically. On Legion Hosting, the essential parameters are configured through the GPanel Startup tab. Advanced parameters like RCON settings or tribe limits can be added through GPanel's additional startup parameters field if available, or by contacting support.

PvE vs PvP Mode

Soulmask supports two primary game modes that fundamentally change the multiplayer experience:

PvE Mode (-pve)

  • Players cannot damage each other directly.
  • Structures and bases are protected from other players.
  • Focus is on cooperative survival, building, and exploration.
  • Players can still interact, trade, and form tribes.
  • Recommended for cooperative communities and casual servers.

PvP Mode (-pvp)

  • Players can attack and kill each other.
  • Bases and structures can be raided and destroyed by other players.
  • Tribal warfare and territory control become core gameplay elements.
  • PvP damage ratios can be fine-tuned in the GameXishu.json configuration file.
  • Recommended for competitive servers and experienced players.
Mode cannot be changed without a wipe. Changing between PvE and PvP after the world has been created may cause gameplay inconsistencies. It is recommended to decide on a mode before your first start. If you need to change modes on an existing world, consider starting fresh.

Map and World Settings (GameXishu.json)

Detailed world and gameplay settings are controlled through the GameXishu.json configuration file. This file contains extensive options for tuning resource rates, combat, invasions, building, animals, and more.

Locating the File

The configuration file is located at:

WS/Saved/GameplaySettings/GameXishu.json

Access this file through the GPanel Files tab or via SFTP.

Key Settings Reference

Below are the most commonly adjusted settings. The parameter names are in their original format (Chinese pinyin). English descriptions are provided for each.

Experience and Progression
Setting English Name Description
ExpRatio Experience Ratio Multiplier for general experience gain. Higher values speed up leveling.
ChengZhangExpRatio Growth Experience Ratio Multiplier for character growth experience gain.
ShaGuaiExpRatio Monster Kill Experience Ratio Multiplier for experience gained from killing monsters.
Combat and Damage
Setting English Name Description
DongWuDamageRatio Animal Damage Ratio Multiplier for damage dealt by wild animals and creatures.
BeDamageByYeShengRatio Damage Taken from Wildlife Multiplier for damage received from wild creatures.
ShengMingHuiFuRatio Health Recovery Ratio Multiplier for natural health regeneration speed.
QiXiHuiFuRatio Stamina Recovery Ratio Multiplier for stamina recovery speed.
TiLiHuiFuRatio Energy Recovery Ratio Multiplier for energy/endurance recovery speed.
PVP_ShangHaiRatio_JinZhan PvP Melee Damage Ratio Multiplier for PvP melee combat damage (default: 0.4).
Resource and Consumption
Setting English Name Description
ShiWuXiaoHaoRatio Food Consumption Ratio Multiplier for how fast food is consumed. Lower values slow food consumption.
ShuiXiaoHaoRatio Water Consumption Ratio Multiplier for how fast water is consumed.
RanLiaoXiaoHaoRatio Fuel Consumption Ratio Multiplier for how fast fuel is consumed by crafting stations and fires.
Animal and Farming
Setting English Name Description
DongWuShengZhangRatio Animal Growth Ratio Multiplier for animal growth speed. Higher values make animals mature faster.
FanZhiJianGeRatio Breeding Interval Ratio Multiplier for time between animal breeding cycles.
DongWuChanChuRatio Animal Production Ratio Multiplier for animal production output (eggs, milk, etc.).
DongWuPinZhiRatio Animal Quality Ratio Multiplier for quality of tamed animal attributes.
ZuoWuShengZhangRatio Crop Growth Ratio Multiplier for crop growth speed.
ZuoWuFeiLiaoXiaoHaoRatio Crop Fertilizer Consumption Multiplier for fertilizer consumption rate.
Building and Structures
Setting English Name Description
JianZhuFuLanKaiGuan Building Decay Toggle Enable or disable building decay over time. Set to 0 to disable.
JianZhuFuLanMul Building Decay Multiplier Rate at which structures decay. Lower values slow decay.
JianZhuXiuLiMul Building Repair Multiplier Multiplier for building repair costs and speed.
JianZhuZiYuanJinShuaBanJing Building Resource Exclusion Radius Radius around buildings where natural resources will not respawn.
Invasion System
Setting English Name Default Description
RuQinGuaiCountMax Max Invasion Monsters 128 Maximum number of monsters in an invasion wave.
RuQinQiangDuXiShu Invasion Intensity - Controls overall invasion difficulty and monster strength.
RuQinBeginHour Invasion Start Hour - In-game hour when invasions can begin.
RuQinEndHour Invasion End Hour - In-game hour when invasions stop.
RuQinPerBoGuaiMax Max Monsters Per Wave 16 Maximum monsters spawned per individual wave.
Always stop your server before editing GameXishu.json. Editing the file while the server is running will result in your changes being overwritten when the server saves. Stop the server, make your changes, then start it again.

How to Connect

Players can connect to your Soulmask server through the in-game server browser or by direct connect.

Via In-Game Server Browser

  1. Launch Soulmask.
  2. From the main menu, select Multiplayer and then Server Browser.
  3. Search for your server by name (the name you set in the SERVER_NAME startup variable).
  4. Click on your server and press Join. Enter the password if one is set.

Via Steam Server Browser

  1. In Steam, go to View > Game Servers (or Servers).
  2. Click the Favorites tab and then Add a Server.
  3. Enter your server's IP and query port (default 27015) in the format IP:PORT.
  4. Once the server appears, double-click it to connect through Soulmask.

Via Direct Connect

  1. Find your server IP and game port from the GPanel Console tab. For help, see How to Find Your Server IP and Port.
  2. In Soulmask, look for the Direct Connect option in the multiplayer menu.
  3. Enter your server IP and game port (default 8777) in the format IP:PORT.
  4. Press Connect and enter the server password if required.
Server not appearing? If your server does not show up in the browser, ensure it is fully started and has finished loading. New servers may take 2-5 minutes to appear in Steam's master server list. You can always use direct connect with the IP and game port. Ports are randomly assigned unless you have a private IP.

Save Management

Soulmask uses a database-backed save system. Understanding how saves work is critical for avoiding data loss.

Save Location

The primary world save file is located at:

WS/Saved/Worlds/Dedicated/Level01_Main/world.db

This SQLite database contains all world data including terrain modifications, structures, NPC states, and player data.

Save Process

Soulmask uses a two-stage save process:

  1. Memory save (-saving): The world state is periodically written to an in-memory database at the interval specified by the -saving parameter (in seconds).
  2. Disk backup (-backup): The in-memory database is flushed to disk at the interval specified by the -backup parameter (in seconds).
Always shut down your server properly. It is vitally important that you shut down your server cleanly using the GPanel Stop button, the gm exit in-game command, or the shutdown RCON command. Force-killing the server process can cause the in-memory database to not be written to disk, resulting in rollbacks to the last disk save.

Automatic Backups

Configure automatic backups using these startup parameters:

  • -initbackup -- Creates a backup copy every time the server starts.
  • -backupinterval=N -- Creates rolling backups every N minutes during runtime.

Manual Backups

To create a manual backup:

  1. Stop the server from GPanel.
  2. Navigate to WS/Saved/ via the GPanel Files tab or SFTP.
  3. Download the following files:
    • Worlds/Dedicated/Level01_Main/world.db -- The world save database
    • GameplaySettings/GameXishu.json -- Your gameplay configuration
  4. Store these files safely on your local computer.

Restoring a Backup

  1. Stop the server.
  2. Upload the backed-up world.db file to WS/Saved/Worlds/Dedicated/Level01_Main/.
  3. Upload the backed-up GameXishu.json to WS/Saved/GameplaySettings/ if you want to restore settings as well.
  4. Start the server.

Starting a New World

To wipe the world and start fresh:

  1. Stop the server.
  2. Rename or delete the world.db file at WS/Saved/Worlds/Dedicated/Level01_Main/.
  3. Start the server. It will generate a new world database from scratch.
Back up before wiping. Before deleting world data, download a copy of world.db as a backup in case you want to restore it later.

Port Reference

Soulmask uses the following ports. These are automatically configured by your hosting plan on Legion Hosting.

Port Protocol Default Purpose
Game Port UDP 8777 Primary game connections. Players connect to this port.
Query Port UDP 27015 Steam server browser queries.
Echo Port (Telnet) TCP 18888 Local telnet administration (local connections only).
RCON Port TCP 19000 Remote console (RCON) access. Only active if -rconpsw is set.

Related Articles

Need Help?

If you are still having issues with your Soulmask server, please open a support ticket and our team will be happy to assist you.

Este artigo foi útil?
Ajude a Melhorar

Artigos Relacionados

Soulmask Admin Commands
This guide covers admin setup, in-game admin commands, RCON configuration, and server management com...
Voltar

Ready to Get Started?

The servers are booted, select your plan and become our latest satisfied client.