Eine Anleitung zum Herunterladen und Installieren von Mods in BONELAB auf PC und Meta Quest.
BONELAB ist unter den Spielen, für die wir diese Anleitungen schreiben, ungewöhnlich, da es zwei völlig getrennte Modding-Systeme besitzt, die unterschiedliche Aufgaben erfüllen:
- mod.io ist direkt ins Spiel integriert. Es funktioniert auf PC und auf einer eigenständigen Quest, benötigt keine externen Tools und deckt Avatare, Maps und spawnbare Gegenstände ab.
- MelonLoader ist ein reiner PC-Modloader für Code-Mods, also solche, die das eigentliche Verhalten des Spiels verändern. Diese findet man auf Thunderstore.
Welches System du brauchst, hängt ganz davon ab, welche Art von Mod du suchst. Wir behandeln beide und nutzen Ragdoll Player als praktisches Beispiel für die MelonLoader-Seite.
Anforderungen
Für mod.io-Inhalte:
- BONELAB auf jeder unterstützten Plattform, einschließlich eigenständiger Quest 2, Quest 3 und Quest Pro.
- Ein kostenloses mod.io-Konto.
Für MelonLoader-Code-Mods zusätzlich:
- Ein PC mit Windows 10 oder neuer, mit BONELAB auf Steam oder über die Oculus-PC-App. Linux über Proton funktioniert mit einer zusätzlichen Startoption.
- Microsoft Visual C++ 2015-2019 Redistributable, 64 Bit.
- .NET Desktop Runtime 6.0, x64. BONELAB nutzt Il2Cpp und MelonLoader benötigt dies.
- Ein paar GB frei, falls du vorhast, Avatare und Maps zu sammeln, die nicht klein sind.
Zwei Systeme, zwei Arten von Mods
Diese Unterscheidung von Anfang an klar zu haben, erspart eine Menge Zeit.
| mod.io | MelonLoader | |
|---|---|---|
| Wo man es bekommt | Im Spiel integriert, oder mod.io | Thunderstore |
| Plattformen | PC und eigenständige Quest | Nur PC |
| Was es abdeckt | Avatare, Maps, spawnbare Gegenstände, erstellt mit dem BONELAB SDK | Code-Mods, die das Spielverhalten verändern |
| Braucht zusätzliche Tools | Nein | Ja, MelonLoader und meist BoneLib |
| Beispiel | Ein eigener Avatar oder ein zusätzliches Level | Ragdoll Player, Fusion-Multiplayer |
Wenn du also einen anderen Charakter spielen oder eine Community-Map laden willst, ist mod.io die komplette Antwort, und du musst nie eine Datei anfassen. Wenn du verändern willst, wie das Spiel funktioniert, ist das MelonLoader-Territorium, und Quest-Spieler haben da Pech.
HINWEIS - Die eigenständige Quest kann MelonLoader nicht ausführen. Daran führt kein Weg vorbei. Quest-Spieler, die per Link oder Air Link mit einem PC verbunden sind, laufen auf der PC-Version und gehören damit zur PC-Seite dieser Tabelle.
Mods mit mod.io installieren
Direkt im Spiel
Das ist bei weitem die einfachste Modding-Erfahrung von allen Spielen in dieser Sammlung.
- Starte BONELAB und lade in den Hub.
- Finde das mod.io-Terminal im Hub und interagiere damit.
- Melde dich bei deinem mod.io-Konto an. Das Spiel gibt dir einen Code, den du unter mod.io/connect von einem Handy oder PC-Browser aus eingibst, was dir das Eintippen eines Passworts mit VR-Händen erspart.
- Durchstöbere oder durchsuche den Katalog.
- Wähle einen Mod aus und installiere ihn. Er wird direkt auf das Gerät heruntergeladen.
Installierte Avatare erscheinen an den Avatar-Terminals, Maps erscheinen in der Levelliste, und Spawnables erscheinen im Katalog der Spawn-Gun. Es gibt keinen Ordner, den man finden muss, und nichts, das man anders starten müsste.
Über die Website
Du kannst Dinge auch am Computer vorab einreihen.
- Melde dich bei mod.io/g/bonelab an.
- Finde einen Mod und klicke auf Subscribe.
- Starte BONELAB, während du beim gleichen Konto angemeldet bist.
Abonnements synchronisieren sich beim Start. Das ist deutlich angenehmer zum Durchstöbern als es im Headset zu tun.
TIPP - Abonnements folgen deinem Konto, nicht deinem Gerät. Abonniere am PC, und dieselben Mods erscheinen auf deiner Quest, was wirklich praktisch ist, wenn du auf beidem spielst.
Hinweise zur Quest
Speicherplatz ist hier die Einschränkung. Avatare und Maps sind echte Unity-Inhalte und summieren sich schnell auf einem Headset, das noch alles andere gespeichert hat. Das Abbestellen im Spiel entfernt die Dateien.
Die Quest läuft außerdem auf einer mobilen GPU. Für PC gebaute Maps laufen zwar, aber nicht immer gut, und die Mod-Beschreibung gibt meist an, ob Quest unterstützt wird. Wo ein Mod separate PC- und Quest-Builds hat, liefert mod.io automatisch den richtigen aus.
Code-Mods mit MelonLoader installieren
Das ist die reine PC-Hälfte.
BoneLib
Fast jeder BONELAB-Code-Mod hängt von BoneLib ab, der gemeinsamen Bibliothek, auf der die Szene aufbaut. Ragdoll Player macht da keine Ausnahme.
Es gibt eine Feinheit, die man kennen sollte. BoneLib wurde früher unter dem Namespace gnonme veröffentlicht und ist inzwischen zu bonelib gewechselt. Das alte Paket gnonme/BoneLib existiert weiterhin und hängt jetzt einfach vom neuen ab, sodass ältere Mods, die den alten Namen referenzieren, weiterhin funktionieren. Wenn du beide in deiner Installationsliste siehst, liegt das daran, und das ist kein Problem.
Mod-Manager kümmern sich um all das. Es spielt nur eine Rolle, wenn du von Hand installierst.
Mit Gale oder r2modman
- Lade Gale oder r2modman herunter und installiere es.
- Öffne es und wähle BONELAB aus.
- Lass es deine Installation erkennen, oder verweise es auf den Spieleordner.
- Suche nach Ragdoll Player und klicke auf Install oder Download with dependencies.
- MelonLoader und BoneLib werden automatisch mitinstalliert.
- Starte mit Launch game (modded) oder Start modded.
BONELAB stattdessen über Steam oder die Oculus-App zu starten, läuft es ohne Mods.
MelonLoader manuell installieren
Suche zuerst deinen Spieleordner. Rechtsklicke auf Steam auf BONELAB, dann Verwalten und Lokale Dateien einsehen:
C:\Program Files (x86)\Steam\steamapps\common\BONELAB
Der einfache Weg ist der MelonLoader Installer. Führe ihn aus, wähle BONELAB aus der Liste der erkannten Spiele, wähle eine stabile Version und klicke auf Install. Wird BONELAB nicht erkannt, nutze Add Game Manually und verweise auf BONELAB.exe.
So geht es komplett manuell:
- Lade MelonLoader.x64.zip herunter.
- Entpacke den Ordner
MelonLoaderin den BONELAB-Ordner. - Entpacke
version.dllebenfalls in den BONELAB-Ordner. - Starte das Spiel einmal und beende es wieder, wodurch die Ordner
ModsundUserDataerstellt werden.
WARNUNG - Aktiviere keine Nightly-Builds im Installer. Sie werden aus den neuesten Commits gebaut und brechen regelmäßig. Mods werden gegen stabile Releases gebaut.
Ragdoll Player manuell installieren
- Lade BoneLib und Ragdoll Player über Manual Download herunter.
- Entpacke beide.
- Kopiere jede
.dllin den OrdnerModsin deinem BONELAB-Verzeichnis.
MelonLoader-Mods kommen in Mods, nicht in einen plugins-Ordner. Wenn du von einem BepInEx-Spiel kommst, ist das der Unterschied in der Struktur, den man sich merken sollte.
Ragdoll Player schreibt beim ersten Start eine Konfiguration unter UserData, in der du die Eingabe festlegen kannst, die den Ragdoll auslöst.
Installation mit der TMC App
Es gibt noch einen dritten Weg, den man kennen sollte, auch wenn er nur für die MelonLoader-Hälfte dieser Anleitung gilt. Die TMC App ist unser eigener Mod-Manager und Serverbrowser, mit Ein-Klick-Installationen und Sandboxes: benannte Mod-Profile pro Spiel, jedes mit eigener Ladereihenfolge und Bereitstellungsmethode, umschaltbar ohne erneuten Download.
BONELAB steht noch nicht auf der Liste der unterstützten Spiele. Ein Spiel hinzuzufügen bedeutet vier JSON-Dateien statt Code, es ist also kein großer Aufwand.
Zwei Dinge sollten klar sein. Die App würde ausschließlich Code-Mods verwalten; mod.io-Inhalte werden im Spiel selbst gehandhabt, und daran wird kein externes Tool etwas ändern. Und die App befindet sich in einer sehr frühen Entwicklungsphase, was auch in ihrer eigenen README klar steht. Vieles ist nur teilweise getestet, verwende sie also vorerst neben Gale statt anstelle davon. Wenn du sie ausprobierst, würden wir uns sehr freuen, davon zu hören.
Sie ist Open Source unter GPL-3.0 auf 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 BONELAB-Unterstützung selbst hinzufügen möchtest.
Installation:
- Linux: eine Zeile, kein Root und kein Paketmanager.
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.
Multiplayer mit Fusion
Erwähnenswert, weil es der Mod ist, den die meisten irgendwann haben wollen. Fusion fügt BONELAB vollständigen Multiplayer hinzu und ist einer der mit weitem Abstand am häufigsten heruntergeladenen Mods für das Spiel.
Es ist ein MelonLoader-Mod, also nur für PC, und jeder in einer Session muss ihn installiert haben. Da sich alle auch darüber einig sein müssen, welche mod.io-Inhalte jeder besitzt, gibt es einen begleitenden Mod, ModioModNetworker, der mod.io-Avatare und -Maps zwischen Spielern in einer Session synchronisiert.
Installiere Fusion genauso wie alles andere auf der Thunderstore-Seite, und teile ein Mod-Manager-Profil mit denen, mit denen du spielst.
Überprüfen, ob deine Mods geladen wurden
mod.io-Inhalte: einfach nachschauen. Avatare erscheinen an den Avatar-Terminals, Maps in der Levelauswahl. Fehlt etwas, das du abonniert hast, prüfe, ob du im Spiel mit demselben Konto angemeldet bist.
MelonLoader-Mods: neben dem Spiel öffnet sich ein Konsolenfenster, das beim Laden pro Mod eine Zeile mit Name, Version und Autor ausgibt. Das vollständige Log wird hier geschrieben:
BONELAB\MelonLoader\Latest.log
Dieses Log ist das Erste, was man prüfen sollte, wenn ein Mod nicht funktioniert, und das Erste, worum jeder, der dir hilft, bitten wird.
Linux
BONELAB läuft über Proton. MelonLoader benötigt einen DLL-Override, setze also die Steam-Startoptionen des Spiels auf:
WINEDLLOVERRIDES="version=n,b" %command%
Das ist version, nicht winhttp. MelonLoader und BepInEx verwenden unterschiedliche Hook-DLLs, und die Startoptionen zu verwechseln ist ein leicht zu machender Fehler.
Es gibt außerdem einen Linux-Build des MelonLoader Installers. Gale und r2modman setzen den Override automatisch, wenn du über sie startest.
mod.io-Inhalte benötigen unter Linux nichts Besonderes, da sie vollständig im Spiel selbst gehandhabt werden.
Deinstallieren
mod.io: im Spiel oder auf der Website deabonnieren. Die Dateien werden vom Gerät entfernt.
Ein einzelner MelonLoader-Mod: deinstalliere ihn in deinem Mod-Manager, oder lösche seine .dll aus dem Mods-Ordner.
MelonLoader komplett: lösche den Ordner MelonLoader, version.dll, Mods und UserData aus dem Spielverzeichnis, oder nutze die Deinstallationsoption im MelonLoader Installer. Steams Dateiüberprüfung wird das nicht erledigen, da nichts davon von Steam stammt.
Problembehandlung
Das mod.io-Terminal sagt, ich sei nicht angemeldet. Melde dich erneut über mod.io/connect mit dem Code an, den dir das Spiel anzeigt.
Abonnierte Mods erscheinen nicht. Starte das Spiel neu. Abonnements synchronisieren sich beim Start, nicht live.
Quest hat keinen Speicherplatz mehr. Deabonniere, was du nicht nutzt. Maps und Avatare sind groß.
Gar keine MelonLoader-Konsole. MelonLoader lädt nicht. Prüfe, ob version.dll direkt neben BONELAB.exe liegt und ob du über deinen Mod-Manager gestartet hast.
MelonLoader lädt, aber ein Mod nicht. Lies MelonLoader\Latest.log. Eine fehlende oder nicht passende BoneLib-Version ist mit Abstand die häufigste Ursache.
MelonLoader stürzt beim Start ab. Installiere das VC++ 2015-2019 x64 Redistributable und die .NET Desktop Runtime 6.0 x64.
Ein Thunderstore-Mod tut nichts. Prüfe, ob es sich wirklich um einen BONELAB-Mod handelt. Manche Pakete sind gleichzeitig für BONEWORKS gelistet, und BONEWORKS-Mods hängen von ModThatIsNotMod statt von BoneLib ab.
Nach einem Update ist alles kaputt. Patches von Stress Level Zero brechen MelonLoader-Mods. Leere den Mods-Ordner, um zu prüfen, ob das Spiel sauber läuft, und warte dann, bis die Autoren nachziehen.
Fazit
Die entscheidende Frage ist, welches System du brauchst. Avatare, Maps und Spawnables laufen über mod.io, funktionieren auf Quest, und du installierst sie, ohne das Spiel zu verlassen. Code-Mods laufen über MelonLoader, sind nur für PC, und ein Mod-Manager wie Gale macht sie zu einer Zwei-Klick-Angelegenheit.
Wenn du eine eigenständige Quest nutzt, ist mod.io die ganze Geschichte – und das ist eine gute.
Wenn du einen Moment Zeit hast: Die TMC App ist Open Source, befindet sich in einer sehr frühen Entwicklungsphase, und Feedback dazu wäre sehr willkommen.
Siehe auch
- BONELAB auf mod.io
- BONELAB auf Thunderstore
- MelonLoader Wiki
- BONELAB Modding Discord
- BONELAB Wiki
- TMC App
Wir halten diesen Guide so aktuell wie möglich, aber das Spiel, mod.io und MelonLoader ändern sich alle unabhängig voneinander. Solltest du eine Anleitung finden, die nicht mehr mit dem übereinstimmt, was du siehst, melde es bitte oder eröffne einen Pull Request im GitHub-Repository dieses Guides.
Tritt unserem Discord-Server bei, wenn du Fragen hast oder Hilfe bei irgendetwas rund ums Modding brauchst!

