Voor de versiewissel

Maak in het panel onder Backups eerst een handmatige backup. Stop daarna de server. Stable en Experimental kunnen verschillende savegame- en modversies nodig hebben; wissel nooit terwijl de server draait.

Maak vooraf ook duidelijk wat je eigenlijk wilt bereiken. Een wissel van Experimental terug naar Stable is geen simpele downgrade-klik: een wereld die al onder een nieuwere build is opgeslagen, kun je niet betrouwbaar verder spelen in een oudere versie. Plan in dat geval met een nieuwe wereld of met de backup die vóór de wissel naar Experimental is gemaakt. Als je je server net pas opzet, loop dan eerst de basisinstallatie van een 7-Days-to-Die-server door — de instellingen daar vormen de basis voor alles wat volgt.

Stable of Experimental selecteren

  1. Open je server en ga naar Instellingen → Versie wisselen.
  2. Kies Stable voor normaal gebruik. Gebruik Experimental alleen als je wereld en alle mods de gewenste build expliciet ondersteunen.
  3. Bevestig de wissel en wacht tot de installatie en herstart klaar zijn.
  4. Controleer in het startlog de weergegeven spelversie en verbind één keer met de passende client.

Bij een major-update moet je vooraf de compatibiliteit van je wereld en elke mod controleren. Als het starten mislukt, herstel dan niet steeds opnieuw: stop de server, controleer het eerste concrete mod- of versieprobleem in het log en zet indien nodig je backup terug.

Ook de clientkant is belangrijk: je gameclient moet dezelfde branch gebruiken als de server. Steam schakelt niet automatisch over naar Experimental — dat stel je in de speleigenschappen onder Betas in. Blijft de client op Stable terwijl de server op Experimental draait, dan verschijnt de server of helemaal niet in de lijst, of het joinen breekt af met een versiemelding. Dat is geen serverfout en kan niet met een herstart worden opgelost.

Grote mods via SFTP uploaden

De bestandsmanager in de browser is bedoeld voor kleine bestanden. Gebruik SFTP voor grote mods of veel bestanden:

  1. Stop de server.
  2. Open in het panel SFTP/toegangsgegevens en kopieer host, poort, gebruikersnaam en wachtwoord.
  3. Verbind met een SFTP-client zoals FileZilla of WinSCP. Gebruik expliciet het protocol SFTP, niet FTP.
  4. Pak het mod-archief lokaal uit. Upload de volledige mod-map naar /Mods/. Uiteindelijk moet het bestand ModInfo.xml direct in de betreffende mod-submap staan, bijvoorbeeld /Mods/MijnMod/ModInfo.xml.
  5. Upload ook alle afhankelijkheden die de mod noemt. Verwijder oude versies van dezelfde mod, zodat er geen dubbele DLL's worden geladen.
  6. Start de server en zoek in het log naar de modnaam en naar ERR, Exception of ontbrekende afhankelijkheden.

Waarom SFTP en niet de bestandsmanager in de browser? Grote modpakketten bestaan uit veel kleine bestanden. Een browser-upload draagt ze één voor één over en breekt bij een instabiele verbinding midden in het pakket af — dan blijft er een half geüploade mod achter die bij het starten een foutmelding veroorzaakt die op een versieconflict lijkt. Een SFTP-client draagt mappen in één keer over, toont de voortgang en kan afgebroken overdrachten hervatten. De algemene toegangsgegevens en basisinformatie daarvoor staan in de gids over SFTP-toegang tot de gameserverbestanden.

Let bij het downloaden van mods op de passende spelversie. Verzamelingen zoals 7daystodiemods.com vermelden bij elke mod de ondersteunde 7DTD-versie — een mod voor A21 werkt meestal niet onder een nieuwere build. Een uitgebreidere handleiding voor het installeren vind je onder Mods op de 7-Days-to-Die-server installeren.

Als de server niet start

  • Controleer of de mod en server dezelfde hoofdversie van 7DTD ondersteunen.
  • Controleer geneste mappen zoals /Mods/MijnMod/MijnMod/ModInfo.xml; één niveau daarvan is te veel.
  • Start bij wijze van test zonder de laatst geüploade mod.
  • Herstel de backup als de versiewissel zelf de wereld heeft beschadigd.

Pak daarbij altijd maar één wijziging tegelijk aan. Wie tegelijk de versie wisselt, drie mods vervangt en de configuratie aanpast, kan achteraf niet meer zeggen welke stap het starten verhindert. De snelste weg terug is bijna altijd: mods tijdelijk uit /Mods/ verwijderen, een schone start bevestigen en daarna de mods één voor één weer toevoegen.

Pas als het log geen concrete bestandsnaam of fout noemt, maak je een supportticket aan en voeg je de betreffende modlink en het eerste foutblok uit het startlog toe.

FAQ

Kan ik van Experimental terug naar Stable wisselen?

De versiewissel zelf wel — maar je wereld niet per se. Savegames die onder een nieuwere build zijn opgeslagen, zijn in oudere versies vaak niet meer leesbaar. Plan voor de terugweg een backup in die vóór de wissel is gemaakt.

Moet mijn gameclient ook worden omgezet?

Ja. Server en client moeten dezelfde branch gebruiken. Experimental stel je in Steam in onder de speleigenschappen op het tabblad Betas. Zonder deze omzetting mislukt het joinen met een versiemelding.

Waarom wordt mijn mod na het uploaden niet geladen?

In verreweg de meeste gevallen komt het door de mapdiepte. ModInfo.xml moet direct in de mod-map staan, dus /Mods/MijnMod/ModInfo.xml. Een extra niveau zoals /Mods/MijnMod/MijnMod/ModInfo.xml zorgt ervoor dat de server de mod over het hoofd ziet — zonder foutmelding.

Gaan mijn wereld en de spelergegevens verloren bij de versiewissel?

De wissel vervangt de serverbestanden, niet de saves. Bij een major-update kan een wereld toch incompatibel worden — daarom maak je vóór elke wissel een backup.

Waarom breekt de upload in de browser steeds af?

De bestandsmanager draagt veel kleine bestanden één voor één over. Bij grote modpakketten is een SFTP-client de betrouwbaardere keuze, omdat die mappen in één keer overdraagt en onderbrekingen kan hervatten.