Deze handleiding begeleidt je bij het instellen van je Hytale dedicated server op Legion Hosting, inclusief de vereiste eenmalige authenticatiestap, basisconfiguratie van de server en hoe spelers verbinding maken met je server.

Vereisten

• Een actieve Hytale server bij Legion Hosting
• Je GPanel-inloggegevens uit de welkomstmail (controleer je spammap als je deze niet kunt vinden)
• Hytale geïnstalleerd op je PC
• Het IP-adres en de poort van je server via GPanel (log in op gpanel.legionhosting.net)

Stap 1 — Inloggen op GPanel en de server starten

1. Open je browser en ga naar https://gpanel.legionhosting.net.
2. Voer het e-mailadres en wachtwoord uit je welkomstmail in en klik op Login.
3. Klik op je Hytale server in de serverlijst om deze te openen.
4. Op het tabblad Console toont de statusindicator Offline. Klik op de knop Start.
5. Wacht tot de server alle vereiste bestanden heeft gedownload en geïnstalleerd. De eerste keer opstarten kan 2 tot 5 minuten duren terwijl de Hytale serverbestanden worden ingesteld.
6. Bekijk de console-uitvoer. De server zal uiteindelijk pauzeren en een authenticatieprompt weergeven met een URL en een apparaatcode. Sluit of herstart de server op dit moment niet.

Stap 2 — Je server authenticeren

Hytale vereist serverauthenticatie bij de eerste keer opstarten. De server accepteert geen spelerverbindingen totdat je deze stap hebt voltooid.

1. Zoek in de GPanel-console naar een bericht met een URL en een apparaatcode. Het ziet er ongeveer zo uit:

   To authenticate, visit: https://auth.hytale.com/device
   Enter the code: XXXX-XXXX

2. Open de authenticatie-URL in je webbrowser op elk apparaat (PC, telefoon, tablet).
3. Log in met je Hytale-account (het account dat je gebruikt om het spel te spelen).
4. Voer de apparaatcode in die in de console wordt weergegeven wanneer daarom wordt gevraagd.
5. Bevestig de authenticatie. De browser toont een succesbericht.
6. Ga terug naar GPanel en bekijk de console. Binnen enkele seconden zou de server het opstartproces moeten voortzetten en verandert de status naar Running.

Stap 3 — Je verbindingsgegevens vinden

1. Klik in GPanel op het tabblad Console (of het serveroverzichtsgebied).
2. Noteer het IP-adres en de poort die bovenaan de pagina worden weergegeven.
3. Het formaat is IP:Port, bijvoorbeeld 192.0.2.10:25565. Je deelt deze gegevens met iedereen die wil deelnemen aan je server.

Voor een gedetailleerde uitleg over het vinden van je verbindingsgegevens, zie Hoe vind je je server-IP en poort.

Stap 4 — Basisconfiguratie van de server

Hytale dedicated servers bieden belangrijke instellingen via het GPanel tabblad Startup. Deze variabelen regelen de meest voorkomende serveropties zonder dat je handmatig bestanden hoeft te bewerken.

Opstartvariabelen gebruiken

1. Klik in GPanel op het tabblad Startup.
2. Je ziet een lijst met configureerbare variabelen. Bewerk een waarde en klik op Save of druk op Enter.
3. Na het aanbrengen van wijzigingen, herstart de server vanuit het Console-tabblad zodat de nieuwe instellingen van kracht worden.

Veelgebruikte instellingen

Configuratiebestanden bewerken

Voor geavanceerde instellingen die niet beschikbaar zijn in het Startup-tabblad, kun je de serverconfiguratiebestanden direct bewerken via de GPanel-bestandsbeheerder.

1. Klik op het tabblad Files in GPanel.
2. Blader naar de hoofdmap van de server en zoek naar configuratiebestanden (deze kunnen variëren naarmate Hytale wordt bijgewerkt).
3. Klik op een bestand om het te openen in de ingebouwde teksteditor. Breng je wijzigingen aan en klik op Save Content.
4. Stop en herstart de server zodat de wijzigingen van kracht worden.

Voor bulkbestandsoverdrachten of grote uploads, maak verbinding via SFTP in plaats van de browserbestandsbeheerder. Zie Bestanden uploaden via SFTP voor instructies.

Stap 5 — Verbinding maken met je Hytale server

1. Start Hytale op je PC.
2. Navigeer vanuit het hoofdmenu naar de optie Multiplayer of Server Browser.
3. Selecteer Direct Connect (of de equivalente optie om via IP deel te nemen).
4. Voer de IP:Port van je server in uit Stap 3 — bijvoorbeeld 192.0.2.10:25565.
5. Als je een serverwachtwoord hebt ingesteld in Stap 4, voer dit in wanneer daarom wordt gevraagd.
6. Klik op Connect. Je zou binnen enkele seconden in de serverwereld moeten laden.

Verificatie

Controleer na het verbinden of alles werkt:

1. Je karakter zou succesvol in de spelwereld moeten laden.
2. Controleer het GPanel tabblad Console — je zou een logvermelding moeten zien die aangeeft dat je speler de server heeft betreden.
3. Vraag een vriend om verbinding te maken met hetzelfde IP en dezelfde poort om externe connectiviteit te verifiëren.
4. De serverstatus zou Running moeten blijven zonder fouten in de console-uitvoer.

Probleemoplossing

Server start niet of loopt vast tijdens het opstarten

• Controleer de console-uitvoer op foutmeldingen. Bij de eerste installatie kan de server enkele minuten nodig hebben om vereiste bestanden te downloaden.
• Als de server wacht op authenticatie, voltooi de apparaatlogin beschreven in Stap 2.
• Als fouten aanhouden na authenticatie, probeer de server opnieuw te installeren via het tabblad Settings in GPanel (dit verwijdert servergegevens — maak eerst een back-up van belangrijke bestanden).

Authenticatiecode verlopen of mislukt

• De apparaatcode is slechts beperkte tijd geldig. Als deze verloopt, herstart de server om een nieuwe code te genereren.
• Zorg ervoor dat je inlogt met een geldig Hytale-account dat het spel bezit.
• Probeer een andere browser of wis je browsercache als de authenticatiepagina niet laadt.

Kan geen verbinding maken met de server

• Bevestig dat de serverstatus Running toont in GPanel. Als het Offline of Starting toont, wacht tot de server volledig is opgestart.
• Controleer het IP-adres en de poort nogmaals — zorg ervoor dat je het poortnummer na de dubbele punt opneemt.
• Zorg ervoor dat de server de authenticatiestap succesvol heeft voltooid voordat je probeert verbinding te maken.
• Als de server net is gestart, wacht 1-2 minuten tot deze volledig is geïnitialiseerd voordat je probeert verbinding te maken.
• Zie Hoe vind je je server-IP en poort voor hulp bij het vinden van de juiste verbindingsgegevens.

Instellingswijzigingen worden niet toegepast

• Wijzigingen in opstartvariabelen vereisen een volledige herstart van de server. Gebruik de knop Restart op het Console-tabblad na het opslaan.
• Als je configuratiebestanden direct bewerkt, zorg ervoor dat de server is gestopt voordat je wijzigingen opslaat. Sommige spellen overschrijven configuratiebestanden bij het afsluiten, wat je bewerkingen ongedaan kan maken.

Server crasht of gaat onverwacht offline

• Controleer de console-uitvoer op foutmeldingen of crashlogs voordat de server offline ging.
• Hytale is in early access — crashes kunnen optreden door spelbugs. Probeer de server te herstarten.
• Als crashes herhaaldelijk optreden, kopieer de foutmeldingen en open een supportticket zodat ons team het kan onderzoeken.

Hulp nodig?

Als je een probleem tegenkomt dat hierboven niet wordt behandeld, open een supportticket en vermeld:

• Je servernaam uit GPanel
• Een beschrijving van het probleem en wanneer het begon
• Eventuele foutmeldingen uit de GPanel-console (kopieer en plak de relevante regels)