Zooks-BoneFPS icon

BoneFPS

The go-to FPS mod for BONELAB

Last updated a week ago
Total downloads 5483
Total rating 5 
Categories Code Mods
Dependency string Zooks-BoneFPS-1.2.5
Dependants 0 other packages depend on this package

This mod requires the following mods to function

LavaGang-MelonLoader-0.6.6 icon
LavaGang-MelonLoader

The World's First Universal Mod Loader for Unity Games compatible with both Il2Cpp and Mono

Preferred version: 0.6.6
gnonme-BoneLib-3.0.0 icon
gnonme-BoneLib

A BONELAB mod for making life easier for other mod creators.

Preferred version: 3.0.0

README

BoneFPS

BoneFPS BONELAB MelonLoader Downloads

Thank you for 4,400+ downloads. Next milestone: 5,000.

The go-to FPS mod for BONELAB. No visual downgrades if you choice, just more frames.

BoneFPS works by managing what your GPU actually needs to render at any given moment. Far away objects don't need shadows. Mirrors you can't see don't need to render. Lights across the map don't need to be active. The game doesn't do this well on its own — BoneFPS does.


What It Does

BoneFPS runs a set of distance-based systems that reduce GPU and CPU workload without touching anything you can actually see. Everything is reversible and nothing is permanently changed.

Shadow Management

  • Tracks every shadow-casting object in the scene
  • Disables shadow casting on objects beyond the shadow draw distance
  • Limits total shadow casters to a configurable budget (default 20)
  • Uses hysteresis so shadows don't flicker on/off at boundaries
  • NPCs and characters are never affected — their shadows always work normally
  • Adjusts global shadow distance based on your current FPS automatically

Light Culling

  • Distant point lights and spot lights get disabled entirely
  • Mid-range lights lose their shadows and switch to cheap vertex lighting
  • Nearby lights stay at full quality
  • Character lights (hair, face, rim lights) are detected and never touched
  • Directional lights (sun) are always left alone IDK IF THIS WORKS LOL

Animation Throttle

  • Far away environment animators update less frequently
  • Very distant animators pause entirely
  • Character and NPC animators are detected and always run at full speed
  • No choppy NPCs, no broken ragdolls

Camera Culling

  • Finds secondary cameras (mirrors, security monitors, render textures)
  • Disables them when you're far away
  • Re-enables them when you get close
  • Main camera is never affected

Particle Management

  • Pauses particle systems that are far from you
  • Resumes them when you approach
  • Caps maximum particle counts per system based on perf level

LOD Override

  • Forces lower LOD levels on distant objects
  • Lets nearby objects use their full detail mesh
  • Smoothly transitions based on distance

Trail Culling

  • Disables trail renderers on distant objects
  • Restores them up close

Quality Settings

  • Reduces shadow cascades (big perf win, barely visible difference)
  • Disables soft shadows through URP pipeline
  • Reduces MSAA (huge GPU save in VR)
  • Limits pixel light count
  • Enables SRP batcher
  • Warms all shaders on scene load to prevent first-use stutters
  • Configures async upload for smoother loading

What It Doesn't Do

  • Does not disable fog, reflections, or post-processing — those are visual features
  • Does not reduce render resolution during gameplay
  • Does not touch NPC bones or skin quality spawned NPCs always look and animate correctly
  • Does not mess with physics timestep slow-mo works perfectly
  • Does not touch OpenXR or SteamVR no VR runtime crashes

Platform Support

Platform Status Notes
PC (SteamVR) ✅ Fully supported Standard MelonLoader + BoneLib
PC (Oculus Link/Air Link) ✅ Fully supported Standard MelonLoader + BoneLib
PC (Virtual Desktop OpenXR) ✅ Fully supported Standard MelonLoader + BoneLib
Quest 2 (Native) ✅ Supported Requires LemonLoader + Quest BoneLib
Quest 3 (Native) ✅ Supported Requires LemonLoader + Quest BoneLib
Quest 3S (Native) ✅ Supported Requires LemonLoader + Quest BoneLib

Quest Installation

  1. Install LemonLoader (the Android/Quest fork of MelonLoader)
  2. Install the Quest version of BoneLib
  3. Drop BoneFPS.dll into the Mods folder on your Quest
  4. Launch BONELAB

Tip for Quest users: Start with the MAX FPS preset. Quest hardware benefits the most from aggressive shadow culling and MSAA reduction. You can dial it back from there if you want better visuals.


Presets

Open BoneMenu and pick one:

Preset What It Does
QUALITY+ Light optimizations only. Shadow culling, animation throttle, LOD management. Full MSAA, full pixel lights, wide distances. For decent hardware that just needs a small boost.
BALANCED All systems active. Reduced shadow distance, fewer shadow casters, tighter culling distances. Good for mid-range setups.
MAX FPS Everything cranked. Short shadow distance, aggressive culling, minimal pixel lights, no MSAA. For Quest standalone or struggling hardware.

Or configure everything individually through the Optimizations menu.


Settings

Performance Level (0-3)

Controls how aggressive the global quality reductions are. 0 = lightest, 3 = heaviest.

Distances

Setting Default What It Controls
Near Distance 12m Objects closer than this get full quality
Mid Distance 35m Objects in this range get reduced shadows/lighting
Far Distance 70m Objects beyond this get maximum reduction

Max Shadow Casters

Default: 20. How many objects can cast shadows at once. Lower = more FPS, but fewer shadows on mid-range objects.


Installation

Requirements

Install

  1. Download BoneFPS.dll from the latest release
  2. Drop it in BONELAB/Mods/
  3. Launch the game

  4. Works with Bonelib to Disable And Enable Settings


Accessing Settings In-Game

  1. Hold B on your VR controller to open BoneMenu
  2. Navigate to BoneFPS 1.2.5
  3. Pick a preset or go into Optimizations to toggle individual systems

LET ME KNOW IF THERES IS ISSUES GO TO REDDIT AND GO TO BONELAB REDDIT AND SAY THE ISSUES THATS IN THE MOD HAV.PLEASE I NEED THEM