Hoe je een Hytale Server opzet (2026)

In deze gids behandelen we het opzetten, configureren en listen van een Hytale server op Windows, Linux en macOS.

Hytale-servers verschillen op één punt van de andere games waarvoor we serverguides schrijven: elke Hytale-wereld is al een server. Wanneer je een singleplayerwereld aanmaakt, start de client een lokale server op en verbindt hij ermee. Multiplayer is precies hetzelfde, maar dan met andere mensen die verbinding maken. Er is geen aparte "servermodus" om naar over te schakelen.

Dat betekent ook dat mods een zaak zijn van de server in plaats van de client, wat behandeld wordt in onze Hytale mod guide.

Een opmerking over de actualiteit hiervan: Hytale zit sinds januari 2026 in early access en Hypixel Studios heeft nog geen zelfstandig document over het opzetten van een dedicated server gepubliceerd. Wat volgt is opgebouwd uit hun officiële documentatie, patch notes en Server Operator Policies, en het geeft duidelijk aan waar de officiële richtlijnen ophouden.

Systeemeisen

Hytale's gepubliceerde minimumvereisten voor de client zijn:

	Minimum
OS	Windows 11 of Windows 10 x64 (1809), Linux x64 (kernel 6.15), of Apple Silicon met macOS Tahoe 26.0
CPU	Intel Core i5-7500, AMD Ryzen 3 1200, of Apple M1
RAM	8 GB
GPU	Intel UHD 620, AMD Radeon Vega 6, Apple M1, of een GTX 900 / Radeon 400 series kaart

Voor een server negeer je de GPU-regel en tel je al het andere zwaarder mee:

• RAM is de belangrijkste beperking. De server draait op Java, houdt geladen chunks en entities in het geheugen bij, en asset packs komen daar nog bovenop. 8 GB is een absoluut minimum voor een kleine groep, en een drukke server met mods wil aanzienlijk meer.
• Single-thread prestaties zijn belangrijk. Zoals bij de meeste blockgames is een groot deel van het tick-werk niet parallel.
• Schijfruimte hangt volledig af van hoeveel van de wereld verkend wordt. World saves groeien gestaag.
• Een Hytale-licentie, gekocht via hytale.com. De game staat niet op Steam.

NOTITIE - Hytale is op macOS enkel voor Apple Silicon. Er is geen Intel Mac-build.

Het servermodel van Hytale begrijpen

Kevin Carstens, Technical Director van Hytale, verwoordde het onomwonden toen de studio hun modding-strategie publiceerde: Hytale is anders in die zin dat je, zelfs wanneer je singleplayer speelt, verbinding maakt met een lokale server die alleen voor jou is. Wanneer de documentatie het over servers heeft, bedoelt men zowel singleplayer als multiplayer.

In de praktijk brengt dat een paar gevolgen met zich mee die het waard zijn om te onthouden:

• Mods worden eenmalig geïnstalleerd, door de host. Spelers die je server joinen installeren niets. Hun vanilla client rendert wat je server ook doorgeeft.
• Je singleplayerkennis is overdraagbaar. Een wereld configureren in singleplayer en een server configureren is nagenoeg dezelfde vaardigheid.
• Er is geen gemodde client om te verspreiden. De studio heeft aangegeven dat ze client mods niet van plan zijn te ondersteunen, juist om te voorkomen dat er ooit een versnipperd ecosysteem van per-server clients ontstaat.

Universes, Worlds en Instances

Hytale organiseert dingen in een hiërarchie die overal terugkomt in de configs en de patch notes.

Een universe bevat worlds. Een world is wat spelers als de map beschouwen. Instances zijn aparte kopieën van een world, gebruikt voor zaken als Portal Devices, en ze kunnen instellingen zoals fall damage en PvP overerven van de default world van het universe.

Je zult deze terminologie tegenkomen in plugin-configuratie, dus het is de moeite waard om dit te kennen voordat je configbestanden gaat lezen.

Hosten vanuit de client

Voor een kleine groep is dit het volledige antwoord en is er geen extra software nodig.

Maak een world aan in de client, selecteer de mods en asset packs die je ervoor wilt in de New World-opties, en deel een invite code met je vrienden. Zij maken verbinding en spelen met een volledig vanilla client.

Dit past bij een groep vrienden en is hoe de meeste mensen hun eerste Hytale multiplayer-ervaring zullen draaien. De beperkingen liggen voor de hand: de world is alleen actief zolang jouw client draait, hij concurreert om resources met je eigen game, en hij is gebonden aan jouw machine.

Een standalone server draaien

Voor iets permanents dat draait zonder dat jij ingelogd bent, wil je de server op zichzelf laten draaien.

Hier houdt de officiële documentatie momenteel op. Hypixel Studios levert een Java Server API-referentie en asset-documentatie, en zij beheren Server Discovery met een volledig beleidsdocument erachter, dus self-hosted servers worden duidelijk verwacht en ondersteund. Wat ze nog niet gepubliceerd hebben, is een stap-voor-stap "download dit, voer dit commando uit"-gids zoals Valheim of ARK die hebben.

Tot dat er is, zijn de praktische opties:

• De Hytale launcher en account manager. Serverdistributie verloopt via Hytale's eigen platform in plaats van via een externe store, dus accounts.hytale.com is de eerste plek om te checken.
• De officiële Discord. De Hytale Discord heeft de ontwikkelaars van de studio erin en is waar huidige server-operators zich bevinden. Voor iets dat zo snel beweegt, is dat betrouwbaarder dan welke geschreven gids dan ook, deze inbegrepen.
• Een managed host. Verschillende game server hosts voegden in 2026 Hytale-ondersteuning toe en regelen de opzet voor je.

NOTITIE - De server is niet geobfusceerd, en de studio heeft toegezegd de servercode vrij te geven onder het Hytale Shared Source-programma, dat in juni 2026 live ging. Gelicentieerde spelers hebben toegang tot de volledige servercode, het netwerkprotocol en de assets op GitHub, waarbij de toegang gemodelleerd is naar Epic's Unreal Engine source-programma. Als je technisch bent, is dat de meest complete documentatie die er bestaat.

Waar De Serverbestanden Staan

Bij een clientinstallatie bevindt de serverkant van de zaak zich onder UserData:

C:\Users\<user>\AppData\Roaming\Hytale\UserData

met Mods voor mods die overal beschikbaar zijn en Saves\<World Name> voor elke wereld, elk met een eigen mods-map.

Linux en macOS gebruiken de equivalente applicatiedatamap voor het platform, met dezelfde structuur eronder.

Een standalone server behoudt dezelfde vorm: een mods-map voor plugins en asset packs, met werelddata ernaast.

Linux-vereisten

Hytale's server is Java, dus je hebt een JVM nodig plus de gebruikelijke serveronderhoudstools.

Debian en Ubuntu:

sudo apt update
sudo apt install -y openjdk-21-jre-headless screen curl unzip

Fedora, RHEL en Rocky:

sudo dnf install -y java-21-openjdk-headless screen curl unzip

Controleer wat je hebt met:

java -version

TIP - Controleer welke Java-versie de huidige Hytale-build verwacht voordat je een JVM kiest. Dit is tijdens de early access veranderd, en een mismatch geeft een onduidelijke foutmelding.

Hytale's Linux-vereiste is een kernel 6.15 x64-systeem, wat nieuwer is dan wat verschillende long-term-support-distributies standaard meeleveren. Controleer met uname -r voordat je begint.

Mods En Plugins Installeren

Mods gaan in de mods-map van de server en de server laadt ze bij het opstarten.

1. Download de plugin of asset pack, meestal via CurseForge.
2. Plaats het in de mods-map van de server. Plugins zijn Java .jar-bestanden; asset packs zijn een zip of een map met een manifest.json erin.
3. Herstart de server.

Goed gebouwde plugins maken hun eigen map aan onder mods voor configuratie en data. BetterMap maakt bijvoorbeeld mods/bettermap/ aan met een config.json erin, en registreert /bm-commando's waaronder /bm reload om configwijzigingen door te voeren zonder herstart.

Spelers hoeven niets te installeren. Dat is precies het punt van het server-side model.

Onze Hytale mod guide gaat dieper in op de vier modcategorieën en hoe asset packs zijn opgebouwd.

Configuratie

Hytale-configuratie is JSON, en het is verspreid over een aantal plekken in plaats van in één server.properties-achtig bestand te staan.

• Wereldinstellingen worden gekozen bij het aanmaken van een wereld, met zaken als valschade en PvP, en instances kunnen deze overnemen van de standaardwereld van het universum.
• Gameplay-configs staan in JSON onder de configmappen van de server. Patch notes verwijzen naar paden zoals GameplayConfigs/Portal.json, wat je een idee geeft van de indeling.
• Plugin-configs staan onder de eigen map van elke plugin in mods.

Omdat het formaat en de paden nog steeds veranderen tussen updates, zijn de patch notes op hytale.com de moeite waard om te lezen bij elke update. Update 7's notes hebben bijvoorbeeld verschillende configsleutels ronduit hernoemd.

WAARSCHUWING - Lees de patch notes voordat je een live server update. Hytale draait wekelijkse pre-release patches die elke paar weken worden gebundeld in stabiele releases, en configsleutels zijn ertussen hernoemd en verwijderd. Een hernoeming die je niet opmerkt betekent dat een instelling stilletjes terugvalt naar de standaardwaarde.

Vermeld Worden In Server Discovery

Server Discovery is de in-game serverbrowser, die uitkwam met Update 5 in mei 2026. Vermelding is gratis en het proces is volledig gedocumenteerd.

1. Log in bij de Account Manager en open de Server Profiles-pagina.
2. Klik op Create server.
3. Vul je gegevens in:
   • Naam en beschrijving. Hierop beoordelen spelers je, dus zorg dat het weergeeft wat je server daadwerkelijk is.
   • Servertype, uit Survival, Adventure/RPG, Creative, PvP, Minigames, Roleplay, Social, Sandbox of Other.
   • Doelgroeplabel: Everyone, Teen of Mature.
   • Regio's die je bedient, uit tien opties verspreid over NA, Zuid-Amerika, EU, het Midden-Oosten, Azië en Oceanië.
   • Domeinverificatie via een TXT DNS-record, zodat spelers weten dat de vermelding echt van jou is.
4. Verstuur en wacht op moderatie. Een moderator controleert of de gegevens kloppen, en de status op je vermeldingskaart wordt bijgewerkt naarmate het door de beoordeling gaat.
5. Zodra het is geaccepteerd, configureer je server om heartbeats te sturen met de discovery-token op je vermeldingskaart.

Vermeldingen worden beoordeeld in volgorde van binnenkomst. De studio kiest ook zelf uitgelichte servers om aan de community te tonen.

Heartbeats

Je server bewijst dat hij leeft door heartbeats te sturen met de discovery-token van je vermeldingskaart. Het genereren van die token is een eenvoudig commando dat je als OP uitvoert, in de console of in de chat, om de koppeling te voltooien.

Als je server meer dan twee minuten geen heartbeats stuurt, wordt hij verborgen uit vermeldingen tot hij weer terug is. Dat is een verstandig ontwerp, en het betekent dat een haperende server stilletjes uit Discovery verdwijnt in plaats van spelers te frustreren die proberen te joinen.

OPMERKING - De eerste versie van Discovery is doelbewust minimaal. Vermeldingen bestaan uit naam, beschrijving en tags, zonder aangepaste iconen, banners of rijke media. Er is ook geen live spelersaantal of beoordeling, wat de studio bewust heeft achtergehouden zodat servers deze niet konden vervalsen of manipuleren.

Server Operator Policies

Hypixel Studios publiceert Server Operator Policies die gelden voor iedereen die een Hytale-server host, niet alleen vermelde servers. Ze zijn het waard om goed te lezen als je iets publieks van plan bent. De hoofdpunten:

• Basisregels gelden voor elke operator. Vermelde servers in Discovery krijgen daar extra verplichtingen bovenop.
• Vermelde servers hebben geverifieerde operatorgegevens nodig, een responsdoel van 24 uur voor urgente veiligheidsmeldingen waar redelijkerwijs mogelijk, technische en kwaliteitsminima, en accurate content-zelfclassificatie met ouderlijk toezicht.
• Verboden op alle servers: seksuele inhoud, NFT's, uitbuitende blockchain- of cryptoregelingen, en gokken om echt geld. Cryptocurrency accepteren als betaalmethode is toegestaan.
• Vermelde servers moeten officiële cosmetics ondersteunen, met beperkte thema-overschrijvingen toegestaan indien openbaar gemaakt.

Monetisatie En Omzetdeling

Als je op je server geld vraagt voor iets, dan is deze sectie op jou van toepassing.

• Monetisatie moet waarheidsgetrouw en legaal zijn. All Ages-servers mogen alleen gezinsvriendelijke advertenties tonen. Teen-, mature- en adult-servers moeten aankopen die gameplay beïnvloeden duidelijk vermelden.
• Betaalde random items vereisen gepubliceerde numerieke kansen, een "expected cost"-vermelding, en twaalf maanden aan administratie. Dubbele random-aankopen zijn volledig verboden.
• Revenue share geldt voor alle monetiserende servers, en bedraagt 0% voor de eerste twee jaar, tot 13 januari 2028.

Dat laatste punt is een echte deadline die het waard is om te noteren als je iets commercieels aan het bouwen bent.

LET OP - Waar dit beleid conflicteert met de Hytale EULA of Terms of Service, hebben de EULA en ToS voorrang, behalve waar het beleid expliciet is aangewezen als Additional Terms voor listed servers.

Poortforwarding

Hytale heeft nog geen standaard serverpoort gepubliceerd in zijn openbare documentatie, dus controleer de configuratie van je eigen server in plaats van te vertrouwen op een nummer dat je ergens hebt gelezen.

De algemene aanpak is hetzelfde als bij elke andere game server:

1. Zoek de poort waarop je server luistert, via de config of de opstartoutput.
2. Forward deze op je router naar het interne IP van de servermachine.
3. Sta het toe via de OS-firewall.

# Debian/Ubuntu with ufw, substituting your actual port
sudo ufw allow <port>/tcp

# Fedora/RHEL with firewalld
sudo firewall-cmd --permanent --add-port=<port>/tcp
sudo firewall-cmd --reload

Domeinverificatie voor Discovery gebruikt een TXT DNS-record in plaats van iets netwerk-gerichts, dus daarvoor hoeven geen poorten geopend te worden.

De server draaiend houden op Linux

Zodra je een werkend startcommando hebt, verpak je het zo dat het verbindingsverlies en herstarts overleeft.

De snelle versie met screen:

screen -S hytale ./start.sh

Detach met CTRL + A gevolgd door D, en reattach met screen -r hytale.

De nette versie, als een systemd-unit op /etc/systemd/system/hytale.service:

[Unit]
Description=Hytale Dedicated Server
After=network.target

[Service]
Type=simple
User=hytale
WorkingDirectory=/home/hytale/server
ExecStart=/home/hytale/server/start.sh
Restart=on-failure
RestartSec=15
KillSignal=SIGINT
TimeoutStopSec=120

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now hytale

KillSignal=SIGINT en een ruime TimeoutStopSec geven de server de tijd om de wereld op te slaan bij afsluiten, in plaats van halverwege een schrijfactie te worden gedood. Dat is belangrijker dan het klinkt.

Volg de log met journalctl -u hytale -f.

Back-ups

Hytale adverteert geen automatisch back-upsysteem zoals Valheim dat doet, dus beschouw back-ups als jouw verantwoordelijkheid.

Maak volgens een schema een back-up van de gehele serverdatamap, inclusief werelden en mods. Een cronjob met rsync of tar naar een andere schijf is ruim voldoende:

0 */6 * * * tar czf /backups/hytale-$(date +\%Y\%m\%d-\%H\%M).tar.gz /home/hytale/server/UserData

Twee Hytale-specifieke redenen waarom dit extra belangrijk is:

• Early access. Updates komen wekelijks uit tijdens de pre-release en dingen breken daadwerkelijk.
• Mods schrijven in werelden. Het verwijderen van een mod die blokken of entiteiten heeft toegevoegd, kan een wereld in slechte staat achterlaten, net als bij elke andere block game.

Maak een back-up vóór elke update, niet alleen volgens een schema.

Je eigen plugins schrijven

Als je serieus een server gaat draaien, schrijf je uiteindelijk zelf iets ervoor.

Hytale-plugins zijn in Java, en de Server API-documentatie wordt gegenereerd vanuit de server zelf, en behandelt packages onder com.hypixel.hytale. De asset reference documenteert het JSON-formaat van elk asset dat de server laadt, gegenereerd vanuit de eigen codecs van de server.

Twee dingen die het waard zijn om te weten over de richting:

• Er is geen tekstgebaseerde scripting en dat zal ook niet komen. De studio betoogde dat Lua-achtige scripting een vals compromis is, waarbij programmeurs met twee talen moeten jongleren en designers nog moeten leren programmeren.
• Visual scripting is het plan in plaats daarvan, in de geest van Unreal Blueprints, waarbij programmeurs het uitbreiden door nieuwe nodes vanuit Java bloot te leggen. De Trigger Volume tool die met Update 5 uitkwam, is hier een vroeg onderdeel van, en werd expliciet gebouwd met modondersteuning zodat modders hun eigen effecten kunnen toevoegen.

Probleemoplossing

Ik kan de download van de dedicated server niet vinden. Zoals hierboven vermeld, is er nog geen gepubliceerde handleiding voor het opzetten van een standalone server. Kijk op accounts.hytale.com en vraag het in de officiële Discord.

Mijn listing verschijnt niet in Discovery. Controleer de status op de listing card. Het kan nog in de moderatiewachtrij staan, wat traag kan gaan tijdens een lanceringsgolf. Als het is geaccepteerd en daarna verdwenen, stuurt je server waarschijnlijk geen heartbeats meer.

Spelers zeggen dat ze mods nodig hebben om te joinen. Dat is niet zo. Hytale-modding is server-side, en iedereen die je iets anders vertelt, heeft het over een andere game.

Een configuratie-instelling is teruggezet na een update. Lees de patch notes. Config keys zijn tussen updates hernoemd en verwijderd, en een hernoemde key betekent dat jouw waarde wordt genegeerd.

De server start niet meer op na een update. Controleer welke Java-versie de huidige build verwacht, en lees de patch notes voor breaking changes. Als het meteen na het toevoegen van een plugin misging, haal de plugin er dan uit en test opnieuw.

Linux-kernel te oud. Hytale vraagt om kernel 6.15 x64. Verschillende LTS-distributies leveren standaard een oudere versie. Controleer met uname -r.

Kan ik een server draaien op macOS? De client is alleen Apple Silicon op macOS, en de serverkant is het minst gedocumenteerde deel van een toch al jonge game. Een Linux VM of een gehuurde machine is de weg van de minste weerstand.

Conclusie

Het servermodel van Hytale is het duidelijkste van alle games in deze gidsen, zodra het kernidee eenmaal duidelijk is: elke wereld is een server, mods worden eenmalig door de host geïnstalleerd, en spelers joinen met een vanilla client en verder niets.

Voor een groepje vrienden is hosten vanuit de client met een uitnodigingscode werkelijk voldoende. Voor iets persistents en publieks zijn Server Discovery en de Server Operator Policies de onderdelen die vandaag volledig gedocumenteerd zijn, en beide zijn het waard om zorgvuldig te lezen voordat je iets lanceert. De standalone serverconfiguratie zelf is het onderdeel dat nog wacht op officiële documentatie, en de Discord is het eerlijke antwoord totdat die er is.

We zullen deze sectie netjes herschrijven zodra Hypixel Studios die publiceren.

Zie Ook

• Hytale Documentation - De officiële docs-hub voor het draaien van servers en het bouwen van mods.
• Hytale Server API reference - De Java API, voor plugin-ontwikkelaars.
• Asset reference - Het JSON-formaat van elke asset die de server laadt.
• Server Operator Policies - Verplichte kost voor iedereen die publiekelijk host.
• Hytale Account Manager - Waar Server Profiles en Discovery-listings zich bevinden.
• Official Server Lists announcement - Het volledige Discovery-proces, en de bron voor die sectie.
• Hytale Modding Strategy and Status
• Official Hytale Discord
• Hytale Wiki
• TMC App - Onze eigen app, met een serverbrowser, live latency-grafieken en RCON. Open source onder GPL-3.0 en nog in een zeer vroeg ontwikkelingsstadium, dus het uitproberen ervan of feedback achterlaten wordt oprecht gewaardeerd.

Hytale bevindt zich in early access en ontwikkelt zich snel, dus deze gids zal vaker bijgewerkt moeten worden dan de meeste. Als je een instructie tegenkomt die niet meer overeenkomt met wat je ziet, of je hebt een standalone server opgezet en kunt de hierboven genoemde gaten opvullen, meld dit dan of open een pull request op de GitHub-repository van deze gids. Bijdragen aan juist deze gids zouden oprecht nuttig zijn.

Join onze Discord server als je vragen hebt of hulp wilt met iets rondom servers of modding!