Deze handleiding behandelt hoe je je Foundry dedicated server instelt op Legion Hosting, opstartvariabelen configureert, het serverinstellingenbestand bewerkt, wereldgeneratie instelt, verbinding maakt met je server en opgeslagen bestanden en back-ups beheert. Foundry is een voxel-gebaseerd fabrieksbouwspel waarin spelers grondstoffen delven, geautomatiseerde productielijnen bouwen en enorme fabrieken uitbreiden over een procedureel gegenereerde wereld. Voor beheerdersbediening, spelerbeheer en probleemoplossing, zie Foundry Beheer en Serverbeheer.
1. Eerste start
- Log in op GPanel en selecteer je Foundry server.
- Ga naar het tabblad Startup en bekijk de configureerbare variabelen (zie de tabel in Sectie 2).
- Stel SERVER_NAME in op een naam voor je server. Deze verschijnt in de Steam serverbrowser.
- Stel SRV_PW in als je de toegang wilt beperken. Laat het leeg voor een openbare server.
- Stel optioneel een MAP_SEED in om de wereldgeneratie te bepalen. Laat het leeg voor een willekeurige seed.
- Ga terug naar het tabblad Console en klik op Start.
- Wacht tot de console bevestigt dat de server is gestart. De eerste lancering kan een paar minuten duren omdat de server de wereld genereert en initiële configuratiebestanden aanmaakt.
App.cfg of andere configuratiebestanden moet bewerken, start de server één keer, laat hem volledig laden en stop hem vervolgens voordat je gaat bewerken. De bestanden bestaan pas na de eerste keer draaien.
2. GPanel opstartvariabelen
De volgende variabelen zijn beschikbaar in het GPanel Startup tabblad. Deze worden bij elke start aan de server doorgegeven.
| Variabele | Vereist | Beschrijving |
|---|---|---|
SERVER_NAME |
Ja | De naam die wordt weergegeven in de Steam serverbrowser. |
SRV_PW |
Nee | Optioneel wachtwoord dat spelers moeten invoeren om deel te nemen. Laat leeg voor een openbare server. |
MAX_PLAYERS |
Nee | Maximaal aantal gelijktijdige spelers. Standaard is 32. |
MAP_SEED |
Nee | Wereldgeneratie-seednummer. Gebruik dezelfde seed om identiek terrein te herscheppen. Laat leeg voor een willekeurige wereld. |
WORLD_NAME |
Nee | De naam van de wereld/opslagmap. Standaard is MyFoundry. Dit wijzigen maakt een nieuwe wereld aan. |
PUBLIC_SERVER |
Nee | Of de server verschijnt in de Steam serverbrowser. Stel in op true of false. Standaard is true. |
3. Serverconfiguratiebestand
Voor geavanceerde instellingen die verder gaan dan wat de opstartvariabelen bieden, kun je het serverconfiguratiebestand rechtstreeks bewerken. Stop je server voordat je wijzigingen aanbrengt.
Bestandslocatie
App.cfg
Open dit bestand via het tabblad Files in GPanel of maak verbinding via SFTP. Het bestand gebruikt een eenvoudig key=value formaat met één instelling per regel. Als het bestand niet bestaat, start en stop de server eenmaal om het te genereren.
App.cfg bij het opstarten. Wijzigingen die worden aangebracht terwijl de server draait, worden pas van kracht bij de volgende herstart.
Belangrijke instellingen in App.cfg
| Instelling | Standaard | Beschrijving |
|---|---|---|
server_name |
My Server |
Servernaam weergegeven in de Steam serverbrowser. |
server_password |
(leeg) | Wachtwoord vereist om de server te betreden. Leeg betekent openbaar. |
server_world_name |
MyFoundry |
De naam van de wereld/opslagmap. Elke unieke naam maakt een aparte wereld met eigen opslaggegevens aan. |
server_max_players |
32 |
Maximaal aantal gelijktijdige spelers toegestaan op de server. |
server_is_public |
true |
Bepaalt of de server wordt weergegeven in de Steam serverbrowser. |
server_port |
3724 |
Gamepoort. Dit wordt beheerd door GPanel -- wijzig dit niet tenzij support dit aangeeft. |
server_query_port |
27015 |
Steam querypoort gebruikt voor serverbrowservermeldingen. Beheerd door GPanel. |
map_seed |
(willekeurig) | Seednummer voor procedurele wereldgeneratie. Gebruik een willekeurig geheel getal. Dezelfde seed produceert altijd dezelfde terreinindeling. |
autosave_interval |
300 |
Auto-save interval in seconden. Standaard is 300 (5 minuten). Stel in op 0 om auto-save uit te schakelen. |
pause_server_when_empty |
true |
Pauzeert de spelwereld wanneer er geen spelers verbonden zijn. Stel in op false om de fabriek 24/7 te laten draaien. |
Voorbeeldconfiguratie
server_name=My Legion Factory
server_password=
server_world_name=MyFoundry
server_max_players=16
server_is_public=true
server_port=3724
server_query_port=27015
map_seed=48293175
autosave_interval=300
pause_server_when_empty=true
server_port en server_query_port worden toegewezen door GPanel en moeten overeenkomen met je toegewezen poorten. Het wijzigen ervan voorkomt dat spelers verbinding kunnen maken en dat de server in de browser verschijnt.
4. Wereldgeneratie
Foundry gebruikt procedurele wereldgeneratie om zijn voxelterrein te creëren. De wereld wordt gegenereerd op basis van een seednummer, dat de indeling van terrein, ertsafzettingen en biomen bepaalt.
Map Seed
- Stel de
map_seedwaarde inApp.cfgof deMAP_SEEDopstartvariabele in op een willekeurig geheel getal. - Het gebruik van dezelfde seed produceert altijd dezelfde wereldindeling, wat handig is als je een specifieke wereld met anderen wilt delen of een wereld wilt herscheppen na een reset.
- Laat de seed leeg of laat hem helemaal weg om de server een willekeurige wereld te laten genereren.
- De seed heeft alleen invloed op de initiële wereldgeneratie. Het wijzigen van de seed op een bestaande wereld heeft geen effect -- je moet een nieuwe wereld aanmaken (wijzig
server_world_name) om een nieuwe seed van kracht te laten worden.
Wereldnaam en meerdere werelden
De instelling server_world_name bepaalt welke opslagmap de server gebruikt. Je kunt meerdere werelden onderhouden door te schakelen tussen verschillende wereldnamen:
- Elke unieke
server_world_namemaakt een aparte wereld aan met eigen opslaggegevens, fabrieksstatus en spelervoortgang. - Om van wereld te wisselen, stop de server, wijzig de
server_world_nameinApp.cfgen herstart. - Vorige werelden worden bewaard en kunnen opnieuw geladen worden door terug te schakelen naar hun naam.
Pauzeren wanneer leeg
De optie pause_server_when_empty bepaalt of je fabriek blijft draaien wanneer er geen spelers online zijn:
- true (standaard) -- De wereld pauzeert wanneer alle spelers de verbinding verbreken. Fabrieken stoppen met produceren, grondstoffen worden niet meer verbruikt. Goed om serverbronnen te besparen en de spelstatus voorspelbaar te houden.
- false -- De fabriek blijft 24/7 draaien. Productielijnen gaan door, grondstoffen stapelen zich op en de wereld vordert zelfs wanneer niemand speelt. Kan het servergebruik verhogen.
5. Verbinding maken
Optie A -- Steam serverbrowser
- Start Foundry.
- Selecteer in het hoofdmenu Multiplayer.
- Klik op Join Game om de serverbrowser te openen.
- Gebruik de zoekbalk om je server op naam te vinden.
- Selecteer je server en klik op Join. Voer het serverwachtwoord in als er een is ingesteld.
Optie B -- Directe verbinding
- Start Foundry.
- Selecteer in het hoofdmenu Multiplayer.
- Kies de optie Direct Connect.
- Voer het IP-adres en de poort van je server in via het tabblad Network in GPanel:
<your-server-ip>:<port> - Voer het serverwachtwoord in als daarom wordt gevraagd en klik op Connect.
6. Opslagbeheer
Auto-save
De server slaat automatisch op met het interval dat is opgegeven door autosave_interval in App.cfg (standaard: elke 300 seconden / 5 minuten). Foundry auto-saves zijn niet-storend en veroorzaken geen merkbare vertraging voor de meeste fabrieksgroottes.
Locatie van opslagbestanden
Opslagbestanden worden op de server opgeslagen op het pad dat is opgegeven door server_persistent_data_override_folder in App.cfg. Het standaardpad is:
serverfiles/
Deze map bevat de volledige wereldstatus inclusief terreinwijzigingen, geplaatste structuren, fabrieksmachines, transportbanden en spelerinventarissen.
Handmatige back-ups via SFTP
- Stop de server vanuit GPanel om ervoor te zorgen dat alle gegevens naar schijf worden geschreven.
- Maak verbinding met je server via SFTP. Zie Bestanden uploaden via SFTP voor instructies.
- Download de volledige opslagmap voor je wereld (bijv.
serverfiles/). - Sla de back-up op een veilige locatie op je computer op.
Een opgeslagen bestand herstellen
- Stop de server vanuit GPanel.
- Maak verbinding via SFTP en navigeer naar de map
serverfiles/. - Upload je back-up van de wereldmap en vervang de bestaande.
- Zorg ervoor dat de mapnaam overeenkomt met de
server_world_nameinApp.cfg. - Start de server vanuit GPanel. De server zal het herstelde opgeslagen bestand laden.
7. Prestatietips
Foundry is een fabrieksbouwspel en serverprestaties worden direct beïnvloed door fabriekscomplexiteit. Houd deze tips in gedachten naarmate je fabriek groeit:
- Fabriekscomplexiteit: Grote aantallen machines, transportbanden en logistieke netwerken verhogen de servertickbelasting. Als je vertraging opmerkt, overweeg dan om productieketens te consolideren of te optimaliseren.
- Chunk-laden: De server verwerkt alle geladen chunks. Meer actieve fabrieksgebieden verspreid over de kaart betekent meer chunks om te simuleren. Je fabriek compact houden vermindert het aantal chunks dat de server moet bijhouden.
- Aantal spelers: Meer verbonden spelers betekent meer chunks geladen rondom elke speler. Als de prestaties verslechteren met veel spelers, overweeg dan om
server_max_playerste verlagen. - Auto-save frequentie: Zeer frequente auto-saves (minder dan 60 seconden) op grote werelden kunnen periodieke haperingen veroorzaken. De standaard 300 seconden is meestal prima, maar je kunt het verhogen indien nodig.
- Pauzeren wanneer leeg: Het inschakelen van
pause_server_when_empty=truevoorkomt onnodige simulatie wanneer niemand speelt, wat helpt om consistente prestaties te behouden tijdens actieve speelsessies.
Gerelateerde artikelen
- Foundry Beheer en Serverbeheer
- Hoe je je server-IP en poort vindt
- Bestanden uploaden via SFTP
- Server opstarthandleiding
Hulp nodig?
Als je problemen ondervindt met je Foundry server die hier niet worden behandeld, open een supportticket en vermeld je server-IP, een beschrijving van het probleem en eventuele relevante foutmeldingen uit de GPanel console.