Deze gids behandelt alles wat je nodig hebt om je Soulmask dedicated server op Legion Hosting in te stellen en te configureren, inclusief eerste start, GPanel opstartvariabelen, serverconfiguratie, PvE vs PvP modi, kaart- en wereldinstellingen, verbinden met je server en opslagbeheer. Voor het instellen van beheerders en in-game commando's, zie Soulmask Beheerderscommando's.
Wat is Soulmask
Soulmask is een open-wereld survival crafting game waarin spelers ontwaken met een mysterieus oud masker dat bovennatuurlijke krachten verleent. In een weelderige, uitgestrekte wereld moeten spelers grondstoffen verzamelen, gereedschap en wapens fabriceren, nederzettingen bouwen en een stam van NPC's rekruteren en beheren. Het maskersysteem staat centraal in de gameplay -- spelers kunnen verschillende stamleden bezitten en besturen, elk met unieke vaardigheden en eigenschappen, om hun nederzetting en gevechtseffectiviteit te optimaliseren.
Belangrijkste functies van de dedicated server:
- Ondersteuning voor maximaal 70 gelijktijdige spelers op één server
- PvE en PvP spelmodi met configureerbare regels
- Uitgebreide gameplay-afstemming via het configuratiebestand
GameXishu.json - Stamsysteem (guild) met configureerbare ledenlimieten
- RCON- en Telnet-ondersteuning voor serverbeheer op afstand
- Automatische back-up en opslagbeheer
Stop je server voordat je configuratiebestanden bewerkt. Stop altijd je server via het tabblad Console in GPanel voordat je configuratiebestanden bewerkt. Wijzigingen die worden aangebracht terwijl de server draait, kunnen worden overschreven of corruptie veroorzaken.
Eerste start
Wanneer je je Soulmask server voor het eerst ontvangt van Legion Hosting, moet deze een eerste installatie voltooien voordat erop gespeeld kan worden.
- Log in bij GPanel en selecteer je Soulmask server uit de serverlijst.
- Klik op het tabblad Console en druk op Start.
- De server downloadt en installeert de Soulmask dedicated serverbestanden via Steam. Deze eerste download kan enkele minuten duren omdat het spel aanzienlijke schijfruimte vereist.
- Zodra de download is voltooid, start de server automatisch. De eerste keer opstarten duurt langer dan volgende starts terwijl de server de initiële werelddatabase genereert.
- Wacht tot de console-uitvoer aangeeft dat de server gereed is en luistert naar verbindingen.
RAM-vereisten. Soulmask is een geheugenintensief spel. De dedicated server vereist minimaal 11 GB vrij RAM om op te starten. Zorg ervoor dat je hostingpakket voldoende geheugen biedt voor je verwachte aantal spelers. Hogere spelersaantallen en grotere werelden zullen meer RAM gebruiken.
GPanel opstartvariabelen
Kernserverinstellingen worden geconfigureerd als opstartvariabelen in GPanel. Deze waarden worden als opdrachtregelparameters doorgegeven aan het serverproces wanneer het opstart.
- Selecteer in GPanel je Soulmask server.
- Klik op het tabblad Startup.
- Stel de onderstaande variabelen in. Wijzigingen worden van kracht de volgende keer dat je de server start of herstart.
| Variabele | Standaard | Beschrijving |
|---|---|---|
SERVER_NAME |
My Soulmask Server |
De naam die wordt weergegeven in de Steam server browser en in-game serverlijst. Maak deze beschrijvend zodat spelers je server gemakkelijk kunnen vinden. |
SERVER_PASSWORD |
(leeg) | Wachtwoord vereist voor spelers om deel te nemen (-PSW parameter). Laat leeg voor een openbare server. Stel een wachtwoord in om de toegang te beperken tot uitgenodigde spelers. |
ADMIN_PASSWORD |
(leeg) | GM-beheerderswachtwoord (-adminpsw parameter). Vereist om toegang te krijgen tot het in-game beheerderspaneel en beheerderscommando's uit te voeren. Houd dit geheim. |
MAX_PLAYERS |
60 |
Maximaal aantal gelijktijdige spelers (-MaxPlayers parameter). Soulmask ondersteunt maximaal 70 spelers, maar hogere aantallen vereisen meer RAM en CPU. |
GAME_MODE |
pve |
Serverspelmodus. Stel in op pve voor PvE of pvp voor PvP. Zie het gedeelte PvE vs PvP hieronder. |
GAME_PORT |
8777 |
De primaire UDP-poort voor spelverbindingen (-Port parameter). Automatisch geconfigureerd door je hostingpakket. |
QUERY_PORT |
27015 |
De UDP-poort die door Steam wordt gebruikt voor server browser-query's (-QueryPort parameter). Automatisch geconfigureerd. |
Opstartvariabelen overschrijven configuratiebestanden. Als een instelling zowel als opstartvariabele als in een configuratiebestand is geconfigureerd, heeft de opstartvariabele voorrang. Gebruik opstartvariabelen voor kernidentiteitsinstellingen en configuratiebestanden voor gedetailleerde gameplay-afstemming.
Serverconfiguratie (opdrachtregelparameters)
Soulmask gebruikt uitgebreide opdrachtregelparameters voor serverconfiguratie. Hieronder staat de volledige referentie van beschikbare parameters:
| Parameter | Standaard | Beschrijving |
|---|---|---|
-SteamServerName="Name" |
- | Weergavenaam van de server in de server browser. |
-MaxPlayers=N |
60 |
Maximaal aantal gelijktijdige spelersverbindingen (tot 70). |
-PSW="password" |
(geen) | Wachtwoord om deel te nemen aan de server. Laat weg voor een openbare server. |
-adminpsw="password" |
(geen) | Beheerder/GM-wachtwoord voor in-game beheerderscommando's. |
-pve |
- | Forceert PvE-modus. Spelers kunnen elkaar niet beschadigen. |
-pvp |
- | Forceert PvP-modus. Spelers kunnen elkaar beschadigen. |
-Port=N |
8777 |
Spelverbindingspoort (UDP). |
-QueryPort=N |
27015 |
Steam query-poort (UDP). |
-EchoPort=N |
18888 |
Telnet-consolepoort (TCP, alleen lokaal). Gebruikt voor lokaal beheer op afstand. |
-saving=N |
- | Interval voor het opslaan van de wereldstatus naar het geheugen (in seconden). |
-backup=N |
- | Interval voor het opslaan van de in-memory database naar schijf (in seconden). |
-initbackup |
- | Maakt een back-up van de wereld elke keer dat de server opstart. |
-backupinterval=N |
- | Interval voor het automatisch aanmaken van back-ups (in minuten). |
-GongHuiMaxMember=N |
- | Maximaal aantal leden per stam (guild). |
-MULTIHOME=IP |
- | Bindt de server aan een specifiek lokaal IP-adres (alleen voor multi-homed servers). |
-rconpsw="password" |
(geen) | Schakelt RCON remote console-toegang in met het opgegeven wachtwoord. |
-rconport=N |
19000 |
RCON-listener TCP-poort. Alleen relevant als RCON is ingeschakeld. |
-rconaddr=IP |
- | RCON-listener IP-binding. Gebruik 0.0.0.0 om op alle interfaces te luisteren. |
-log |
- | Schakelt consolevenster en logboekuitvoer in. |
-UTF8Output |
- | Schakelt correcte verwerking van niet-Latijnse tekens in de uitvoer in. |
GPanel verwerkt de meeste hiervan automatisch. Op Legion Hosting worden de essentiële parameters geconfigureerd via het GPanel Startup-tabblad. Geavanceerde parameters zoals RCON-instellingen of stamlimieten kunnen worden toegevoegd via het veld voor aanvullende opstartparameters in GPanel indien beschikbaar, of door contact op te nemen met support.
PvE vs PvP-modus
Soulmask ondersteunt twee primaire spelmodi die de multiplayer-ervaring fundamenteel veranderen:
PvE-modus (-pve)
- Spelers kunnen elkaar niet direct beschadigen.
- Structuren en bases zijn beschermd tegen andere spelers.
- De focus ligt op coöperatief overleven, bouwen en verkennen.
- Spelers kunnen nog steeds interactie hebben, handelen en stammen vormen.
- Aanbevolen voor coöperatieve gemeenschappen en casual servers.
PvP-modus (-pvp)
- Spelers kunnen elkaar aanvallen en doden.
- Bases en structuren kunnen door andere spelers worden aangevallen en verwoest.
- Stammenoorlog en gebiedscontrole worden kernonderdelen van de gameplay.
- PvP-schadeverhoudingen kunnen worden afgestemd in het configuratiebestand
GameXishu.json. - Aanbevolen voor competitieve servers en ervaren spelers.
Modus kan niet worden gewijzigd zonder een wipe. Het wisselen tussen PvE en PvP nadat de wereld is aangemaakt, kan gameplay-inconsistenties veroorzaken. Het wordt aanbevolen om een modus te kiezen vóór je eerste start. Als je de modus moet wijzigen op een bestaande wereld, overweeg dan opnieuw te beginnen.
Kaart- en wereldinstellingen (GameXishu.json)
Gedetailleerde wereld- en gameplay-instellingen worden beheerd via het configuratiebestand GameXishu.json. Dit bestand bevat uitgebreide opties voor het afstemmen van grondstofpercentages, gevecht, invasies, bouwen, dieren en meer.
Het bestand lokaliseren
Het configuratiebestand bevindt zich op:
WS/Saved/GameplaySettings/GameXishu.jsonBenader dit bestand via het tabblad Files in GPanel of via SFTP.
Belangrijke instellingenreferentie
Hieronder staan de meest aangepaste instellingen. De parameternamen zijn in hun originele formaat (Chinees pinyin). Engelse beschrijvingen worden bij elke instelling gegeven.
Ervaring en voortgang
| Instelling | Engelse naam | Beschrijving |
|---|---|---|
ExpRatio |
Experience Ratio | Vermenigvuldiger voor algemene ervaringswinst. Hogere waarden versnellen het levelen. |
ChengZhangExpRatio |
Growth Experience Ratio | Vermenigvuldiger voor groei-ervaringswinst van het personage. |
ShaGuaiExpRatio |
Monster Kill Experience Ratio | Vermenigvuldiger voor ervaring verkregen door het doden van monsters. |
Gevecht en schade
| Instelling | Engelse naam | Beschrijving |
|---|---|---|
DongWuDamageRatio |
Animal Damage Ratio | Vermenigvuldiger voor schade toegebracht door wilde dieren en wezens. |
BeDamageByYeShengRatio |
Damage Taken from Wildlife | Vermenigvuldiger voor schade ontvangen van wilde wezens. |
ShengMingHuiFuRatio |
Health Recovery Ratio | Vermenigvuldiger voor de snelheid van natuurlijk gezondheidsherstel. |
QiXiHuiFuRatio |
Stamina Recovery Ratio | Vermenigvuldiger voor de snelheid van staminaherstel. |
TiLiHuiFuRatio |
Energy Recovery Ratio | Vermenigvuldiger voor de snelheid van energie-/uithoudingsvermogenherstel. |
PVP_ShangHaiRatio_JinZhan |
PvP Melee Damage Ratio | Vermenigvuldiger voor PvP melee-gevechtsschade (standaard: 0.4). |
Grondstoffen en verbruik
| Instelling | Engelse naam | Beschrijving |
|---|---|---|
ShiWuXiaoHaoRatio |
Food Consumption Ratio | Vermenigvuldiger voor hoe snel voedsel wordt verbruikt. Lagere waarden vertragen het voedselverbruik. |
ShuiXiaoHaoRatio |
Water Consumption Ratio | Vermenigvuldiger voor hoe snel water wordt verbruikt. |
RanLiaoXiaoHaoRatio |
Fuel Consumption Ratio | Vermenigvuldiger voor hoe snel brandstof wordt verbruikt door ambachtsstations en vuren. |
Dieren en landbouw
| Instelling | Engelse naam | Beschrijving |
|---|---|---|
DongWuShengZhangRatio |
Animal Growth Ratio | Vermenigvuldiger voor de groeisnelheid van dieren. Hogere waarden laten dieren sneller volwassen worden. |
FanZhiJianGeRatio |
Breeding Interval Ratio | Vermenigvuldiger voor de tijd tussen voortplantingscycli van dieren. |
DongWuChanChuRatio |
Animal Production Ratio | Vermenigvuldiger voor de productie-output van dieren (eieren, melk, enz.). |
DongWuPinZhiRatio |
Animal Quality Ratio | Vermenigvuldiger voor de kwaliteit van getemde diereigenschappen. |
ZuoWuShengZhangRatio |
Crop Growth Ratio | Vermenigvuldiger voor de groeisnelheid van gewassen. |
ZuoWuFeiLiaoXiaoHaoRatio |
Crop Fertilizer Consumption | Vermenigvuldiger voor het verbruik van meststof. |
Bouwen en structuren
| Instelling | Engelse naam | Beschrijving |
|---|---|---|
JianZhuFuLanKaiGuan |
Building Decay Toggle | Schakel verval van gebouwen in of uit. Stel in op 0 om uit te schakelen. |
JianZhuFuLanMul |
Building Decay Multiplier | Snelheid waarmee structuren vervallen. Lagere waarden vertragen het verval. |
JianZhuXiuLiMul |
Building Repair Multiplier | Vermenigvuldiger voor reparatiekosten en -snelheid van gebouwen. |
JianZhuZiYuanJinShuaBanJing |
Building Resource Exclusion Radius | Straal rondom gebouwen waar natuurlijke grondstoffen niet opnieuw verschijnen. |
Invasiesysteem
| Instelling | Engelse naam | Standaard | Beschrijving |
|---|---|---|---|
RuQinGuaiCountMax |
Max Invasion Monsters | 128 |
Maximaal aantal monsters in een invasiegolf. |
RuQinQiangDuXiShu |
Invasion Intensity | - | Bepaalt de algehele invasiemoeilijkheid en monstersterkte. |
RuQinBeginHour |
Invasion Start Hour | - | In-game uur waarop invasies kunnen beginnen. |
RuQinEndHour |
Invasion End Hour | - | In-game uur waarop invasies stoppen. |
RuQinPerBoGuaiMax |
Max Monsters Per Wave | 16 |
Maximaal aantal monsters dat per individuele golf wordt gespawnd. |
Stop altijd je server voordat je GameXishu.json bewerkt. Het bewerken van het bestand terwijl de server draait, resulteert in het overschrijven van je wijzigingen wanneer de server opslaat. Stop de server, breng je wijzigingen aan en start hem dan opnieuw.
Verbinding maken
Spelers kunnen verbinden met je Soulmask server via de in-game server browser of via directe verbinding.
Via in-game server browser
- Start Soulmask.
- Selecteer vanuit het hoofdmenu Multiplayer en vervolgens Server Browser.
- Zoek naar je server op naam (de naam die je hebt ingesteld in de opstartvariabele
SERVER_NAME). - Klik op je server en druk op Join. Voer het wachtwoord in als er een is ingesteld.
Via Steam server browser
- Ga in Steam naar View > Game Servers (of Servers).
- Klik op het tabblad Favorites en vervolgens op Add a Server.
- Voer het IP en de query port van je server in (standaard
27015) in het formaatIP:PORT. - Zodra de server verschijnt, dubbelklik erop om via Soulmask te verbinden.
Via directe verbinding
- Zoek het IP en de gamepoort van je server op in het tabblad Console van GPanel. Voor hulp, zie Hoe je je server-IP en poort kunt vinden.
- Zoek in Soulmask naar de optie Direct Connect in het multiplayer-menu.
- Voer het IP en de gamepoort van je server in (standaard
8777) in het formaatIP:PORT. - Druk op Connect en voer het serverwachtwoord in indien vereist.
Server verschijnt niet? Als je server niet verschijnt in de browser, controleer dan of deze volledig is opgestart en klaar is met laden. Nieuwe servers kunnen 2-5 minuten nodig hebben om in de Steam master server-lijst te verschijnen. Je kunt altijd directe verbinding gebruiken met het IP en de gamepoort. Poorten worden willekeurig toegewezen tenzij je een privé-IP hebt.
Opslagbeheer
Soulmask gebruikt een database-ondersteund opslagsysteem. Begrijpen hoe opslagen werken is essentieel om gegevensverlies te voorkomen.
Opslaglocatie
Het primaire wereldopslagbestand bevindt zich op:
WS/Saved/Worlds/Dedicated/Level01_Main/world.dbDeze SQLite-database bevat alle wereldgegevens inclusief terreinwijzigingen, structuren, NPC-statussen en spelersgegevens.
Opslagproces
Soulmask gebruikt een tweetrapsopslagproces:
- Geheugenopslag (
-saving): De wereldstatus wordt periodiek naar een in-memory database geschreven op het interval dat is opgegeven door de parameter-saving(in seconden). - Schijfback-up (
-backup): De in-memory database wordt naar schijf geschreven op het interval dat is opgegeven door de parameter-backup(in seconden).
Sluit je server altijd correct af. Het is van vitaal belang dat je je server netjes afsluit via de GPanel Stop-knop, het in-game commando
gm exit, of het RCON-commando shutdown. Het geforceerd beëindigen van het serverproces kan ertoe leiden dat de in-memory database niet naar schijf wordt geschreven, wat resulteert in terugdraaien naar de laatste schijfopslag.
Automatische back-ups
Configureer automatische back-ups met deze opstartparameters:
-initbackup-- Maakt elke keer dat de server opstart een back-up.-backupinterval=N-- Maakt rollende back-ups elke N minuten tijdens runtime.
Handmatige back-ups
Om een handmatige back-up te maken:
- Stop de server vanuit GPanel.
- Navigeer naar
WS/Saved/via het tabblad Files in GPanel of SFTP. - Download de volgende bestanden:
Worlds/Dedicated/Level01_Main/world.db-- De wereldopslagdatabaseGameplaySettings/GameXishu.json-- Je gameplay-configuratie
- Bewaar deze bestanden veilig op je lokale computer.
Een back-up herstellen
- Stop de server.
- Upload het back-upbestand
world.dbnaarWS/Saved/Worlds/Dedicated/Level01_Main/. - Upload de back-up van
GameXishu.jsonnaarWS/Saved/GameplaySettings/als je ook de instellingen wilt herstellen. - Start de server.
Een nieuwe wereld starten
Om de wereld te wissen en opnieuw te beginnen:
- Stop de server.
- Hernoem of verwijder het bestand
world.dbopWS/Saved/Worlds/Dedicated/Level01_Main/. - Start de server. Deze genereert een nieuwe werelddatabase vanaf nul.
Maak een back-up voordat je wist. Download een kopie van
world.db als back-up voordat je wereldgegevens verwijdert, voor het geval je deze later wilt herstellen.
Poortreferentie
Soulmask gebruikt de volgende poorten. Deze worden automatisch geconfigureerd door je hostingpakket op Legion Hosting.
| Poort | Protocol | Standaard | Doel |
|---|---|---|---|
| Game Port | UDP | 8777 |
Primaire spelverbindingen. Spelers verbinden met deze poort. |
| Query Port | UDP | 27015 |
Steam server browser-query's. |
| Echo Port (Telnet) | TCP | 18888 |
Lokaal telnetbeheer (alleen lokale verbindingen). |
| RCON Port | TCP | 19000 |
Remote console (RCON)-toegang. Alleen actief als -rconpsw is ingesteld. |
Gerelateerde artikelen
- Soulmask Beheerderscommando's
- Hoe je je server-IP en poort kunt vinden
- Bestanden uploaden via SFTP
- Aan de slag met je nieuwe server
Hulp nodig?
Als je nog steeds problemen hebt met je Soulmask server, open dan een supportticket en ons team helpt je graag verder.
