Barotrauma Mod-installatiehandleiding

Barotrauma Mod-installatiehandleiding - Kennisbank

Deze handleiding behandelt hoe je Steam Workshop-mods installeert, beheert en bijwerkt op je Barotrauma dedicated server gehost bij Legion Hosting. Mods kunnen aangepaste onderzeeërs, wezens, items en gameplay-aanpassingen aan je server toevoegen.

Op zoek naar de basisserverinstallatie? Zie Barotrauma Dedicated Server Setup Guide voor serverinstellingen, onderzeeërselectie, campagne-opslag en verbindingsinstructies.

Hoe mods werken op dedicated servers

Barotrauma ondersteunt Steam Workshop-mods voor aangepaste content, waaronder onderzeeërs, wezens, items en gameplay-aanpassingen. Op een dedicated server worden mods niet automatisch gedownload van de Workshop. Je moet de modbestanden handmatig naar je server overbrengen.

Belangrijk: De server moet dezelfde mods geïnstalleerd hebben als de verbindende clients. Als er een versieverschil is of een ontbrekende mod, kunnen spelers niet verbinden.

Workshop-mods installeren

De aanbevolen aanpak voor het installeren van mods op je gehoste server is om ze eerst op je lokale pc te downloaden en vervolgens de bestanden naar de server te uploaden.

Stapsgewijze installatie

Abonneer je op je eigen pc op de mod in de Steam Workshop en start Barotrauma eenmaal op om de mod te downloaden.
Zoek de gedownloade modmap op je pc. Workshop-mods worden doorgaans opgeslagen op:
```
Steam\steamapps\workshop\content\602960\<ModID>\
```
De <ModID> is het numerieke ID uit de Workshop-URL van de mod.
Maak verbinding met je server via SFTP of open de bestandsbeheerder in GPanel.
Navigeer naar de map LocalMods/ in je Barotrauma-servermap. Als de map niet bestaat, maak deze dan aan.
Upload de volledige modmap (de map met het numerieke ID van de mod) naar LocalMods/.
Configureer de mod in serversettings.xml zoals beschreven in het volgende gedeelte.
Herstart de server om de wijzigingen door te voeren.

Tip: Elke modmap moet een filelist.xml-bestand bevatten dat de mod identificeert. Als dit bestand ontbreekt, wordt de mod niet door de server gedetecteerd.

Mods configureren in serversettings.xml

Na het uploaden van modbestanden moet je ze registreren in je serverconfiguratie. Open serversettings.xml en voeg de mod toe aan de lijst met geïnstalleerde contentpakketten.

Belangrijk: Stop altijd je server voordat je serversettings.xml bewerkt. De server overschrijft dit bestand bij het afsluiten, waardoor wijzigingen die zijn aangebracht terwijl de server draait verloren gaan.

Raadpleeg de filelist.xml van de mod voor de juiste interne naam. Het exacte configuratieformaat is afhankelijk van je Barotrauma-versie, maar doorgaans verschijnen mods in de ContentPackage-vermeldingen binnen serversettings.xml.

Mod-laden verifiëren

Na het herstarten van de server met de geconfigureerde mod:

Open de serverconsole in GPanel.
Zoek naar logregels die verwijzen naar de modnaam of het ID. Succesvol geladen mods verschijnen tijdens de opstartsequentie.
Als je [ERROR]-regels ziet die naar de mod verwijzen, controleer dan of alle bestanden correct zijn geüpload en of de mod compatibel is met je serverversie.

Mods up-to-date houden

De server haalt niet automatisch Workshop-updates op. Wanneer een modauteur een update uitbrengt, moet je de bijgewerkte bestanden handmatig opnieuw downloaden en uploaden.

Updateproces

Zorg ervoor dat je Steam-client op je lokale pc de nieuwste versie van de mod heeft gedownload (meld je af en opnieuw aan bij de mod als dat nodig is om een verse download af te dwingen).
Maak verbinding met je server via SFTP.
Stop de server vanuit GPanel.
Navigeer naar LocalMods/<ModID>/ en vervang de inhoud door de nieuw gedownloade bestanden.
Start de server.

Informeer je spelers: Alle spelers moeten ook dezelfde mod op hun clients bijwerken voordat ze verbinding maken. Een versieverschil verhindert verbindingen.

Mod-compatibiliteit

Modconflicten zijn een van de meest voorkomende oorzaken van serverproblemen. Houd deze richtlijnen in gedachten:

Probleem	Oorzaak	Oplossing
Server crasht bij opstarten	Twee mods wijzigen dezelfde game-content (items, wezens, enz.)	Schakel alle mods uit en schakel ze vervolgens één voor één weer in om het conflict te vinden
Spelers worden losgekoppeld bij verbinden	Client-server mod-versieverschil	Zorg ervoor dat alle spelers en de server dezelfde modversies hebben
Contentfouten in serverlog	Ontbrekende afhankelijkheid of verouderde mod	Controleer de Workshop-pagina van de mod voor vereiste afhankelijkheden en werk bij
Mod werkt in singleplayer maar niet op de server	Alleen client-side mod	Controleer de Workshop-beschrijving van de mod; sommige mods zijn alleen voor de client en mogen niet op de server worden geïnstalleerd

Algemene regel: Hoe minder mods je draait, hoe stabieler je server is. Voeg mods geleidelijk toe en test na elke toevoeging in plaats van er veel tegelijk te installeren.

Mods verwijderen

Stop je server vanuit GPanel.
Open serversettings.xml en verwijder de contentpakketvermelding van de mod.
Verwijder de modmap uit LocalMods/ via SFTP of de GPanel-bestandsbeheerder.
Start de server.

Campagne-opslag: Als je een mod verwijdert die items of content heeft toegevoegd die in een actieve campagne worden gebruikt, kan de opslag beschadigd raken of fouten veroorzaken. Maak een back-up van je campagne-opslag voordat je mods verwijdert. Zie de hoofdinstallatiehandleiding voor back-upinstructies.

Gerelateerde artikelen

Hulp nodig? Open een supportticket op legionhosting.net/submitticket.php en vermeld je servernaam, de modnaam/het ID en eventuele foutmeldingen uit de GPanel-console.

Barotrauma Mod-installatiehandleiding - Kennisbank

Ondersteuning

Categorieën

Barotrauma Mod-installatiehandleiding