Comment installer des mods dans Boneworks (2026)

Un guide sur comment télécharger et installer des mods dans BONEWORKS sur PC.

BONEWORKS est un bac à sable physique exclusivement en VR construit sous Unity, et ses mods sont chargés par MelonLoader plutôt que par BepInEx. C'est ce qui le distingue principalement de la plupart des jeux Unity que les gens moddent. Tout se trouve sur Thunderstore.

Notre exemple pratique est Custom Maps, un chargeur de cartes qui vous permet d'intégrer des niveaux créés par la communauté dans le jeu. Il nécessite deux autres mods pour fonctionner, ce qui en fait une bonne démonstration de la façon dont l'ensemble s'articule.

Prérequis

• Un PC sous Windows 10 ou version ultérieure. Linux via Proton fonctionne avec une variable d'environnement supplémentaire, expliquée plus bas.
• BONEWORKS sur Steam, ainsi qu'un casque VR et son runtime. Il n'y a pas de mode écran plat.
• Microsoft Visual C++ 2015-2019 Redistributable, 64 bits. MelonLoader en a besoin.
• .NET Desktop Runtime 6.0, x64. BONEWORKS est un jeu Il2Cpp et MelonLoader nécessite ceci pour ce type de jeux.
• Quelques centaines de Mo d'espace libre, plus si vous collectionnez des cartes personnalisées.

BONEWORKS est un jeu solo sans anti-triche. Rien ici ne met votre compte en danger.

MelonLoader, pas BepInEx

Si vous avez moddé Lethal Company, Valheim ou la plupart des autres jeux Unity, vous avez utilisé BepInEx. BONEWORKS ne l'utilise pas.

MelonLoader est un autre chargeur de mods universel pour Unity, développé par LavaGang, avec un support de premier plan pour les jeux Il2Cpp comme celui-ci. Il fonctionne sur le même principe : il s'accroche au jeu au lancement et charge les mods, mais l'organisation des dossiers et l'installateur lui sont propres.

Les mods MelonLoader sont des fichiers .dll qui vont dans un dossier Mods situé dans le répertoire du jeu, et non dans BepInEx/plugins.

ModThatIsNotMod

Presque tous les mods BONEWORKS que vous voudrez réellement utiliser dépendent de ModThatIsNotMod par gnonme. C'est la bibliothèque partagée pour ce jeu : elle gère le chargement d'objets personnalisés, fournit aux auteurs de mods des outils pour les systèmes du jeu, et c'est sur elle que repose le reste de l'écosystème.

Custom Maps en a besoin, ainsi que de FieldInjection. L'ensemble complet pour notre exemple est donc :

MelonLoader  ->  ModThatIsNotMod + FieldInjection  ->  Custom Maps

Un gestionnaire de mods s'occupe de tout cela pour vous.

Un mot sur les mods BONELAB

BONEWORKS et BONELAB sont des jeux distincts avec des communautés Thunderstore distinctes, et certains packages sont listés dans les deux. Ce double référencement n'est pas toujours pertinent.

Hitmarkers est celui sur lequel les gens tombent le plus souvent. Il apparaît dans les listes BONEWORKS, mais chaque version publiée dépend de BoneLib, qui est une bibliothèque BONELAB sans équivalent BONEWORKS, et sa propre description indique qu'il a été refait pour BONELAB. L'installer ici ne fera pas ce que vous voulez.

La règle générale : si un mod BONEWORKS liste ModThatIsNotMod comme dépendance, c'est bien un mod BONEWORKS. S'il liste BoneLib, c'est un mod BONELAB qui se trouve être également listé ailleurs.

Installation avec Gale

Gale est la solution la plus simple et gère MelonLoader pour vous.

1. Téléchargez Gale depuis Thunderstore ou GitHub.
2. Ouvrez-le et sélectionnez BONEWORKS.
3. Laissez-le trouver votre installation Steam, ou indiquez-lui vous-même le dossier du jeu.
4. Ouvrez Browse mods, recherchez Custom Maps, et cliquez sur Install.
5. MelonLoader, ModThatIsNotMod et FieldInjection sont installés en même temps.
6. Cliquez sur Launch game (modded).

Lancer BONEWORKS depuis Steam le démarre sans mods. Lancez-le depuis Gale.

Installation avec r2modman

r2modman fonctionne de la même manière.

1. Installez r2modman et sélectionnez BONEWORKS.
2. Créez un profil.
3. Ouvrez Online, recherchez Custom Maps, et utilisez Download with dependencies.
4. Cliquez sur Start modded.

Les deux fonctionnent bien. Gale est plus léger ; r2modman a un support de plateformes plus large.

Installer MelonLoader vous-même

Utile à savoir si vous préférez ne pas utiliser de gestionnaire, ou si un gestionnaire vous pose problème.

Trouvez d'abord votre dossier de jeu. Faites un clic droit sur BONEWORKS dans Steam, puis Manage et Browse local files :

C:\Program Files (x86)\Steam\steamapps\common\BONEWORKS

Vous cherchez BONEWORKS.exe.

L'installateur automatisé

C'est la méthode recommandée et elle est réellement simple.

1. Téléchargez le MelonLoader Installer.
2. Exécutez-le. Il recherche les jeux Unity installés et devrait lister BONEWORKS automatiquement. Si ce n'est pas le cas, utilisez Add Game Manually et indiquez BONEWORKS.exe.
3. Cliquez sur BONEWORKS dans la liste, choisissez une version, et cliquez sur Install.

AVERTISSEMENT - Ne touchez pas au bouton des builds nightly. Les nightlies sont générées à partir des derniers commits et cassent régulièrement des choses. La version stable est celle sur laquelle les mods sont construits.

La méthode manuelle

1. Téléchargez MelonLoader.x64.zip. BONEWORKS est en 64 bits.
2. Extrayez le dossier MelonLoader de l'archive dans le dossier BONEWORKS.
3. Extrayez également version.dll de la même archive dans le dossier BONEWORKS.
4. Lancez le jeu une fois pour que MelonLoader génère ses dossiers, puis quittez.

Vous devriez maintenant avoir un dossier MelonLoader, un fichier version.dll et un dossier Mods à côté de BONEWORKS.exe.

Installer des mods manuellement

Une fois MelonLoader en place, installer des mods est simple.

1. Ouvrez la page Thunderstore du mod et cliquez sur Manual Download.
2. Extrayez l'archive.
3. Copiez le .dll dans le dossier Mods de votre répertoire BONEWORKS.

Pour Custom Maps, cela signifie trois téléchargements distincts, puisqu'il vous faut aussi ModThatIsNotMod et FieldInjection. Récupérez chacun à la version indiquée dans la section Dependencies du mod, et copiez chaque .dll dans Mods.

Certains mods fournissent du contenu supplémentaire en plus du .dll, comme des fichiers de cartes ou de modèles. Consultez la description du mod pour savoir où ils doivent aller. Custom Maps, par exemple, lit les fichiers de cartes depuis son propre dossier plutôt que depuis Mods.

NOTE - Les fichiers manifest.json, icon.png et README.md d'une archive Thunderstore sont des fichiers d'empaquetage destinés au site web. Ils n'ont aucun effet dans le dossier Mods.

Installer avec The TMC App

Pour compléter cette liste, notre propre outil. The TMC App est un gestionnaire de mods et un navigateur de serveurs que nous développons, 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, interchangeables sans avoir à retélécharger quoi que ce soit.

BONEWORKS ne figure pas encore dans sa liste de jeux pris en charge. Ajouter un jeu ne demande que quatre fichiers JSON et aucun code, c'est donc une petite tâche, et les jeux sous MelonLoader sont exactement le genre de chose que le système de plugins est censé couvrir.

Pour être honnête : l'application est encore en tout début de développement. Nous le disons dans son README et nous le répétons ici. Une grande partie n'a été que partiellement testée, donc considérez-la comme quelque chose à essayer en parallèle de Gale plutôt que comme un remplacement. Si vous l'essayez, dites-nous ce qui s'est passé, car c'est la chose la plus utile que quiconque puisse faire pour le projet actuellement.

Elle est open source sous licence GPL-3.0 sur github.com/modcommunity/tmc-app. Les bugs et demandes de fonctionnalités se signalent dans le suivi des issues, les pull requests sont les bienvenues, et le dépôt documente le format par jeu si vous voulez ajouter vous-même la prise en charge de BONEWORKS.

Pour l'installer :

• 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, mais elle n'enregistre pas l'entrée du lanceur ni le gestionnaire de liens tmc://.
• macOS : le .dmg depuis la même page des releases.

Vérifier que ça fonctionne

MelonLoader ouvre une fenêtre de console à côté du jeu au lancement. Au démarrage, elle affiche sa propre version, puis une ligne par mod au fur et à mesure de leur chargement, avec le nom du mod, sa version et son auteur.

Des journaux sont aussi écrits sur le disque :

BONEWORKS\MelonLoader\Latest.log

Ce fichier est la première chose à consulter quand quelque chose ne fonctionne pas, et la première chose que quiconque vous aidera vous demandera.

Pour Custom Maps en particulier, le mod ajoute sa propre méthode pour choisir un niveau en jeu une fois les fichiers de cartes installés.

Fonctionner sous Linux

BONEWORKS fonctionne via Proton. MelonLoader a besoin d'une surcharge de DLL pour être chargé, donc réglez les options de lancement Steam du jeu sur :

WINEDLLOVERRIDES="version=n,b" %command%

Notez que c'est version, et non winhttp. MelonLoader utilise une DLL de hook différente de celle de BepInEx, et copier l'option de lancement de BepInEx est une erreur fréquente.

L'installeur MelonLoader propose aussi une version Linux si vous préférez ne pas le faire à la main. Gale et r2modman règlent tous deux la surcharge eux-mêmes lorsque vous lancez le jeu via eux.

Supprimer des mods

Supprimez le .dll du dossier Mods, ou désinstallez-le via votre gestionnaire de mods.

Pour retirer complètement MelonLoader, supprimez le dossier MelonLoader, version.dll, le dossier Mods et le dossier UserData du dossier du jeu. L'installeur MelonLoader propose aussi une option de désinstallation qui fait cela pour vous.

L'option Vérifier l'intégrité des fichiers du jeu de Steam ne nettoiera rien de tout cela, car Steam n'a aucune trace des fichiers qu'il n'a pas installés lui-même.

Dépannage

Pas de fenêtre de console et aucun mod. MelonLoader ne se charge pas. Vérifiez que version.dll se trouve bien directement à côté de BONEWORKS.exe, et que vous avez lancé le jeu depuis votre gestionnaire de mods plutôt que depuis Steam.

MelonLoader se charge mais pas un mod. Ouvrez MelonLoader\Latest.log. Les dépendances manquantes et les incompatibilités de version y apparaissent clairement.

MelonLoader plante au démarrage. Généralement, un prérequis manquant. Installez le redistribuable VC++ 2015-2019 x64 et le .NET Desktop Runtime 6.0 x64, nécessaires pour les jeux Il2Cpp.

Un mod s'est installé sans problème mais ne fait rien du tout. Vérifiez qu'il s'agit bien d'un mod BONEWORKS. Si sa liste de dépendances mentionne BoneLib, c'est un mod BONELAB qui se trouve être aussi référencé ici.

Tout s'est cassé après une mise à jour du jeu. BONEWORKS n'est plus mis à jour très souvent, mais quand il l'est, MelonLoader et les mods doivent tous deux se mettre à jour en conséquence. Videz le dossier Mods pour confirmer que le jeu lui-même fonctionne, puis patientez.

Erreurs de runtime VR après l'installation de mods. Essayez de lancer le jeu sans mods d'abord pour confirmer que le côté casque fonctionne. Les problèmes de mods et les problèmes SteamVR se ressemblent beaucoup vus depuis l'intérieur d'un casque.

Conclusion

Le modding de BONEWORKS est simple une fois qu'on sait que c'est MelonLoader et non BepInEx, et que ModThatIsNotMod est la bibliothèque sur laquelle tout le reste repose. Installez Gale, installez le mod que vous voulez, et lancez le jeu via Gale.

Le seul piège spécifique à BONEWORKS, ce sont les paquets BONELAB référencés en double. Vérifiez la liste des dépendances avant d'installer : ModThatIsNotMod signifie BONEWORKS, BoneLib signifie BONELAB.

Si vous voulez apporter votre aide, TMC App est open source et encore en début de développement, et vos retours ont énormément de valeur pour nous.

Voir aussi

• BONEWORKS sur Thunderstore
• Wiki de MelonLoader - La documentation officielle du loader, qui vaut le coup d'œil.
• MelonLoader sur GitHub
• Discord de modding BONEWORKS
• Wiki BONEWORKS
• TMC App

Nous faisons de notre mieux pour maintenir ce guide à jour, mais MelonLoader et les mods qui en dépendent évoluent avec le temps. Si une instruction ne correspond plus à ce que vous constatez, 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 !