Een gids over het downloaden en installeren van mods in Hytale op Windows, Linux en macOS.
Hytale-modding werkt anders dan bij vrijwel elke andere game waarvoor we deze gidsen schrijven, en het verschil is de moeite waard om te begrijpen voordat je iets downloadt. Hypixel Studios heeft Hytale server-side first gebouwd. Mods worden geïnstalleerd door degene die de wereld host, niet door elke speler afzonderlijk, en de studio heeft duidelijk gezegd dat ze niet van plan zijn client mods te ondersteunen.
Dat klinkt beperkend totdat je beseft wat het je oplevert: je kunt elke gemodde Hytale-server joinen zonder ook maar iets te installeren. Geen client packs, geen versies jongleren, geen launcher profielen.
Ons voorbeeld is BetterMap, een server plugin die de in-game kaart permanente verkenning, waypoints en grotweergave geeft.
Vereisten
- Een pc met Windows, Linux of macOS. Hytale heeft native builds voor alle drie.
- Een exemplaar van Hytale, gekocht via hytale.com. De game is in early access en staat niet op Steam.
- Genoeg vrije ruimte voor wat je ook installeert. Asset packs met veel modellen en textures kunnen groot worden; plugins zijn meestal klein.
- Een
.zip-extractor, hoewel je in veel gevallen helemaal niets hoeft uit te pakken.
NOTE - Hytale is sinds januari 2026 in early access en beweegt nog steeds snel. Hypixel Studios is openlijk zelfkritisch geweest over de staat van de modding tools, en beschrijft hiaten in de documentatie en systemen die nog ruw zijn. Verwacht dat dingen veranderen, en verwacht dat een mod af en toe kapot gaat na een update.
Server-Side Modding Uitgelegd
Hypixel Studios heeft een paar principes uiteengezet toen ze hun modding-strategie publiceerden, en twee daarvan bepalen alles in deze gids:
- Server-side first. Alle Hytale-modding is gebaseerd op de host van de server of de host van de game. Je zou elke gemodde Hytale-server moeten kunnen joinen zonder externe mods te downloaden of client packs te jongleren.
- Eén community, één client. Ze willen een ecosysteem vermijden waarin elke server zijn eigen gemodde client nodig heeft, zodat de client stabiel en consistent blijft terwijl servers voor de variatie zorgen.
In de praktijk betekent dit dat een mod eenmalig wordt geïnstalleerd, door de host, en dat elke speler die verbinding maakt de gemodde ervaring krijgt met een volledig vanilla client.
Singleplayer Is Ook Een Server
Dit is het stukje dat de rest logisch maakt.
Hytale heeft geen aparte singleplayer-modus in de traditionele zin. Wanneer je een singleplayer wereld aanmaakt, join je een lokale server die alleen voor jou is. Dus "de host" ben jij, en het installeren van mods voor singleplayer is dezelfde handeling als het installeren ervan op een server, in een andere map.
Je kiest vervolgens per savegame welke mods je wilt, wat een oprecht fijn model is: één wereld met een overhaul, een andere vanilla, geen profielen wisselen.
De Gemodde Server Van Iemand Anders Joinen
Je installeert niets. Verbind met de server en speel.
De plugins en asset packs van de host bepalen de ervaring en jouw client rendert wat de server ook aangeeft. Dit is waarom de in-game serverbrowser compatibiliteitscontroles kan uitvoeren en je alleen servers laat zien die je daadwerkelijk kunt joinen.
De Vier Soorten Hytale Mods
Hytale-modding valt uiteen in vier technische categorieën, en weten met welke je te maken hebt, vertelt je wat je kunt verwachten.
| Soort | Formaat | Wat het doet |
|---|---|---|
| Serverplugins | Java .jar |
Breidt de server programmatisch uit. Minigames, economieën, commando's, aangepaste logica. De krachtigste categorie. |
| Data-assets | JSON | Definiëren kerncontent: blocks, items, NPC's, wereldgeneratie, loot- en droptables. |
| Art-assets | Modellen, textures, geluiden | Het uiterlijk en geluid van alles. Hytale ondersteunt Blockbench voor modellen en animaties. |
| Savebestanden | Werelden en prefabs | Hele werelden, of vooraf gebouwde structuren die worden gebruikt in creatieve tools en wereldgeneratie. |
Asset Packs zijn het verpakkingsformaat voor de middelste twee. Een asset pack is een zip of een map met daarin een manifest.json, met een aangepaste set assets die de basisgame overschrijven of aanvullen. Ze kunnen worden gemaakt in de in-game Asset Editor of handmatig in een bestandsverkenner, hoewel de studio de editor aanraadt omdat de mapstructuur strikt is.
BetterMap is een server plugin, dus valt het onder de eerste categorie.
NOTE - Er is geen Lua of andere tekstgebaseerde scripting in Hytale, en de studio heeft gezegd dat dit er ook niet komt. Hun plan is visual scripting, in de geest van Unreal Blueprints, naast Java voor programmeurs.
Waar Mods Naartoe Gaan
Twee locaties zijn van belang.
De globale mods-map, gebruikt door alles:
C:\Users\<user>\AppData\Roaming\Hytale\UserData\Mods
De per-wereld mods-map, die elke savegame ook heeft:
C:\Users\<user>\AppData\Roaming\Hytale\UserData\Saves\<World Name>\mods
Op Linux en macOS bevindt de UserData-map zich op de equivalente locatie voor applicatiegegevens van jouw systeem, met dezelfde structuur eronder.
Alles in de globale Mods-map is beschikbaar voor elke wereld. Alles in de eigen mods-map van een wereld hoort alleen bij die wereld.
TIP - Plak op Windows %appdata%\Hytale\UserData in de adresbalk van Verkenner om er direct naartoe te gaan.
Een Mod Installeren Voor Singleplayer
- Ga naar CurseForge's Hytale-sectie en zoek een mod. Voor deze gids openen we BetterMap.
- Download hem.
- Open je
UserData\Mods-map. - Zet het gedownloade bestand erin. Asset packs mogen gezipt blijven of als map uitgepakt worden; plugins gaan erin als
.jar. - Start Hytale.
- Open het New World-menu en kijk onder Options. Je geïnstalleerde mods en asset packs verschijnen daar.
- Schakel de mods in die je voor deze wereld wilt, en maak de wereld aan.
Die laatste stap is degene die mensen missen. Door een mod in de map te zetten, maak je hem beschikbaar; je kiest hem nog steeds per wereld op het moment dat je die wereld aanmaakt.
CurseForge is de belangrijkste host, wat niet verrassend is aangezien Hypixel Studios daar hun New Worlds Modding Contest van $100.000 mee organiseerde. Er stonden begin 2026 meer dan 5.000 Hytale-mods op het platform, samen goed voor meer dan 20 miljoen downloads.
Een mod installeren op een dedicated server
Voor een server die je voor anderen host, is het idee identiek en is de map die van de server zelf.
- Download de mod.
- Plaats hem in de
mods-map van de server. - Herstart de server.
BetterMap bewaart alles wat het nodig heeft daar, en maakt bij de eerste run mods/bettermap/ aan voor zijn configuratie en data.
Spelers die verbinding maken met jouw server hoeven niets te installeren. Dat is precies het hele punt van dit model.
Als je nog moet beginnen met het opzetten van een server, behandelt onze aparte Hytale-servergids dat.
Installeren met de TMC App
Omdat er nog geen Hytale-modmanager bestaat, is dit het vermelden waard. De TMC App is onze eigen modmanager en serverbrowser, met installatie in één klik en sandboxes: benoemde modprofielen per game, elk met eigen laadvolgorde en implementatiemethode, te wisselen zonder iets opnieuw te downloaden.
Hytale staat nog niet op de lijst met ondersteunde games, maar het is een goede match. De app werkt door te weten waar de mods van een game naartoe gaan en hoe die game start, allebei vastgelegd in vier JSON-bestanden in plaats van code, en Hytale's UserData\Mods-map zonder loader is zo ongeveer het eenvoudigste doelwit dat dat systeem kan hebben. Sandboxes zouden ook naadloos aansluiten op Hytale's per-wereld modselectie.
Het eerlijke verhaal: de app bevindt zich in een zeer vroege ontwikkelingsfase. In de README staat dat hij gedeeltelijk getest is, en dat gaan we niet mooier voorstellen dan het is. Hytale zelf is early access en verandert wekelijks, dus dit zijn twee jonge dingen die naar elkaar wijzen. Als je daarvoor openstaat, is het proberen en terugkoppelen ervan echt nuttig.
Het is open source onder GPL-3.0 op github.com/modcommunity/tmc-app. Bugmeldingen en feature-verzoeken gaan naar de issue tracker, pull requests zijn welkom, en de repository documenteert het per-game-formaat als je Hytale-ondersteuning wilt bijdragen voordat wij eraan toekomen.
Installeren:
- Linux: één regel, geen root en geen pakketbeheerder nodig.
curl -fsSL https://raw.githubusercontent.com/modcommunity/tmc-app/main/scripts/install.sh | sh
- Windows: de
setup.exeofsetup.msivan de releasepagina. Er is ook een portable build, al registreert die het launcher-item of detmc://-linkhandler niet. - macOS: de
.dmgvan dezelfde releasepagina.
Mods configureren
Er is geen enkele vaste standaard, maar het gangbare patroon is een JSON-configuratie binnen de eigen map van de mod onder mods.
BetterMap is een goed voorbeeld. De instellingen staan in mods/bettermap/config.json, en de mod biedt zaken als verkenningsradius, kaartkwaliteit, updatefrequentie en of verkenning tussen spelers gedeeld wordt:
{
"explorationRadius": 16,
"updateRateMs": 500,
"mapQuality": "MEDIUM",
"shareAllExploration": false,
"radarEnabled": true
}
Goed gebouwde plugins voegen ook adminopdrachten en rechten toe. BetterMap registreert /bm-commando's, waaronder /bm reload om configwijzigingen door te voeren zonder herstart, al vermeldt het dat sommige instellingen nog steeds een volledige herstart vereisen.
Lees de CurseForge-beschrijving van de mod. Aangezien Hytale-modding nog zo jong is, is die pagina heel vaak de enige documentatie die er is.
Mods per wereld
Asset packs die in-game met de Asset Editor gemaakt zijn, belanden in de eigen mods-map van die wereld in plaats van in de globale map. Dat is handig terwijl je iets aan het bouwen bent, maar verwarrend de eerste keer dat je een tweede wereld start en je afvraagt waar je pack gebleven is.
Om een pack dat je in de ene wereld hebt gemaakt in een andere wereld te gebruiken, kopieer je hem van:
UserData\Saves\<World Name>\mods
naar:
UserData\Mods
Zodra hij in de globale map staat, verschijnt hij in de opties voor elke nieuwe wereld.
Platforms
Hytale ging in early access op Windows, macOS en Linux, en dat is de complete lijst. Er is geen console- of mobiele versie, en de game staat niet op Steam.
Cross-platform spelen tussen die drie desktopplatforms is aanwezig, en bredere cross-platform ondersteuning maakt al deel uit van het plan sinds de game opnieuw werd overgenomen, maar er bestaat vandaag niets buiten desktop om mods op te installeren.
Mods updaten en verwijderen
Er is nog geen modmanager voor Hytale, dus beide gebeuren handmatig.
- Updaten: download de nieuwe versie van CurseForge en vervang het oude bestand in
Mods. Controleer de pagina van de mod om te zien of je configuratie behouden blijft. - Verwijderen: verwijder het bestand uit
Mods, of schakel de mod gewoon uit voor een bepaalde wereld. - Uitschakelen voor slechts één wereld: laat het bestand staan en vink het uit in de opties van die wereld.
WAARSCHUWING - Het verwijderen van een mod die blokken, items of wezens toevoegde uit een wereld die deze gebruikte, kan die wereld in een slechte staat achterlaten, net als in elke andere blokkengame. Maak een back-up van de savemap voordat je mods uit een bestaande wereld verwijdert.
Probleemoplossing
Mijn mod verschijnt niet in de New World-opties. Verkeerde map. Hij moet in UserData\Mods staan of in de eigen mods-map van die wereld, en een asset pack heeft een geldige manifest.json nodig.
Ik heb een mod geïnstalleerd, maar de wereld waarin ik al zit is niet veranderd. Mods worden geselecteerd op het moment dat een wereld wordt aangemaakt. Bestaande werelden nemen nieuw geïnstalleerde mods niet vanzelf over.
Het pack dat ik in-game heb gemaakt ontbreekt in mijn andere wereld. Asset Editor-packs worden opgeslagen bij de wereld waarin je ze hebt gemaakt. Kopieer het pack naar de globale Mods-map.
Een plugin laadt, maar de commands doen niets. Controleer de permissions. Hytale-plugins gebruiken permission nodes, en commands hebben meestal OP of een expliciete toekenning nodig.
Alles is stuk na een Hytale-update. In dit stadium te verwachten. Hytale draait wekelijkse pre-release patches die elke paar weken samengevoegd worden in stabiele releases, en mods hebben tijd nodig om bij te blijven.
Spelers zeggen dat ze de mod moeten installeren om mee te kunnen doen. Dat hoeft niet. Als iemand anders beweert, beschrijft die persoon hoe een ander spel werkt.
Kan ik client mods gebruiken? Nee. Er is geen ondersteuning voor client mods en de studio heeft aangegeven dat daar ook geen plannen voor zijn.
Conclusie
Hytale-modding draait om één idee: de host installeert, iedereen speelt gewoon. Zet het bestand in UserData\Mods, vink het aan wanneer je een wereld maakt, en je bent klaar. Voor een dedicated server is het hetzelfde bestand, in de eigen mods-map van de server.
Het is een oprecht ander model dan de BepInEx- en mod loader-opzetten uit onze andere gidsen, en zodra het klikt is het veel minder werk. De tooling is jong en de documentatie is onvolledig, wat Hypixel Studios zelf ook toegeven, dus vertrouw op mod-beschrijvingen en docs.hytale.com terwijl de dingen zich uitkristalliseren.
Als je ergens mee wilt helpen: de TMC App is open source, nog in een heel vroeg ontwikkelingsstadium, en feedback erop wordt oprecht gewaardeerd.
Zie Ook
- Hytale op CurseForge
- Hytale Documentatie - Officiële documentatie voor het draaien van servers en het bouwen van mods.
- Content Maken In Hytale - Asset packs, wereldgeneratie en de editors.
- Hytale Modding Strategie En Status - Het eigen verhaal van de studio over waar modding staat en waar het naartoe gaat. Zeker de moeite waard om volledig te lezen.
- Officiële Hytale Discord
- Hytale Wiki
- TMC App
Hytale is early access en verandert snel, dus deze gids zal meer verouderen dan de meeste. Als je een instructie tegenkomt die niet meer overeenkomt met wat je ziet, meld dit dan of open een pull request op de GitHub-repository van deze gids.
Sluit je aan bij onze Discord-server als je vragen hebt of hulp wilt met iets moddingrelateerd!

