Comment installer des mods dans BONELAB (2026)

Un guide expliquant comment télécharger et installer des mods dans BONELAB sur PC et sur Meta Quest.

BONELAB est particulier parmi les jeux pour lesquels nous rédigeons ces guides, car il possède deux systèmes de modding totalement séparés qui remplissent des rôles différents :

• mod.io est intégré directement au jeu. Il fonctionne sur PC et sur Quest en mode autonome, ne nécessite aucun outil externe, et couvre les avatars, les maps et les objets à faire apparaître (spawnables).
• MelonLoader est un mod loader réservé au PC pour les mods de code, ceux qui modifient réellement le comportement du jeu. Ceux-ci se trouvent sur Thunderstore.

Le système qu'il vous faut dépend entièrement du type de mod que vous recherchez. Nous couvrons les deux, et utilisons Ragdoll Player comme exemple concret pour la partie MelonLoader.

Prérequis

Pour le contenu mod.io :

• BONELAB sur n'importe quelle plateforme prise en charge, y compris Quest 2, Quest 3 et Quest Pro en mode autonome.
• Un compte mod.io gratuit.

Pour les mods de code MelonLoader, en plus :

• Un PC sous Windows 10 ou supérieur, avec BONELAB sur Steam ou via l'application Oculus PC. Linux via Proton fonctionne avec une option de lancement supplémentaire.
• Microsoft Visual C++ 2015-2019 Redistributable, 64 bits.
• .NET Desktop Runtime 6.0, x64. BONELAB utilise Il2Cpp et MelonLoader en a besoin.
• Quelques Go d'espace libre si vous comptez collectionner avatars et maps, qui ne sont pas légers.

Deux systèmes, deux types de mods

Bien comprendre cette distinction dès le départ fait gagner beaucoup de temps.

	mod.io	MelonLoader
Où l'obtenir	Intégré au jeu, ou mod.io	Thunderstore
Plateformes	PC et Quest autonome	PC uniquement
Ce que ça gère	Avatars, maps, objets à spawn, créés avec le BONELAB SDK	Mods de code qui modifient le comportement du jeu
Outils supplémentaires nécessaires	Non	Oui, MelonLoader et généralement BoneLib
Exemple	Un avatar personnalisé ou un niveau supplémentaire	Ragdoll Player, multijoueur Fusion

Donc si vous voulez incarner un personnage différent ou charger une map communautaire, mod.io répond à tout et vous n'avez jamais besoin de toucher à un fichier. Si vous voulez changer le fonctionnement du jeu, c'est le territoire de MelonLoader, et les joueurs Quest n'ont pas de chance.

NOTE - Le Quest en mode autonome ne peut pas faire tourner MelonLoader. Rien ne permet de contourner ça. Les joueurs Quest connectés à un PC via Link ou Air Link font tourner la version PC, ils sont donc du côté PC de ce tableau.

Installer des mods avec mod.io

Depuis le jeu

C'est de loin l'expérience de modding la plus simple parmi tous les jeux de cette collection.

1. Lancez BONELAB et chargez le Hub.
2. Trouvez le terminal mod.io dans le Hub et interagissez avec.
3. Connectez-vous à votre compte mod.io. Le jeu vous donne un code à saisir sur mod.io/connect depuis un téléphone ou un navigateur PC, ce qui évite de taper un mot de passe avec des mains VR.
4. Parcourez ou recherchez le catalogue.
5. Sélectionnez un mod et installez-le. Il se télécharge directement sur l'appareil.

Les avatars installés apparaissent aux terminaux d'avatars, les maps apparaissent dans la liste des niveaux, et les spawnables apparaissent dans le catalogue du spawn gun. Il n'y a aucun dossier à trouver et rien à lancer différemment.

Depuis le site web

Vous pouvez aussi tout préparer depuis un ordinateur.

1. Connectez-vous sur mod.io/g/bonelab.
2. Trouvez un mod et cliquez sur Subscribe.
3. Lancez BONELAB en étant connecté au même compte.

Les abonnements se synchronisent au lancement. C'est bien plus confortable pour parcourir le catalogue que de le faire dans un casque.

ASTUCE - Les abonnements suivent votre compte, pas votre appareil. Abonnez-vous sur votre PC et les mêmes mods apparaissent sur votre Quest, ce qui est vraiment pratique si vous jouez sur les deux.

Remarques pour Quest

Le stockage est la contrainte ici. Les avatars et les maps sont du vrai contenu Unity et ça s'accumule vite sur un casque qui contient déjà tout le reste. Se désabonner depuis le jeu supprime les fichiers.

Le Quest tourne aussi sur un GPU mobile. Les maps conçues pour PC fonctionneront, mais pas toujours bien, et la description du mod indique généralement si le Quest est pris en charge. Lorsqu'un mod a des versions PC et Quest séparées, mod.io sert automatiquement la bonne.

Installer des mods de code avec MelonLoader

C'est la partie réservée au PC.

BoneLib

Presque tous les mods de code BONELAB dépendent de BoneLib, la bibliothèque partagée sur laquelle la scène est construite. Ragdoll Player ne fait pas exception.

Il y a une subtilité à connaître. BoneLib était autrefois publié sous l'espace de noms gnonme et est depuis passé à bonelib. L'ancien paquet gnonme/BoneLib existe toujours et dépend désormais simplement du nouveau, donc les anciens mods qui font référence à l'ancien nom continuent de fonctionner. Si vous voyez les deux dans votre liste installée, c'est pour cette raison, et ce n'est pas un problème.

Les mod managers gèrent tout ça automatiquement. Cela n'a d'importance que si vous installez à la main.

Utiliser Gale ou r2modman

1. Téléchargez Gale ou r2modman et installez-le.
2. Ouvrez-le et sélectionnez BONELAB.
3. Laissez-le détecter votre installation, ou indiquez-lui le dossier du jeu.
4. Recherchez Ragdoll Player et cliquez sur Install ou Download with dependencies.
5. MelonLoader et BoneLib s'installent automatiquement avec.
6. Lancez avec Launch game (modded) ou Start modded.

Lancer BONELAB depuis Steam ou l'application Oculus exécute au contraire le jeu sans mods.

Installer MelonLoader manuellement

Trouvez d'abord le dossier de votre jeu. Sur Steam, faites un clic droit sur BONELAB, puis Gérer et Parcourir les fichiers locaux :

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

La méthode simple consiste à utiliser le MelonLoader Installer. Lancez-le, sélectionnez BONELAB dans la liste des jeux détectés, choisissez une version stable, puis cliquez sur Install. Si BONELAB n'est pas détecté, utilisez Add Game Manually et pointez vers BONELAB.exe.

Pour le faire entièrement à la main :

1. Téléchargez MelonLoader.x64.zip.
2. Extrayez le dossier MelonLoader dans le dossier de BONELAB.
3. Extrayez également version.dll dans le dossier de BONELAB.
4. Lancez le jeu une fois puis quittez-le, ce qui crée les dossiers Mods et UserData.

ATTENTION - N'activez pas les versions nightly dans l'installeur. Elles sont compilées à partir des derniers commits et cassent régulièrement. Les mods sont conçus pour les versions stables.

Installer Ragdoll Player manuellement

1. Téléchargez BoneLib et Ragdoll Player avec Manual Download.
2. Extrayez les deux.
3. Copiez chaque .dll dans le dossier Mods de votre répertoire BONELAB.

Les mods MelonLoader vont dans Mods, pas dans un dossier plugins. Si vous venez d'un jeu utilisant BepInEx, c'est la différence de structure à retenir.

Ragdoll Player écrit une configuration au premier lancement dans UserData, où vous pouvez définir la touche qui déclenche le ragdoll.

Installer avec l'application TMC

Il existe une troisième méthode qu'il vaut la peine de connaître, bien qu'elle ne s'applique qu'à la partie MelonLoader de ce guide. The TMC App 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, interchangeables sans rien retélécharger.

BONELAB ne figure pas encore dans sa liste de jeux pris en charge. Ajouter un jeu nécessite quatre fichiers JSON plutôt que du code, ce n'est donc pas un gros travail.

Deux points à clarifier. L'application ne gérerait jamais que les mods de code ; le contenu mod.io est géré à l'intérieur du jeu et aucun outil externe n'y changera rien. Et l'application en est à un stade de développement très précoce, ce que son propre README indique clairement. Une grande partie n'est que partiellement testée, donc utilisez-la en complément de Gale plutôt qu'à sa place pour l'instant. Si vous l'essayez, nous aimerions vraiment savoir comment cela s'est passé.

C'est un projet open source sous licence GPL-3.0 disponible sur github.com/modcommunity/tmc-app. Les rapports de bugs et demandes de fonctionnalités ont leur place dans le suivi des tickets, les pull requests sont les bienvenues, et le dépôt documente le format par jeu si vous souhaitez ajouter vous-même le support de BONELAB.

Pour l'installer :

• Linux : une seule ligne, sans root ni 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 lanceur ni le gestionnaire de liens tmc://.
• macOS : le .dmg depuis la même page des releases.

Multijoueur avec Fusion

Cela vaut la peine d'être mentionné car c'est le mod que la plupart des gens finissent par vouloir. Fusion ajoute un multijoueur complet à BONELAB et c'est l'un des mods les plus téléchargés pour ce jeu, et de loin.

C'est un mod MelonLoader, donc réservé au PC, et tout le monde dans une session doit l'avoir installé. Comme il doit aussi s'assurer que tout le monde dispose du même contenu mod.io, il existe un mod complémentaire, ModioModNetworker, qui synchronise les avatars et cartes mod.io entre les joueurs d'une session.

Installez Fusion de la même façon que tout autre mod du côté Thunderstore, et partagez un profil de gestionnaire de mods avec les personnes avec qui vous jouez.

Vérifier que vos mods se sont chargés

Contenu mod.io : il suffit de regarder. Les avatars apparaissent aux terminaux d'avatars, les cartes dans la sélection de niveaux. Si quelque chose auquel vous êtes abonné manque, vérifiez que vous êtes connecté au même compte dans le jeu.

Mods MelonLoader : une fenêtre de console s'ouvre à côté du jeu et affiche une ligne par mod au fur et à mesure de son chargement, avec le nom, la version et l'auteur. Le journal complet est écrit ici :

BONELAB\MelonLoader\Latest.log

Ce journal est la première chose à vérifier lorsqu'un mod ne fonctionne pas, et la première chose que quiconque vous aide vous demandera de montrer.

Linux

BONELAB tourne via Proton. MelonLoader a besoin d'un override de DLL, il faut donc définir les options de lancement Steam du jeu comme suit :

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

C'est version, pas winhttp. MelonLoader et BepInEx utilisent des DLL de hook différentes, et confondre les options de lancement est une erreur facile à commettre.

Il existe aussi une version Linux de l'installeur MelonLoader. Gale et r2modman définissent l'override pour vous lorsque vous lancez le jeu via ces outils.

Le contenu mod.io ne nécessite rien de spécial sous Linux, puisqu'il est entièrement géré à l'intérieur du jeu.

Désinstallation

mod.io : désabonnez-vous dans le jeu ou sur le site. Les fichiers sont supprimés de l'appareil.

Un seul mod MelonLoader : désinstallez-le depuis votre gestionnaire de mods, ou supprimez son .dll du dossier Mods.

MelonLoader dans son intégralité : supprimez le dossier MelonLoader, version.dll, Mods et UserData du répertoire du jeu, ou utilisez l'option de désinstallation du MelonLoader Installer. La vérification des fichiers de Steam ne fera pas cela, puisque rien de tout cela ne vient de Steam.

Dépannage

Le terminal mod.io dit que je ne suis pas connecté. Reconnectez-vous via mod.io/connect avec le code affiché par le jeu.

Les mods auxquels je suis abonné n'apparaissent pas. Redémarrez le jeu. Les abonnements se synchronisent au lancement et non en temps réel.

Le Quest n'a plus de stockage. Désabonnez-vous de ce que vous n'utilisez pas. Les cartes et avatars sont volumineux.

Aucune console MelonLoader n'apparaît. MelonLoader ne se charge pas. Vérifiez que version.dll se trouve bien directement à côté de BONELAB.exe, et que vous avez lancé le jeu via votre mod manager.

MelonLoader se charge mais pas un mod. Consultez MelonLoader\Latest.log. Une version de BoneLib manquante ou incompatible est de très loin la cause la plus fréquente.

MelonLoader plante au démarrage. Installez le VC++ 2015-2019 x64 redistributable et le .NET Desktop Runtime 6.0 x64.

Un mod Thunderstore ne fait rien. Vérifiez qu'il s'agit bien d'un mod BONELAB. Certains packages sont également listés pour BONEWORKS, et les mods BONEWORKS dépendent de ModThatIsNotMod plutôt que de BoneLib.

Tout a cassé après une mise à jour. Les patchs de Stress Level Zero cassent les mods MelonLoader. Videz le dossier Mods pour confirmer que le jeu fonctionne proprement, puis attendez que les auteurs mettent à jour leurs mods.

Conclusion

La décision qui compte est de savoir quel système vous avez besoin. Les avatars, cartes et objets à faire apparaître relèvent de mod.io, fonctionnent sur Quest, et s'installent sans quitter le jeu. Les mods de code relèvent de MelonLoader, sont PC uniquement, et un mod manager comme Gale les installe en deux clics.

Si vous êtes sur Quest en mode autonome, mod.io est toute l'histoire, et c'est une bonne histoire.

Si vous avez un moment, le TMC App est open source, encore très tôt dans son développement, et vos retours seraient grandement appréciés.

Voir aussi

• BONELAB sur mod.io
• BONELAB sur Thunderstore
• MelonLoader Wiki
• Discord de modding BONELAB
• BONELAB Wiki
• TMC App

Nous maintenons ce guide aussi à jour que possible, mais le jeu, mod.io et MelonLoader évoluent tous indépendamment. Si vous repérez une instruction qui ne correspond plus à ce que vous voyez, 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 avez besoin d'aide pour tout ce qui concerne le modding !