Hoe installeer je mods in Boneworks (2026)

Een gids over het downloaden en installeren van mods in BONEWORKS op pc.

BONEWORKS is een VR-only physics sandbox gebouwd in Unity, en de mods worden geladen door MelonLoader in plaats van BepInEx. Dat is het belangrijkste verschil met de meeste Unity-games die mensen modden. Alles staat op Thunderstore.

Ons uitgewerkte voorbeeld is Custom Maps, een map loader waarmee je door de community gemaakte levels aan het spel kunt toevoegen. Hij heeft twee andere mods nodig om te werken, wat hem een nuttig voorbeeld maakt van hoe de stack in elkaar zit.

Vereisten

• Een pc met Windows 10 of nieuwer. Linux via Proton werkt met een extra environment variable, hieronder behandeld.
• BONEWORKS op Steam, plus een VR-headset en de bijbehorende runtime. Er is geen flatscreen-modus.
• Microsoft Visual C++ 2015-2019 Redistributable, 64 bit. MelonLoader heeft dit nodig.
• .NET Desktop Runtime 6.0, x64. BONEWORKS is een Il2Cpp-game en MelonLoader vereist dit voor dergelijke games.
• Een paar honderd MB vrije ruimte, meer als je custom maps verzamelt.

BONEWORKS is singleplayer zonder anti-cheat. Niets hier brengt je account in gevaar.

MelonLoader, geen BepInEx

Als je Lethal Company, Valheim of de meeste andere Unity-games hebt gemodded, heb je BepInEx gebruikt. BONEWORKS gebruikt dat niet.

MelonLoader is een andere universele Unity mod loader, gebouwd door LavaGang, met eersteklas ondersteuning voor Il2Cpp-games zoals deze. Het werkt volgens hetzelfde principe: het hookt het spel bij het opstarten en laadt mods, maar de mapstructuur en de installer zijn hun eigen ding.

MelonLoader-mods zijn .dll-bestanden die in een Mods-map in de gamemap komen, niet in BepInEx/plugins.

ModThatIsNotMod

Bijna elke BONEWORKS-mod die je daadwerkelijk wilt, is afhankelijk van ModThatIsNotMod van gnonme. Het is de gedeelde library voor dit spel: het regelt het laden van custom items, geeft mod-auteurs helpers voor de systemen van het spel, en is waarop de rest van het ecosysteem is gebouwd.

Custom Maps heeft dit nodig, samen met FieldInjection. De volledige stack voor ons voorbeeld is dus:

MelonLoader  ->  ModThatIsNotMod + FieldInjection  ->  Custom Maps

Een mod manager regelt dat allemaal voor je.

Een woordje over BONELAB-mods

BONEWORKS en BONELAB zijn aparte games met aparte Thunderstore-communities, en sommige packages staan onder beide vermeld. Die cross-listing betekent niet altijd iets.

Hitmarkers is degene waar mensen het vaakst tegenaan lopen. Hij verschijnt in de BONEWORKS-listings, maar elke uitgebrachte versie is afhankelijk van BoneLib, een BONELAB-library zonder BONEWORKS-equivalent, en de eigen beschrijving zegt dat hij is herwerkt voor BONELAB. Het hier installeren doet niet wat je wilt.

De vuistregel: als een BONEWORKS-mod ModThatIsNotMod als dependency vermeldt, is het echt een BONEWORKS-mod. Als hij BoneLib vermeldt, is het een BONELAB-mod die toevallig cross-listed is.

Installeren met Gale

Gale is de makkelijkste route en regelt MelonLoader voor je.

1. Download Gale van Thunderstore of GitHub.
2. Open het en selecteer BONEWORKS.
3. Laat het je Steam-installatie vinden, of wijs zelf de gamemap aan.
4. Open Browse mods, zoek naar Custom Maps, en klik op Install.
5. MelonLoader, ModThatIsNotMod en FieldInjection worden er automatisch bij geïnstalleerd.
6. Klik op Launch game (modded).

BONEWORKS starten vanuit Steam start het ongemodded. Start vanuit Gale.

Installeren met r2modman

r2modman werkt op dezelfde manier.

1. Installeer r2modman en selecteer BONEWORKS.
2. Maak een profiel aan.
3. Open Online, zoek naar Custom Maps, en gebruik Download with dependencies.
4. Klik op Start modded.

Beide zijn prima. Gale is lichter; r2modman heeft bredere platformondersteuning.

MelonLoader zelf installeren

Handig om te weten als je liever geen manager gebruikt, of als een manager problemen geeft.

Zoek eerst je gamemap op. Klik met de rechtermuisknop op BONEWORKS in Steam, dan Manage en Browse local files:

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

Je zoekt naar BONEWORKS.exe.

De geautomatiseerde installer

Dit is de aanbevolen manier en het is echt makkelijk.

1. Download de MelonLoader Installer.
2. Voer hem uit. Hij scant naar geïnstalleerde Unity-games en zou BONEWORKS vanzelf moeten tonen. Zo niet, gebruik dan Add Game Manually en wijs BONEWORKS.exe aan.
3. Klik op BONEWORKS in de lijst, kies een versie, en klik op Install.

WAARSCHUWING - Laat de nightly builds-schakelaar met rust. Nightlies worden gegenereerd uit de laatste commits en breken regelmatig dingen. De stabiele release is waar mods tegen gebouwd worden.

De handmatige methode

1. Download MelonLoader.x64.zip. BONEWORKS is 64-bit.
2. Pak de MelonLoader-map uit de zip uit in de BONEWORKS-map.
3. Pak ook version.dll uit dezelfde zip uit in de BONEWORKS-map.
4. Start het spel eenmaal op zodat MelonLoader zijn mappen aanmaakt, en sluit het daarna af.

Je zou nu een MelonLoader-map, een version.dll en een Mods-map naast BONEWORKS.exe moeten hebben.

Mods handmatig installeren

Met MelonLoader op zijn plek zijn mods eenvoudig.

1. Open de Thunderstore-pagina van de mod en klik op Manual Download.
2. Pak de zip uit.
3. Kopieer de .dll naar de Mods-map in je BONEWORKS-directory.

Voor Custom Maps betekent dat drie afzonderlijke downloads, aangezien je ook ModThatIsNotMod en FieldInjection nodig hebt. Haal elk in de versie die de Dependencies-sectie van de mod vermeldt, en kopieer elke .dll naar Mods.

Sommige mods leveren extra content mee naast de .dll, zoals map- of modelbestanden. Lees de beschrijving van de mod om te weten waar die naartoe moeten. Custom Maps leest bijvoorbeeld mapbestanden uit zijn eigen map in plaats van uit Mods.

LET OP - De manifest.json, icon.png en README.md in een Thunderstore-zip zijn verpakkingsbestanden voor de website. Ze doen niets in de Mods-map.

Installeren met de TMC App

Als afsluiter van de lijst is onze eigen tool. The TMC App is een mod manager en server browser die wij bouwen, met one-click installs en sandboxes: benoemde mod-profielen per game, elk met een eigen laadvolgorde en installatiemethode, die je kunt wisselen zonder ook maar iets opnieuw te downloaden.

BONEWORKS staat nog niet in de lijst met ondersteunde games. Een game toevoegen is vier JSON-bestanden en geen code, dus het is een klein klusje en MelonLoader-games zijn precies het soort dat het plugin-systeem hoort te dekken.

Het eerlijke verhaal: de app bevindt zich in een zeer vroeg ontwikkelingsstadium. We zeggen dat in de README en we zeggen het hier ook. Veel ervan is maar gedeeltelijk getest, dus zie het als iets om náást Gale te proberen, niet als vervanging ervoor. Als je het toch probeert, laat ons dan weten wat er gebeurde, want dat is op dit moment het nuttigste wat iemand voor het project kan doen.

De app is open source onder GPL-3.0 op github.com/modcommunity/tmc-app. Bugs en feature-verzoeken kun je melden in de issue tracker, pull requests zijn welkom, en de repository documenteert het per-game formaat als je zelf BONEWORKS-ondersteuning wilt toevoegen.

Installeren:

• Linux: één regel, geen root en geen package manager nodig.

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

• Windows: de setup.exe of setup.msi van de releasepagina. Er is ook een portable build, al registreert die de launcher-invoer of de tmc://-linkhandler niet.
• macOS: de .dmg van dezelfde releasepagina.

Controleren of het werkt

MelonLoader opent bij het opstarten een consolevenster naast het spel. Tijdens het opstarten toont het zijn eigen versie en vervolgens per geladen mod een regel met de modnaam, versie en auteur.

Er worden ook logs op schijf weggeschreven:

BONEWORKS\MelonLoader\Latest.log

Dat bestand is het eerste waar je naar kijkt als iets niet werkt, en het eerste wat iedereen die je helpt zal vragen.

Specifiek voor Custom Maps voegt de mod een eigen manier toe om in-game een level te kiezen zodra je mapbestanden hebt geïnstalleerd.

Draaien op Linux

BONEWORKS draait via Proton. MelonLoader heeft een DLL-override nodig om geladen te worden, dus stel de Steam-opstartopties van het spel in op:

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

Let op: dit is version, niet winhttp. MelonLoader gebruikt een andere hook-DLL dan BepInEx, en de BepInEx-opstartoptie zomaar overnemen is een veelgemaakte fout.

De MelonLoader-installer heeft ook een Linux-build als je het liever niet handmatig doet. Gale en r2modman stellen de override zelf al in wanneer je via hen start.

Mods verwijderen

Verwijder de .dll uit de Mods-map, of deïnstalleer via je mod manager.

Om MelonLoader volledig te verwijderen, verwijder je de MelonLoader-map, version.dll, de Mods-map en de UserData-map uit de spelmap. De MelonLoader Installer heeft ook een deïnstallatie-optie die dit voor je doet.

Steam's Verify integrity of game files ruimt niets hiervan op, omdat Steam geen registratie heeft van bestanden die het zelf niet heeft geïnstalleerd.

Problemen oplossen

Geen consolevenster en geen mods. MelonLoader laadt niet. Controleer of version.dll direct naast BONEWORKS.exe staat, en of je via je mod manager hebt gestart in plaats van via Steam.

MelonLoader laadt wel, maar een mod niet. Open MelonLoader\Latest.log. Ontbrekende dependencies en versieconflicten zijn daar duidelijk te zien.

MelonLoader crasht bij het opstarten. Meestal ontbreekt er een vereiste. Installeer de VC++ 2015-2019 x64 redistributable en de .NET Desktop Runtime 6.0 x64, die Il2Cpp-games nodig hebben.

Een mod is prima geïnstalleerd maar doet helemaal niets. Controleer of het wel echt een BONEWORKS-mod is. Als de dependency-lijst BoneLib vermeldt, is het een BONELAB-mod die toevallig ook hier vermeld staat.

Alles ging kapot na een game-update. BONEWORKS wordt tegenwoordig niet vaak geüpdatet, maar als het gebeurt, moeten MelonLoader en de mods allebei bijgewerkt worden. Maak de Mods-map leeg om te bevestigen dat het spel zelf werkt, en wacht daarna af.

VR-runtime-fouten na het installeren van mods. Probeer eerst zonder mods te starten om te bevestigen dat de headset-kant werkt. Modproblemen en SteamVR-problemen lijken van binnenuit een headset op elkaar.

Conclusie

BONEWORKS modden is eenvoudig zodra je weet dat het MelonLoader is in plaats van BepInEx, en dat ModThatIsNotMod de bibliotheek is waar al het andere op rust. Installeer Gale, installeer de mod die je wilt, en start via Gale.

De enige BONEWORKS-specifieke valkuil is dubbel-gelijste BONELAB-pakketten. Controleer de dependency-lijst voordat je installeert: ModThatIsNotMod betekent BONEWORKS, BoneLib betekent BONELAB.

Als je ergens mee wilt helpen: de TMC App is open source en bevindt zich in een vroeg stadium van ontwikkeling, en feedback erover betekent ontzettend veel voor ons.

Zie ook

• BONEWORKS op Thunderstore
• MelonLoader Wiki - De eigen documentatie van de loader, de moeite waard om te lezen.
• MelonLoader op GitHub
• BONEWORKS Modding Discord
• BONEWORKS Wiki
• TMC App

We houden deze gids zo actueel mogelijk bij, maar MelonLoader en de mods die erop gebouwd zijn veranderen na verloop van tijd. Als een instructie hier niet meer overeenkomt met wat je ziet, meld dit dan of open een pull request op de GitHub-repository van deze gids.

Sluit je aan bij onze Discord-server als je vragen hebt of hulp wilt bij iets modding-gerelateerds!