Eine Anleitung zum Herunterladen und Installieren von Mods für Hytale unter Windows, Linux und macOS.
Hytale-Modding funktioniert anders als bei fast jedem anderen Spiel, für das wir diese Anleitungen schreiben, und es lohnt sich, den Unterschied zu verstehen, bevor man irgendetwas herunterlädt. Hypixel Studios hat Hytale server-seitig zuerst aufgebaut. Mods werden von demjenigen installiert, der die Welt hostet, nicht von jedem einzelnen Spieler, und das Studio hat unmissverständlich erklärt, dass es Client-Mods überhaupt nicht unterstützen will.
Das klingt einschränkend, bis man erkennt, was es einem bringt: Man kann jedem modifizierten Hytale-Server beitreten, ohne irgendetwas zu installieren. Keine Client-Packs, kein Versions-Jonglieren, keine Launcher-Profile.
Unser Beispiel ist BetterMap, ein Server-Plugin, das der Karte im Spiel dauerhafte Erkundung, Wegpunkte und Höhlen-Rendering verleiht.
Voraussetzungen
- Ein PC mit Windows, Linux oder macOS. Hytale hat native Builds für alle drei.
- Eine Kopie von Hytale, gekauft über hytale.com. Das Spiel befindet sich im Early Access und ist nicht bei Steam erhältlich.
- Genug freier Speicherplatz für das, was man installiert. Asset-Packs mit vielen Modellen und Texturen können groß werden; Plugins sind meist klein.
- Ein
.zip-Entpacker, auch wenn man in vielen Fällen gar nichts entpacken muss.
HINWEIS - Hytale befindet sich seit Januar 2026 im Early Access und entwickelt sich weiterhin schnell. Hypixel Studios hat sich offen selbstkritisch zum Zustand der Modding-Tools geäußert und Lücken in der Dokumentation sowie noch grobe Systeme beschrieben. Man sollte mit Änderungen rechnen und damit, dass ein Mod nach einem Update gelegentlich kaputtgeht.
Server-seitiges Modding erklärt
Hypixel Studios hat bei der Veröffentlichung ihrer Modding-Strategie ein paar Prinzipien dargelegt, und zwei davon prägen alles in dieser Anleitung:
- Server-seitig zuerst. Alles Hytale-Modding basiert auf dem Host des Servers bzw. dem Host des Spiels. Man sollte jedem modifizierten Hytale-Server beitreten können, ohne externe Mods herunterzuladen oder mit Client-Packs jonglieren zu müssen.
- Eine Community, ein Client. Man möchte ein Ökosystem vermeiden, in dem jeder Server seinen eigenen modifizierten Client benötigt, sodass der Client stabil und einheitlich bleibt, während die Server für die Abwechslung sorgen.
In der Praxis bedeutet das: Ein Mod wird einmal vom Host installiert, und jeder verbindende Spieler erhält das modifizierte Erlebnis mit einem völlig unveränderten Client.
Einzelspieler ist auch ein Server
Das ist der Punkt, der alles andere verständlich macht.
Hytale hat keinen separaten Einzelspielermodus im klassischen Sinne. Wenn man eine Einzelspieler-Welt erstellt, tritt man einem lokalen Server bei, der nur für einen selbst da ist. „Der Host
Man wählt dann pro Spielstand aus, welche Mods man haben möchte, was ein wirklich schönes Modell ist: eine Welt mit einem Overhaul, eine andere vanilla, ohne Profilwechsel.
Einem modifizierten Server eines anderen beitreten
Du installierst nichts. Verbinde dich mit dem Server und spiele.
Die Plugins und Asset Packs des Hosts bestimmen das Erlebnis, und dein Client rendert einfach das, was der Server ihm vorgibt. Deshalb kann der Server-Browser im Spiel Kompatibilitätsprüfungen durchführen und dir nur Server anzeigen, denen du tatsächlich beitreten kannst.
Die vier Arten von Hytale-Mods
Hytale-Modding gliedert sich in vier technische Kategorien, und zu wissen, mit welcher man es zu tun hat, sagt einem, was zu erwarten ist.
| Art | Format | Was es macht |
|---|---|---|
| Server-Plugins | Java .jar |
Erweitern den Server programmatisch. Minispiele, Ökonomien, Befehle, eigene Logik. Die mächtigste Kategorie. |
| Data Assets | JSON | Definieren Kerninhalte: Blöcke, Items, NPCs, Weltgenerierung, Loot- und Drop-Tabellen. |
| Art Assets | Modelle, Texturen, Sounds | Das Aussehen und der Klang von allem. Hytale unterstützt Blockbench für Modelle und Animationen. |
| Save Files | Welten und Prefabs | Ganze Welten oder vorgefertigte Strukturen, die in Kreativ-Tools und Weltgenerierung verwendet werden. |
Asset Packs sind das Verpackungsformat für die mittleren beiden. Ein Asset Pack ist ein Zip-Archiv oder ein Ordner mit einer manifest.json darin, der einen eigenen Satz von Assets enthält, die den Basisinhalt des Spiels überschreiben oder ergänzen. Sie können im Asset Editor im Spiel oder von Hand in einem Dateibrowser erstellt werden, wobei das Studio den Editor empfiehlt, da die Ordnerstruktur strikt vorgegeben ist.
BetterMap ist ein Server-Plugin und fällt somit in die erste Kategorie.
HINWEIS - Es gibt kein Lua oder eine andere textbasierte Skriptsprache in Hytale, und das Studio hat erklärt, dass es das auch nicht geben wird. Ihr Plan ist visuelles Scripting im Sinne von Unreal Blueprints, ergänzt durch Java für Programmierer.
Wo Mods hingehören
Zwei Speicherorte sind hier wichtig.
Der globale Mods-Ordner, der von allem verwendet wird:
C:\Users\<user>\AppData\Roaming\Hytale\UserData\Mods
Der Mods-Ordner pro Welt, den auch jeder Spielstand besitzt:
C:\Users\<user>\AppData\Roaming\Hytale\UserData\Saves\<World Name>\mods
Unter Linux und macOS befindet sich der Ordner UserData am entsprechenden Speicherort für Anwendungsdaten deines Systems, mit derselben Struktur darunter.
Alles im globalen Ordner Mods steht jeder Welt zur Verfügung. Alles im eigenen mods-Ordner einer Welt gehört ausschließlich dieser Welt.
TIPP - Füge unter Windows %appdata%\Hytale\UserData in die Adressleiste des Datei-Explorers ein, um direkt dorthin zu gelangen.
Einen Mod für Singleplayer installieren
- Geh zu CurseForges Hytale-Bereich und suche einen Mod. Öffne für diese Anleitung BetterMap.
- Lade ihn herunter.
- Öffne deinen
UserData\Mods-Ordner. - Lege die heruntergeladene Datei dort ab. Asset Packs können gezippt bleiben oder als Ordner entpackt werden; Plugins kommen als
.jarhinein. - Starte Hytale.
- Öffne das Menü New World und schau unter Options nach. Deine installierten Mods und Asset Packs erscheinen dort.
- Aktiviere die, die du für diese Welt willst, und erstelle sie.
Diesen letzten Schritt übersehen viele. Einen Mod in den Ordner zu legen macht ihn nur verfügbar; du wählst ihn trotzdem pro Welt aus, wenn die Welt erstellt wird.
CurseForge ist der Haupt-Host, was wenig überraschend ist, da Hypixel Studios ihren mit 100.000 $ dotierten New Worlds Modding Contest dort veranstaltet hat. Anfang 2026 gab es über 5.000 Hytale-Mods auf der Plattform mit zusammen mehr als 20 Millionen Downloads.
Einen Mod auf einem dedizierten Server installieren
Für einen Server, den du für andere Leute betreibst, ist das Prinzip identisch, nur ist es der Ordner des Servers selbst.
- Lade den Mod herunter.
- Lege ihn in das
mods-Verzeichnis des Servers. - Starte den Server neu.
BetterMap hält alles Nötige dort vor und erstellt beim ersten Start mods/bettermap/ für seine Konfiguration und Daten.
Spieler, die sich mit deinem Server verbinden, müssen nichts installieren. Das ist der ganze Sinn dieses Modells.
Wenn du überhaupt erst einen Server aufsetzt, deckt unsere separate Hytale-Server-Anleitung das ab.
Installation mit der TMC App
Da es noch keinen Hytale-Mod-Manager gibt, ist das erwähnenswert. Die TMC App ist unser eigener Mod-Manager und Server-Browser, mit One-Click-Installationen und Sandboxes: benannte Mod-Profile pro Spiel, jedes mit eigener Ladereihenfolge und Bereitstellungsmethode, umschaltbar ohne erneuten Download.
Hytale steht noch nicht in der Liste der unterstützten Spiele, passt aber gut. Die App funktioniert, indem sie weiß, wohin die Mods eines Spiels gehören und wie es startet – beides sind vier JSON-Dateien statt Code – und Hytales UserData\Mods-Ordner ohne Loader ist ein so einfaches Ziel, wie es für dieses System nur geht. Sandboxes würden sich auch nahtlos auf Hytales Mod-Auswahl pro Welt übertragen lassen.
Ehrlich gesagt: die App befindet sich in einer sehr frühen Entwicklungsphase. Ihre README sagt, dass sie nur teilweise getestet ist, und das beschönigen wir nicht. Hytale selbst befindet sich im Early Access und entwickelt sich wöchentlich weiter, das heißt hier treffen zwei junge Dinge aufeinander. Wenn dich das reizt, ist es wirklich hilfreich, es auszuprobieren und Rückmeldung zu geben.
Sie ist Open Source unter GPL-3.0 unter github.com/modcommunity/tmc-app. Bug-Reports und Feature-Wünsche gehören in den Issue-Tracker, Pull Requests sind willkommen, und das Repository dokumentiert das Format pro Spiel, falls du Hytale-Unterstützung beisteuern möchtest, bevor wir dazu kommen.
Installation:
- Linux: eine Zeile, kein Root und kein Paketmanager nötig.
curl -fsSL https://raw.githubusercontent.com/modcommunity/tmc-app/main/scripts/install.sh | sh
- Windows: die
setup.exeodersetup.msivon der Releases-Seite. Es gibt auch einen portablen Build, der jedoch weder den Launcher-Eintrag noch dentmc://-Link-Handler registriert. - macOS: die
.dmgvon derselben Releases-Seite.
Mods konfigurieren
Es gibt keinen einheitlichen Standard, aber das gängige Muster ist eine JSON-Konfiguration im eigenen Ordner des Mods unter mods.
BetterMap ist ein gutes Beispiel. Seine Einstellungen liegen in mods/bettermap/config.json und bieten Dinge wie Erkundungsradius, Kartenqualität, Aktualisierungsrate und ob die Erkundung zwischen Spielern geteilt wird:
{
"explorationRadius": 16,
"updateRateMs": 500,
"mapQuality": "MEDIUM",
"shareAllExploration": false,
"radarEnabled": true
}
Gut gebaute Plugins fügen außerdem Admin-Befehle und Berechtigungen hinzu. BetterMap registriert /bm-Befehle, darunter /bm reload, um Konfigurationsänderungen ohne Neustart zu übernehmen, wobei manche Einstellungen laut Hinweis trotzdem einen vollständigen Neustart benötigen.
Lies die CurseForge-Beschreibung des Mods. Da Hytale-Modding noch so jung ist, ist diese Seite sehr oft die einzige verfügbare Dokumentation.
Mods pro Welt
Asset Packs, die im Spiel mit dem Asset Editor erstellt werden, landen im eigenen mods-Ordner dieser Welt statt im globalen. Das ist praktisch, während man etwas baut, aber verwirrend, wenn man das erste Mal eine zweite Welt startet und sich fragt, wo das eigene Pack geblieben ist.
Um ein in einer Welt erstelltes Pack in einer anderen Welt zu nutzen, kopiere es von:
UserData\Saves\<World Name>\mods
nach:
UserData\Mods
Sobald es im globalen Ordner liegt, erscheint es in den Optionen jeder neuen Welt.
Plattformen
Hytale ist mit Early Access auf Windows, macOS und Linux gestartet, und das ist die vollständige Liste. Es gibt keine Konsolen- oder Mobile-Version, und das Spiel ist nicht auf Steam erhältlich.
Cross-Platform-Play zwischen diesen drei Desktop-Plattformen ist vorhanden, und breitere Cross-Platform-Unterstützung war seit der Rückübernahme des Spiels Teil des Plans, aber jenseits von Desktop gibt es heute nichts, worauf man Mods installieren könnte.
Mods aktualisieren und entfernen
Es gibt noch keinen Mod-Manager für Hytale, daher ist beides manuell.
- Aktualisieren: Lade die neue Version von CurseForge herunter und ersetze die alte Datei in
Mods. Prüfe die Mod-Seite, ob deine Konfiguration übernommen wird. - Entfernen: Lösche die Datei aus
Mods, oder deaktiviere den Mod einfach für eine bestimmte Welt. - Nur für eine Welt deaktivieren: Lasse die Datei, wo sie ist, und deaktiviere sie in den Optionen dieser Welt.
WARNUNG - Das Entfernen eines Mods, der Blöcke, Items oder Kreaturen hinzugefügt hat, aus einer Welt, die diese verwendet hat, kann diese Welt in einen fehlerhaften Zustand versetzen, genau wie in jedem anderen Block-Spiel. Sichere den Save-Ordner, bevor du Mods aus einer bestehenden Welt entfernst.
Fehlerbehebung
Mein Mod taucht nicht in den New-World-Optionen auf. Falscher Ordner. Er muss in UserData\Mods oder im eigenen mods-Ordner dieser Welt liegen, und ein Asset Pack braucht eine gültige manifest.json.
Ich habe einen Mod installiert, aber die Welt, in der ich schon bin, hat sich nicht geändert. Mods werden bei der Erstellung einer Welt ausgewählt. Bestehende Welten übernehmen neu installierte Mods nicht von selbst.
Das Pack, das ich im Spiel erstellt habe, fehlt in meiner anderen Welt. Asset-Editor-Packs werden in der Welt gespeichert, in der du sie erstellt hast. Kopiere es in den globalen Mods-Ordner.
Ein Plugin lädt, aber seine Befehle tun nichts. Prüfe die Berechtigungen. Hytale-Plugins verwenden Permission Nodes, und Befehle benötigen in der Regel OP oder eine explizite Freigabe.
Nach einem Hytale-Update ist alles kaputt. In diesem Stadium zu erwarten. Hytale veröffentlicht wöchentliche Pre-Release-Patches, die alle paar Wochen zu stabilen Releases gebündelt werden, und Mods brauchen Zeit, um nachzuziehen.
Spieler sagen, sie müssten den Mod installieren, um beizutreten. Das müssen sie nicht. Wenn dir jemand etwas anderes erzählt, beschreibt er, wie ein anderes Spiel funktioniert.
Kann ich Client-Mods verwenden? Nein. Es gibt keine Unterstützung für Client-Mods, und das Studio hat erklärt, dass dafür keine Pläne bestehen.
Fazit
Hytale-Modding läuft auf eine einzige Idee hinaus: Der Host installiert, alle anderen spielen einfach. Lege die Datei in UserData\Mods, hake sie beim Erstellen einer Welt an, und fertig. Für einen dedizierten Server ist es dieselbe Datei im eigenen mods-Ordner des Servers.
Das ist ein wirklich anderes Modell als die BepInEx- und Mod-Loader-Setups in unseren anderen Anleitungen, und sobald man es verinnerlicht hat, ist es deutlich weniger Aufwand. Das Tooling ist jung und die Dokumentation lückenhaft, was Hypixel Studios auch offen zugibt, also verlasse dich in der Übergangszeit auf Mod-Beschreibungen und docs.hytale.com.
Wenn du helfen möchtest: Die TMC App ist Open Source, befindet sich in einem sehr frühen Entwicklungsstadium, und Feedback dazu wäre wirklich willkommen.
Siehe auch
- Hytale auf CurseForge
- Hytale-Dokumentation - Offizielle Dokumentation zum Betreiben von Servern und Erstellen von Mods.
- Inhalte erstellen in Hytale - Asset Packs, Weltgenerierung und die Editoren.
- Hytale Modding-Strategie und Status - Der Bericht des Studios selbst darüber, wo Modding heute steht und wohin es sich entwickelt. Lohnt sich, vollständig gelesen zu werden.
- Offizieller Hytale-Discord
- Hytale Wiki
- TMC App
Hytale befindet sich im Early Access und verändert sich schnell, daher wird diese Anleitung stärker veralten als die meisten anderen. Solltest du eine Anweisung finden, die nicht mehr mit dem übereinstimmt, was du siehst, melde es bitte oder eröffne einen Pull Request im GitHub-Repository dieser Anleitung.
Tritt unserem Discord-Server bei, wenn du Fragen hast oder Hilfe bei irgendetwas rund um Modding brauchst!

