Wie man Mods in Boneworks installiert (2026)

Eine Anleitung zum Herunterladen und Installieren von Mods in BONEWORKS auf dem PC.

BONEWORKS ist eine reine VR-Physik-Sandbox, gebaut mit Unity, deren Mods über MelonLoader statt BepInEx geladen werden. Das ist der Hauptunterschied zu den meisten Unity-Spielen, die üblicherweise gemoddet werden. Alles findet sich auf Thunderstore.

Unser Beispiel ist Custom Maps, ein Map-Loader, mit dem man von der Community erstellte Levels ins Spiel einbinden kann. Er benötigt zwei weitere Mods, um zu funktionieren, was ihn zu einem guten Beispiel dafür macht, wie der Stack zusammenspielt.

Voraussetzungen

• Ein PC mit Windows 10 oder neuer. Linux über Proton funktioniert mit einer zusätzlichen Umgebungsvariable, siehe weiter unten.
• BONEWORKS auf Steam, sowie ein VR-Headset und dessen Runtime. Es gibt keinen Flatscreen-Modus.
• Microsoft Visual C++ 2015-2019 Redistributable, 64 Bit. MelonLoader benötigt es.
• .NET Desktop Runtime 6.0, x64. BONEWORKS ist ein Il2Cpp-Spiel und MelonLoader benötigt dies dafür.
• Ein paar hundert MB freien Speicherplatz, mehr, wenn man Custom Maps sammelt.

BONEWORKS ist Singleplayer ohne Anti-Cheat. Nichts hier gefährdet euren Account.

MelonLoader, nicht BepInEx

Wer Lethal Company, Valheim oder die meisten anderen Unity-Spiele gemoddet hat, kennt BepInEx. BONEWORKS nutzt es nicht.

MelonLoader ist ein anderer universeller Unity-Mod-Loader, entwickelt von LavaGang, mit erstklassiger Unterstützung für Il2Cpp-Spiele wie dieses. Er funktioniert nach dem gleichen Prinzip: Er hakt sich beim Start ins Spiel ein und lädt Mods, aber die Ordnerstruktur und der Installer sind eigenständig.

MelonLoader-Mods sind .dll-Dateien, die in einen Mods-Ordner im Spielverzeichnis gehören, nicht in BepInEx/plugins.

ModThatIsNotMod

Fast jeder BONEWORKS-Mod, den man tatsächlich haben will, hängt von ModThatIsNotMod von gnonme ab. Es ist die gemeinsame Bibliothek für dieses Spiel: Es kümmert sich um das Laden benutzerdefinierter Items, gibt Mod-Autoren Helfer für die Systeme des Spiels an die Hand und ist die Grundlage, auf der der Rest des Ökosystems aufbaut.

Custom Maps benötigt es, zusammen mit FieldInjection. Der vollständige Stack für unser Beispiel sieht also so aus:

MelonLoader  ->  ModThatIsNotMod + FieldInjection  ->  Custom Maps

Ein Mod-Manager erledigt das alles für euch.

Ein Wort zu BONELAB-Mods

BONEWORKS und BONELAB sind separate Spiele mit separaten Thunderstore-Communitys, und manche Pakete sind bei beiden gelistet. Diese Cross-Listung ist nicht immer aussagekräftig.

Hitmarkers ist der Mod, bei dem das am häufigsten passiert. Er erscheint in den BONEWORKS-Listings, aber jede veröffentlichte Version hängt von BoneLib ab, einer BONELAB-Bibliothek ohne BONEWORKS-Äquivalent, und in der eigenen Beschreibung steht, dass er für BONELAB überarbeitet wurde. Ihn hier zu installieren, bringt nicht das gewünschte Ergebnis.

Faustregel: Listet ein BONEWORKS-Mod ModThatIsNotMod als Abhängigkeit, ist es tatsächlich ein BONEWORKS-Mod. Listet er BoneLib, ist es ein BONELAB-Mod, der zufällig cross-gelistet ist.

Installation mit Gale

Gale ist der einfachste Weg und kümmert sich für euch um MelonLoader.

1. Ladet Gale von Thunderstore oder GitHub herunter.
2. Öffnet es und wählt BONEWORKS.
3. Lasst es eure Steam-Installation finden, oder gebt den Spielordner selbst an.
4. Öffnet Browse mods, sucht nach Custom Maps, und klickt Install.
5. MelonLoader, ModThatIsNotMod und FieldInjection werden dabei mitinstalliert.
6. Klickt auf Launch game (modded).

BONEWORKS über Steam zu starten startet es ungemoddet. Startet es über Gale.

Installation mit r2modman

r2modman funktioniert genauso.

1. Installiert r2modman und wählt BONEWORKS.
2. Erstellt ein Profil.
3. Öffnet Online, sucht nach Custom Maps, und nutzt Download with dependencies.
4. Klickt auf Start modded.

Beides funktioniert gut. Gale ist schlanker; r2modman hat breitere Plattformunterstützung.

MelonLoader selbst installieren

Nützlich zu wissen, wenn ihr lieber keinen Manager verwenden wollt, oder wenn ein Manager Probleme macht.

Sucht zunächst euren Spielordner. Rechtsklick auf BONEWORKS in Steam, dann Manage und Browse local files:

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

Ihr sucht nach BONEWORKS.exe.

Der automatisierte Installer

Das ist der empfohlene Weg, und er ist wirklich einfach.

1. Ladet den MelonLoader Installer herunter.
2. Führt ihn aus. Er scannt nach installierten Unity-Spielen und sollte BONEWORKS von selbst auflisten. Falls nicht, nutzt Add Game Manually und gebt BONEWORKS.exe an.
3. Klickt BONEWORKS in der Liste an, wählt eine Version und klickt auf Install.

WARNUNG - Lasst den Schalter für Nightly Builds unangetastet. Nightlies werden aus den neuesten Commits generiert und brechen regelmäßig Dinge. Die Stable-Version ist das, worauf Mods gebaut werden.

Die manuelle Methode

1. Ladet MelonLoader.x64.zip herunter. BONEWORKS ist 64-Bit.
2. Entpackt den MelonLoader-Ordner aus der Zip-Datei in den BONEWORKS-Ordner.
3. Entpackt version.dll aus derselben Zip-Datei ebenfalls in den BONEWORKS-Ordner.
4. Startet das Spiel einmal, damit MelonLoader seine Ordner erzeugt, und beendet es dann wieder.

Ihr solltet jetzt einen MelonLoader-Ordner, eine version.dll und einen Mods-Ordner neben BONEWORKS.exe haben.

Mods manuell installieren

Mit installiertem MelonLoader sind Mods unkompliziert.

1. Öffnet die Thunderstore-Seite des Mods und klickt auf Manual Download.
2. Entpackt die Zip-Datei.
3. Kopiert die .dll in den Mods-Ordner in eurem BONEWORKS-Verzeichnis.

Für Custom Maps bedeutet das drei separate Downloads, da du auch ModThatIsNotMod und FieldInjection benötigst. Lade jedes davon in der Version herunter, die im Dependencies-Abschnitt des Mods angegeben ist, und kopiere jede .dll in den Mods-Ordner.

Manche Mods bringen neben der .dll noch zusätzlichen Inhalt mit, etwa Karten- oder Modelldateien. Lies die Beschreibung des Mods, um herauszufinden, wohin diese gehören. Custom Maps zum Beispiel liest Kartendateien aus seinem eigenen Ordner statt aus Mods.

HINWEIS - Die manifest.json, icon.png und README.md in einem Thunderstore-Zip sind Verpackungsdateien für die Website. Im Mods-Ordner bewirken sie nichts.

Installation mit der TMC App

Zum Abschluss unser eigenes Tool. Die TMC App ist ein von uns entwickelter Mod-Manager und Server-Browser mit One-Click-Installationen und Sandboxes: benannte Mod-Profile pro Spiel, jedes mit eigener Ladereihenfolge und Bereitstellungsmethode, umschaltbar ohne irgendetwas erneut herunterzuladen.

BONEWORKS steht noch nicht auf der Liste der unterstützten Spiele. Ein Spiel hinzuzufügen bedeutet vier JSON-Dateien und keinen Code, ist also eine kleine Aufgabe, und MelonLoader-Spiele sind genau die Art von Sache, die das Plugin-System abdecken soll.

Der ehrliche Teil: die App befindet sich in einer sehr frühen Entwicklungsphase. Das sagen wir in ihrem README, und wir sagen es auch hier. Vieles davon ist nur teilweise getestet, behandle sie also eher als etwas, das man neben Gale ausprobiert, statt als Ersatz. Solltest du sie ausprobieren, sag uns bitte, was passiert ist, denn das ist derzeit der nützlichste Beitrag, den jemand für das Projekt leisten kann.

Sie ist Open Source unter GPL-3.0 auf github.com/modcommunity/tmc-app. Bugs und Feature-Wünsche gehören in den Issue-Tracker, Pull Requests sind willkommen, und das Repository dokumentiert das Format pro Spiel, falls du selbst BONEWORKS-Unterstützung hinzufügen möchtest.

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.exe oder setup.msi von der Releases-Seite. Es gibt auch einen portablen Build, der jedoch weder den Launcher-Eintrag noch den tmc://-Link-Handler registriert.
• macOS: die .dmg von derselben Releases-Seite.

Überprüfen, ob es funktioniert hat

MelonLoader öffnet beim Start ein Konsolenfenster neben dem Spiel. Beim Hochfahren gibt es zunächst seine eigene Version aus und dann eine Zeile pro Mod beim Laden, mit Mod-Name, Version und Autor.

Logs werden ebenfalls auf die Festplatte geschrieben:

BONEWORKS\MelonLoader\Latest.log

Diese Datei ist das Erste, worauf man schauen sollte, wenn etwas nicht funktioniert, und das Erste, wonach jeder fragen wird, der dir hilft.

Speziell für Custom Maps fügt der Mod eine eigene Möglichkeit hinzu, im Spiel ein Level auszuwählen, sobald Kartendateien installiert sind.

Unter Linux ausführen

BONEWORKS läuft über Proton. MelonLoader benötigt einen DLL-Override, um geladen zu werden, also setze die Steam-Startoptionen des Spiels auf:

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

Beachte, dass es sich hier um version handelt, nicht um winhttp. MelonLoader verwendet eine andere Hook-DLL als BepInEx, und die BepInEx-Startoption einfach zu übernehmen, ist ein häufiger Fehler.

Der MelonLoader-Installer besitzt auch einen Linux-Build, falls du es nicht von Hand machen möchtest. Gale und r2modman setzen den Override beide selbst, wenn du das Spiel über sie startest.

Mods entfernen

Lösche die .dll aus dem Mods-Ordner, oder deinstalliere sie über deinen Mod-Manager.

Um MelonLoader vollständig zu entfernen, lösche den Ordner MelonLoader, die version.dll, den Ordner Mods und den Ordner UserData aus dem Spielverzeichnis. Der MelonLoader Installer hat auch eine Deinstallationsoption, die das für dich erledigt.

Steams Spieldateien auf Integrität überprüfen räumt davon nichts auf, da Steam keine Aufzeichnung über Dateien hat, die es nicht selbst installiert hat.

Fehlerbehebung

Kein Konsolenfenster und keine Mods. MelonLoader lädt nicht. Prüfe, ob version.dll direkt neben BONEWORKS.exe liegt und ob du über deinen Mod-Manager statt über Steam gestartet hast.

MelonLoader lädt, aber ein Mod nicht. Öffne MelonLoader\Latest.log. Fehlende Abhängigkeiten und Versionskonflikte zeigen sich dort deutlich.

MelonLoader stürzt beim Start ab. Meist fehlt eine Voraussetzung. Installiere das VC++ 2015-2019 x64 Redistributable und die .NET Desktop Runtime 6.0 x64, die Il2Cpp-Spiele benötigen.

Ein Mod wurde erfolgreich installiert, tut aber nichts. Prüfe, ob es sich tatsächlich um einen BONEWORKS-Mod handelt. Wenn seine Abhängigkeitsliste BoneLib nennt, handelt es sich um einen BONELAB-Mod, der zufällig auch dort gelistet ist.

Nach einem Spiel-Update ist alles kaputt. BONEWORKS wird heutzutage nicht oft aktualisiert, aber wenn doch, müssen sowohl MelonLoader als auch die Mods nachziehen. Leere den Mods-Ordner, um zu prüfen, ob das Spiel selbst in Ordnung ist, und warte dann ab.

VR-Laufzeitfehler nach der Mod-Installation. Versuche zunächst, ohne Mods zu starten, um zu prüfen, ob die Headset-Seite funktioniert. Mod-Probleme und SteamVR-Probleme sehen aus dem Headset heraus ähnlich aus.

Fazit

Das Modden von BONEWORKS ist einfach, sobald man weiß, dass es MelonLoader statt BepInEx verwendet und dass ModThatIsNotMod die Bibliothek ist, auf der alles andere aufbaut. Installiere Gale, installiere den gewünschten Mod und starte über Gale.

Die eine BONEWORKS-spezifische Falle sind querverlinkte BONELAB-Pakete. Prüfe die Abhängigkeitsliste vor der Installation: ModThatIsNotMod bedeutet BONEWORKS, BoneLib bedeutet BONELAB.

Wenn du bei etwas helfen möchtest: Die TMC App ist Open Source und befindet sich in einer frühen Entwicklungsphase, und Feedback dazu ist uns sehr viel wert.

Siehe auch

• BONEWORKS auf Thunderstore
• MelonLoader Wiki - Die eigene Dokumentation des Loaders, lesenswert.
• MelonLoader auf GitHub
• BONEWORKS Modding Discord
• BONEWORKS Wiki
• TMC App

Wir halten diesen Guide so aktuell wie möglich, aber MelonLoader und die darauf aufbauenden Mods ändern sich mit der Zeit. Falls eine Anleitung hier nicht mehr mit dem übereinstimmt, was du siehst, melde es bitte oder ö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!