Installing Bonelab Code Mods on Meta Quest Headsets

How to install Bonelab mods on your Quest headset

Bonelab mods on Quest require two things: a PC connected to your headset via USB cable, and the mod files themselves placed in the correct folder on your Quest's storage. The process is straightforward — you copy files to a specific location, restart the game, and the mods load automatically. Most mods for Bonelab are code mods (not asset replacements), which means they change how the game behaves rather than how it looks.

The fastest route is using a mod manager tool like BoneLib Mod Manager, which handles the folder structure for you. If you prefer to do it manually, you'll be moving files through your PC's file explorer to your Quest's internal storage using a USB connection.

Key Takeaways

Bonelab mods go into a specific folder on your Quest's internal storage that you access through a USB cable connected to a PC.
You need BoneLib installed in Bonelab first — this is a framework that allows code mods to run, and it comes from the same community sources as the mods themselves.
A mod manager tool like BoneLib Mod Manager automates file placement, but manual installation through file explorer works if you follow the folder path exactly.
After placing mod files, restart Bonelab completely — closing and reopening the app — for the mods to load.

Setting up your PC and Quest connection

Connect your Quest headset to your PC using a USB-C cable. When you plug in, your Quest will ask whether to allow file access — tap "Allow" or "Always Allow". On your PC, open File Explorer and look for your Quest device in the left sidebar under "This PC" or similar (the exact name depends on your Windows or Mac version).

Once you can see your Quest's folders in File Explorer, navigate to Quest/Internal Storage/Android/data/com.StressLevelZero.Bonelab/files. This is where Bonelab stores its mod folder. If you don't see an "Android" folder, your Quest may not have recognized the connection properly — disconnect, reconnect, and confirm the permission prompt again.

Installing BoneLib (the mod framework)

Before any code mods will work, Bonelab needs BoneLib installed. BoneLib is a framework — a foundation that lets mods communicate with the game. You'll find BoneLib on community mod sites like Thunderstore or the Bonelab modding Discord. read the BoneLib file (it will be a .zip file).

Extract the .zip file on your PC. Inside, you'll see a folder structure. Copy the entire contents into the mods folder on your Quest (the path from the previous section). If there is no "mods" folder yet, create one inside the "files" directory. After copying BoneLib, restart Bonelab on your Quest — close the app completely and reopen it. BoneLib should load silently in the background.

Downloading and placing code mods

Find the mods you want from trusted sources like Thunderstore (search "Bonelab") or the official Bonelab modding Discord. read each mod as a .zip file. Extract each one on your PC — you'll see a folder with the mod's name inside.

Copy each extracted mod folder into the mods directory on your Quest (the same location where you placed BoneLib). Each mod gets its own folder. For example, if you're installing a mod called "ExampleMod", the path should be Quest/Internal Storage/Android/data/com.StressLevelZero.Bonelab/files/mods/ExampleMod. Do not place the .zip file itself — extract it first, then copy the folder.

Using a mod manager tool instead

If manual folder navigation feels error-prone, BoneLib Mod Manager handles the file placement for you. read it from the Bonelab modding Discord or Thunderstore. The tool runs on your PC and connects to your Quest the same way — via USB cable.

Open the mod manager, point it to your Quest, and it will show you a list of available mods. Select the ones you want, click "Install", and the tool copies them to the correct folders automatically. This eliminates the risk of placing files in the wrong location. After installation, restart Bonelab on your Quest just as you would with manual installation.

Restarting Bonelab and confirming mods loaded

Close Bonelab completely on your Quest — swipe up from the bottom of the screen and close the app from the recents menu, or use the power menu. Wait a few seconds, then reopen Bonelab. The game will load BoneLib and any mods you've placed in the mods folder.

Most mods don't show a splash screen or notification — they straightforward work. If a mod adds a menu or new content, you'll see it in the game. If nothing appears to have changed, check that the mod folder path is exactly correct and that you extracted the .zip files before copying them. A common mistake is copying the .zip file itself instead of the folder inside it.

Troubleshooting mods that don't load

If mods aren't appearing in Bonelab, first confirm BoneLib loaded by checking the Bonelab modding Discord or community forums — they often have a status channel. If BoneLib didn't load, the mod folder path may be wrong. Disconnect your Quest, reconnect it, and verify the path Android/data/com.StressLevelZero.Bonelab/files/mods exists exactly as written.

If the path is correct but mods still don't load, the mod files themselves may be corrupted or incompatible with your version of Bonelab. Check the mod's page on Thunderstore or Discord for version requirements. Some mods are built for specific Bonelab updates and won't work on others. Removing the mod folder and restarting Bonelab will return the game to its unmodded state.

Frequently Asked Questions

Do I need a PC to install mods on Quest?

Yes. Quest stores files in a location that only a PC can access via USB cable. You cannot install mods using only the Quest headset itself. The PC connection is required every time you add or remove mods.

What if I don't see the Android folder on my Quest?

The Android folder is hidden by default on some systems. On Windows, open File Explorer, go to View, and check "Hidden items". On Mac, press Command+Shift+Period in Finder. If it still doesn't appear, your Quest may not have granted file access — disconnect, reconnect, and confirm the permission prompt on the headset itself.

Can I install mods directly from my Quest without a PC?

No. Bonelab mods must be placed in a folder that only a PC can reach through USB. There is no way to install them through the Quest's app store or settings menu.

Will mods break my game or cause crashes?

Mods can cause crashes if they conflict with each other or if they're incompatible with your Bonelab version. Start by installing one or two mods and testing them. If the game crashes, remove the most recent mod and restart. This helps you identify which mod is causing the problem.

How do I remove mods?

Delete the mod folder from Quest/Internal Storage/Android/data/com.StressLevelZero.Bonelab/files/mods on your PC, then restart Bonelab on your Quest. The mod will no longer load. You can remove individual mods by deleting only their folder, leaving others intact.

This guide is for general information only and is not medical, financial, legal, or other professional advice. For decisions specific to your situation, consult a qualified professional. See our Editorial Policy.