Comment installer des mods dans Hytale (2026)

Un guide sur comment télécharger et installer des mods dans Hytale sur Windows, Linux et macOS.

Le modding sur Hytale fonctionne différemment de presque tous les autres jeux pour lesquels nous rédigeons ces guides, et cette différence mérite d'être comprise avant de télécharger quoi que ce soit. Hypixel Studios a conçu Hytale en donnant la priorité au côté serveur. Les mods sont installés par celui qui héberge le monde, pas par chaque joueur, et le studio a clairement indiqué qu'il n'avait pas l'intention de prendre en charge les mods côté client.

Cela peut sembler restrictif jusqu'à ce que vous réalisiez ce que cela vous apporte : vous pouvez rejoindre n'importe quel serveur Hytale moddé sans rien installer. Pas de packs client, pas de jonglage de versions, pas de profils de launcher.

Notre exemple est BetterMap, un plugin serveur qui donne à la carte en jeu une exploration persistante, des points de repère et un rendu des grottes.

Prérequis

• Un PC tournant sous Windows, Linux ou macOS. Hytale dispose de builds natifs pour les trois.
• Une copie de Hytale, achetée via hytale.com. Le jeu est en accès anticipé et n'est pas disponible sur Steam.
• Suffisamment d'espace libre pour tout ce que vous installez. Les asset packs contenant beaucoup de modèles et de textures peuvent devenir volumineux ; les plugins sont généralement petits.
• Un extracteur de .zip, même si dans de nombreux cas vous n'aurez rien à décompresser du tout.

NOTE - Hytale est en accès anticipé depuis janvier 2026 et évolue encore rapidement. Hypixel Studios a été ouvertement autocritique sur l'état des outils de modding, décrivant des lacunes dans la documentation et des systèmes encore peu aboutis. Attendez-vous à des changements, et à ce qu'un mod casse occasionnellement après une mise à jour.

Le modding côté serveur expliqué

Hypixel Studios a énoncé quelques principes lors de la publication de leur stratégie de modding, et deux d'entre eux structurent tout ce guide :

• Priorité au serveur. Tout le modding Hytale repose sur l'hôte du serveur ou l'hôte de la partie. Vous devriez pouvoir rejoindre n'importe quel serveur Hytale moddé sans télécharger de mods externes ni jongler avec des packs client.
• Une communauté, un client. Ils veulent éviter un écosystème où chaque serveur nécessiterait son propre client moddé, afin que le client reste stable et cohérent pendant que les serveurs apportent la variation.

En pratique, cela signifie qu'un mod est installé une seule fois, par l'hôte, et que chaque joueur qui se connecte bénéficie de l'expérience moddée avec un client entièrement vanilla.

Le solo est aussi un serveur

C'est le point qui donne du sens à tout le reste.

Hytale n'a pas de mode solo distinct au sens traditionnel. Lorsque vous créez un monde solo, vous rejoignez en réalité un serveur local qui n'existe que pour vous. Donc « l'hôte », c'est vous, et installer des mods pour le solo revient à la même opération que de les installer sur un serveur, dans un dossier différent.

Vous choisissez ensuite quels mods vous voulez, monde par monde, ce qui est un modèle vraiment pratique : un monde avec un overhaul, un autre en vanilla, sans jonglage de profils.

Rejoindre le serveur moddé de quelqu'un d'autre

Vous n'installez rien. Connectez-vous au serveur et jouez.

Les plugins et asset packs de l'hôte pilotent l'expérience, et votre client se contente d'afficher ce que le serveur lui indique. C'est pourquoi le navigateur de serveurs en jeu peut effectuer des vérifications de compatibilité et ne vous montrer que les serveurs que vous pouvez réellement rejoindre.

Les quatre types de mod Hytale

Le modding Hytale se divise en quatre catégories techniques, et savoir à laquelle vous avez affaire vous indique à quoi vous attendre.

Kind	Format	What it does
Server plugins	Java .jar	Étend le serveur de manière programmatique. Mini-jeux, économies, commandes, logique personnalisée. La catégorie la plus puissante.
Data assets	JSON	Définissent le contenu principal : blocs, objets, PNJ, génération du monde, butins et tables de loot.
Art assets	Models, textures, sounds	L'apparence et le son de tout. Hytale prend en charge Blockbench pour les modèles et les animations.
Save files	Worlds and prefabs	Des mondes entiers, ou des structures préconstruites utilisées dans les outils créatifs et la génération du monde.

Les Asset Packs sont le format d'empaquetage pour les deux catégories du milieu. Un asset pack est un zip ou un dossier contenant un manifest.json, regroupant un ensemble personnalisé d'assets qui remplacent ou ajoutent du contenu au jeu de base. Ils peuvent être créés dans l'Asset Editor en jeu ou à la main dans un explorateur de fichiers, bien que le studio recommande l'éditeur car la structure des dossiers est stricte.

BetterMap est un plugin serveur, il appartient donc à la première catégorie.

NOTE - Il n'y a pas de Lua ni d'autre script textuel dans Hytale, et le studio a indiqué qu'il n'y en aurait pas. Leur plan est un scripting visuel, dans l'esprit des Unreal Blueprints, accompagné de Java pour les programmeurs.

Où vont les mods

Deux emplacements comptent.

Le dossier global des mods, utilisé par tout :

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

Le dossier des mods par monde, que chaque sauvegarde possède également :

C:\Users\<user>\AppData\Roaming\Hytale\UserData\Saves\<World Name>\mods

Sur Linux et macOS, le dossier UserData se trouve à l'emplacement équivalent des données d'application de votre système, avec la même structure en dessous.

Tout ce qui se trouve dans le dossier global Mods est disponible pour n'importe quel monde. Tout ce qui se trouve dans le dossier mods propre à un monde appartient uniquement à ce monde.

ASTUCE - Sur Windows, collez %appdata%\Hytale\UserData dans la barre d'adresse de l'Explorateur de fichiers pour y accéder directement.

Installer un mod en solo

1. Rendez-vous sur la section Hytale de CurseForge et trouvez un mod. Pour ce guide, ouvrez BetterMap.
2. Téléchargez-le.
3. Ouvrez votre dossier UserData\Mods.
4. Déposez-y le fichier téléchargé. Les asset packs peuvent rester zippés ou être extraits sous forme de dossier ; les plugins s'y placent sous forme de .jar.
5. Lancez Hytale.
6. Ouvrez le menu New World et regardez sous Options. Vos mods et asset packs installés y apparaissent.
7. Activez ceux que vous voulez pour ce monde, puis créez-le.

Cette dernière étape est celle que les gens oublient. Placer un mod dans le dossier le rend disponible ; vous devez encore le choisir par monde au moment de sa création.

CurseForge est l'hébergeur principal, ce qui n'a rien de surprenant étant donné que Hypixel Studios y a organisé son New Worlds Modding Contest doté de 100 000 $. On comptait plus de 5 000 mods Hytale sur la plateforme début 2026, pour plus de 20 millions de téléchargements cumulés.

Installer Un Mod Sur Un Serveur Dédié

Pour un serveur que vous gérez pour d'autres personnes, le principe est identique, et le dossier concerné est celui du serveur.

1. Téléchargez le mod.
2. Placez-le dans le répertoire mods du serveur.
3. Redémarrez le serveur.

BetterMap conserve tout ce dont il a besoin à cet endroit, en créant mods/bettermap/ pour sa configuration et ses données au premier lancement.

Les joueurs qui se connectent à votre serveur n'ont rien à installer. C'est tout l'intérêt de ce modèle.

Si vous êtes en train de mettre en place un serveur, notre guide dédié aux serveurs Hytale couvre ce sujet.

Installer Avec L'App TMC

Comme il n'existe pas encore de gestionnaire de mods pour Hytale, cela mérite d'être signalé. L'App TMC est notre propre gestionnaire de mods et navigateur de serveurs, avec des installations en un clic et des sandboxes : des profils de mods nommés par jeu, chacun avec son propre ordre de chargement et sa méthode de déploiement, permutables sans avoir à retélécharger quoi que ce soit.

Hytale ne figure pas encore dans sa liste de jeux pris en charge, mais s'y prêterait bien. L'app fonctionne en sachant où vont les mods d'un jeu et comment celui-ci se lance, ce qui repose sur quatre fichiers JSON plutôt que du code, et le dossier UserData\Mods de Hytale, sans aucun loader impliqué, est à peu près la cible la plus simple que ce système puisse gérer. Les sandboxes s'accorderaient aussi parfaitement avec la sélection de mods par monde de Hytale.

Pour être honnête : l'app en est à un stade de développement très précoce. Son README indique qu'elle n'est que partiellement testée, et nous n'allons pas enjoliver les choses. Hytale lui-même est en early access et évolue chaque semaine, donc ce sont deux projets jeunes qui se retrouvent face à face. Si cela vous tente, l'essayer et remonter vos retours est vraiment utile.

Elle est open source sous licence GPL-3.0 à l'adresse github.com/modcommunity/tmc-app. Les rapports de bugs et demandes de fonctionnalités se déposent dans le suivi des issues, les pull requests sont les bienvenues, et le dépôt documente le format par jeu si vous souhaitez contribuer à la prise en charge de Hytale avant que nous n'y arrivions.

Installation :

• Linux : une seule ligne, sans root et sans gestionnaire de paquets.

curl -fsSL https://raw.githubusercontent.com/modcommunity/tmc-app/main/scripts/install.sh | sh

• Windows : le setup.exe ou setup.msi depuis la page des releases. Il existe aussi une version portable, qui n'enregistre toutefois pas l'entrée du launcher ni le gestionnaire de liens tmc://.
• macOS : le .dmg depuis la même page des releases.

Configurer Les Mods

Il n'existe pas de standard unique, mais le schéma courant est une configuration JSON à l'intérieur du propre dossier du mod, sous mods.

BetterMap en est un bon exemple. Ses paramètres se trouvent dans mods/bettermap/config.json, et il expose des options comme le rayon d'exploration, la qualité de la carte, la fréquence de mise à jour et le partage de l'exploration entre joueurs :

{
  "explorationRadius": 16,
  "updateRateMs": 500,
  "mapQuality": "MEDIUM",
  "shareAllExploration": false,
  "radarEnabled": true
}

Les plugins bien conçus ajoutent aussi des commandes d'administration et des permissions. BetterMap enregistre des commandes /bm, dont /bm reload pour appliquer les changements de configuration sans redémarrage, bien qu'il précise que certains paramètres nécessitent encore un redémarrage complet.

Lisez la description du mod sur CurseForge. Le modding Hytale étant encore aussi jeune, cette page est très souvent la seule documentation disponible.

Mods Par Monde

Les asset packs créés en jeu avec l'Asset Editor atterrissent dans le dossier mods propre à ce monde, plutôt que dans le dossier global. C'est pratique pendant que vous construisez quelque chose, mais déroutant la première fois que vous démarrez un second monde et vous demandez où est passé votre pack.

Pour utiliser dans un autre monde un pack créé dans un premier, copiez-le depuis :

UserData\Saves\<World Name>\mods

vers :

UserData\Mods

Une fois dans le dossier global, il apparaît dans les options de chaque nouveau monde.

Plateformes

Hytale est entré en early access sur Windows, macOS et Linux, et c'est la liste complète. Il n'y a pas de version console ou mobile, et le jeu n'est pas sur Steam.

Le jeu multiplateforme entre ces trois plateformes de bureau est présent, et un support multiplateforme plus large fait partie du plan depuis que le jeu a été racheté, mais rien au-delà du bureau n'existe aujourd'hui pour y installer des mods.

Mettre À Jour Et Supprimer Des Mods

Il n'existe pas encore de gestionnaire de mods pour Hytale, donc les deux opérations se font manuellement.

• Mettre à jour : téléchargez la nouvelle version depuis CurseForge et remplacez l'ancien fichier dans Mods. Vérifiez sur la page du mod si votre configuration est conservée.
• Supprimer : supprimez le fichier de Mods, ou décochez simplement le mod pour un monde donné.
• Désactiver pour un seul monde : laissez le fichier où il est et décochez-le dans les options de ce monde.

ATTENTION - Supprimer d'un monde un mod ayant ajouté des blocs, objets ou créatures qui y sont utilisés peut laisser ce monde dans un état instable, comme dans n'importe quel jeu de blocs. Sauvegardez le dossier de sauvegarde avant de retirer des mods d'un monde existant.

Dépannage

Mon mod n'apparaît pas dans les options de New World. Mauvais dossier. Il doit se trouver dans UserData\Mods ou dans le dossier mods propre à ce monde, et un asset pack a besoin d'un manifest.json valide.

J'ai installé un mod mais le monde dans lequel je suis déjà n'a pas changé. Les mods sont sélectionnés à la création d'un monde. Les mondes existants ne prennent pas en compte automatiquement les mods nouvellement installés.

Le pack que j'ai créé en jeu est absent de mon autre monde. Les packs de l'Asset Editor sont sauvegardés dans le monde où vous les avez créés. Copiez-le dans le dossier global Mods.

Un plugin se charge mais ses commandes ne font rien. Vérifiez les permissions. Les plugins Hytale utilisent des nœuds de permission, et les commandes nécessitent généralement le statut OP ou un accès explicite.

Tout a cassé après une mise à jour de Hytale. C'est normal, à ce stade. Hytale publie des patchs hebdomadaires en pré-version regroupés dans des versions stables toutes les quelques semaines, et les mods ont besoin de temps pour se mettre à jour.

Des joueurs disent qu'ils doivent installer le mod pour rejoindre. Ce n'est pas le cas. Si quelqu'un vous dit le contraire, il décrit le fonctionnement d'un autre jeu.

Puis-je utiliser des mods côté client ? Non. Il n'y a aucun support pour les mods côté client, et le studio a déclaré qu'il n'y avait aucun projet en ce sens.

Conclusion

Le modding sur Hytale se résume à une seule idée : l'hôte installe, tout le monde d'autre joue simplement. Déposez le fichier dans UserData\Mods, cochez-le lors de la création d'un monde, et c'est terminé. Pour un serveur dédié, c'est le même fichier dans le dossier mods propre au serveur.

C'est un modèle vraiment différent des installations BepInEx et des mod loaders présents dans nos autres guides, et une fois que ça devient clair, c'est beaucoup moins de travail. L'outillage est jeune et la documentation est incomplète, ce que Hypixel Studios reconnaît volontiers, alors appuyez-vous sur les descriptions des mods et sur docs.hytale.com en attendant que les choses se stabilisent.

Si vous souhaitez contribuer à quelque chose, le TMC App est open source, très tôt dans son développement, et vos retours seraient vraiment appréciés.

Voir aussi

• Hytale sur CurseForge
• Documentation Hytale - Documentation officielle pour gérer des serveurs et créer des mods.
• Créer du contenu dans Hytale - Asset packs, génération de mondes et éditeurs.
• Stratégie et état du modding Hytale - Le point de vue du studio lui-même sur l'état actuel du modding et sa direction future. Vaut vraiment la lecture complète.
• Discord officiel de Hytale
• Wiki Hytale
• TMC App

Hytale est en accès anticipé et évolue rapidement, donc ce guide changera plus que la plupart des autres. Si vous trouvez une instruction qui ne correspond plus à ce que vous observez, merci de le signaler ou d'ouvrir une pull request sur le dépôt GitHub de ce guide.

Rejoignez notre serveur Discord si vous avez des questions ou souhaitez de l'aide pour tout ce qui concerne le modding !