WideEye

Note: These modifications apply only to the spectator view and do not affect the VR headset display.

WideEye is a BONELAB mod built to give creators full control over the spectator camera. From precise FOV tuning to post-processing effects, smoothing, and a powerful handheld camera—WideEye enhances content creation with intuitive tools and customization options.

Features

• FOV Control
• Preferences Saving
• Auto-Apply & Auto-Save
• Offset Adjustments
  • Position
  • Rotation
• Smoothing (Stabilization)
  • Position
  • Rotation
• Avatar Mesh Toggle
  • Head Offset
  • Hair Meshes
  • Head Meshes
• Post-Processing Adjustments
  • Auto Exposure
  • Chromatic Aberration
  • Lens Distortion
  • MkGlow
• View Modes
  • Head (First Person)
  • Handheld Camera
  • Free Camera
• Presets System
  • Save/Load settings
  • JSON file sharing

📦 Installation

1. Download the latest release from Thunderstore.
2. Extract the contents of the ZIP.
3. Copy the included Mods folder into your BONELAB root directory.

• Typically found at: C:\Program Files (x86)\Steam\steamapps\common\BONELAB\
• or C:\Program Files\Oculus\Software\Software\BONELAB\

1. Download the handheld camera mod from Mod.io

Then you are ready to go!
Enjoy WideEye!

Note for Updaters : You can now safely remove the md_resources.bundle file from UserData\WideEye Resources\ as now the resources are embedded into the file

🛠 Requirements

• PC
• BONELAB Patch 5/6
• MelonLoader 0.6
• BoneLib 3.1.1
• FieldInjector 2.1.1

Controls

Handheld Camera

Free Camera

📤 Sharing Presets

Sharing your camera presets is easy—here’s how:

Exporting

1. Open the Presets page and click View Path.
2. Your preset file (.json) will be highlighted in the file explorer.
3. Copy that file and send it to a friend.

Importing

1. Have your friend send you their .json preset file.
2. Open the Presets page and click View Folder.
3. Paste the .json file into the folder.
4. Click Refresh in the Presets menu to see the new preset.

As they say: sharing is caring.

💬 GitHub Discussions

WideEye now has a dedicated Discussions page! Whether you want to ask a question, share an idea, or show off your setup — there’s a place for you.

Categories:

• 📢 Announcements — Official updates and news.
• 💬 General — Open talk about anything WideEye-related.
• 💡 Ideas — Suggest features or improvements.
• 📤 Presets — Share your custom camera presets.
• ❓ Q&A — Ask questions or get help using the mod.
• 🎥 Show and Tell — Post your screenshots, videos, or creative setups using WideEye!

Join the conversation here: 👉 github.com/HL2H0/WideEye/discussions

📖 Story Behind WideEye

How It All Started

WideEye actually started from a mix of frustration and curiosity. I was waiting for someone to make a mod that let you change the FOV of BONELAB’s spectator camera—but no one did. I barely knew anything about C# back then, but I had UnityExplorer installed, so I used it to manually change the FOV. It worked... but it was super annoying to do every time.

So I thought, “Screw it, I’ll just make a simple mod that changes the FOV when I press a key.” I gave it a try—and it didn’t work. I spent days trying to fix it, nearly gave up, but then noticed something dumb: there was a space at the end of the camera path. That tiny thing was throwing a NullReferenceException.

I removed the space, launched the game, pressed “F,” and boom—it worked.

I was so hyped I made a GitHub repo, a quick icon, a menu, and even a README all in one night. And just like that, WideEye was born.

💖 Support

WideEye started as a random “what if?” moment—and now it’s an actual tool people use, which is wild.

If you like what I’m doing and want to help fuel future updates (or just keep me stocked with snacks and caffeine), you can toss a coin my way here

No pressure—WideEye will always be free. But every bit of support helps keep the keyboard clacking and the ideas flowing.

🧠 Contributing & Feedback

WideEye is open-source and welcomes suggestions, bug reports, and contributions! You can:

• Open an issue for bugs or suggestions.
• Fork the repo and submit pull requests.
• Leave feedback to help improve future releases.

🙌 Credits

Contributors

• WaveSmash — Smoothing & Rotation Offset (Suggestion)
• xDraxxis — Position Offset & Preferences (Suggestions)
• ThomasSteve83 — Notification Customization (Suggestion)
• Sillycarlow — Free Cam (Suggestion)

Tools

• Aiden – BONELAB Icon Template
• TrevTV – MelonLoader Mod Template

📜ChangeLog

Latest Release 4.0.0

Added

• Timeline compatibility
• MkGlow (Partly)
• Audio Sources
• Handheld Camera
  • Removed grip limit on the handles
  • Syncs with fusion
  • Moved to a separate SDK mod
  • Changed built-in spotlight colors to warm, neutral, and cold
• BoneMenu
  • Presets values view
  • Open Preset Folder button
  • Delete Preset button
  • Avatar Mesh Page
  • Refresh Presets button
• Head Meshes Offset Toggle

Changed

• Decreased built-in spotlight intensity increment to 0.5
• Removed the grip limit for the handheld camera
• Now UserData folder is not required
• Moved md_resources.bundle to an embedded resource for better installation
• Some code refactoring

Fixed

• Handheld camera zoom not working
• Loading Presets with a post-processing effect not applying correctly
• Loading Presets doesn't update the menu
• Saving presets wrongly

visit the Releases page for previous changelogs.

WideEye ChangeLog

[4.0.0] Major Update

Added

• Timeline compatibility
• MkGlow (Partly)
• Audio Sources
• Handheld Camera
  • Removed grip limit on the handles
  • Syncs with fusion
  • Moved to a separate SDK mod
  • Changed built-in spotlight colors to warm, neutral, and cold
• BoneMenu
  • Presets values view
  • Open Preset Folder button
  • Delete Preset button
  • Avatar Mesh Page
  • Refresh Presets button
• Head Meshes Offset Toggle

Changed

• Decreased built-in spotlight intensity increment to 0.5
• Removed the grip limit for the handheld camera
• Now UserData folder is not required
• Moved md_resources.bundle to an embedded resource for better installation
• Some code refactoring

Fixed

• Handheld camera zoom not working
• Loading Presets with a post-processing effect not applying correctly
• Loading Presets doesn't update the menu
• Saving presets wrongly

[3.1.0] Regular Update

Added

• Free Camera Mode
• Added a startup delay slider [Changing it below 2 seconds is not recommended]

Changed

• Some code improvements
• UI Layout
  • Moved the Support Page to the bottom of the main menu
• Removed some unnecessary notifications
  • Replaced all the notifications with a single one that shows when everything is loaded properly.

Fixed

• Fixed Ko-fi Button in the README file
• Fixed ViewPath not opening the file explorer properly. (Again lol)
• Removed leftover logging
• Version number not being right

Known Issues

• After zooming with the free cam and stopping quickly, the FOV may display as a long decimal value

[3.0.1] Hotfix

Added

• Now the mod will check for the resources file, if it's not found,it notifies the user.

Fixed

• Fixed an issue where when you click on ViewPath it opens the file instead of showing it in the explorer.
• Fixed the cameras not syncing FOVs properly.
• Fixed the view mode not being changed properly.

[3.0.0] Major Update

Important: New dependency is required FieldInjector

Added

• Handheld Camera, with :
  • Built-in Lighting
  • Zoom in/out
  • Cool Design
• Presets System
• Complete code overhaul

Changed

• UI Layout
• Removed camera modes (Replaced by the Handheld Camera)

[2.1.0] Regular Update

Added

• Notification Customizability
• Auto Save ( Experimental )

Changed

• Reduced the waiting time form 5 seconds to 3 seconds

Fixed

• A few typos lol
• When preferences is loaded, rotation smoothing loads as position smoothing

[2.0.0] Major Update

Added

• Preferences Saving
• Camera Auto-Finding
• Position Offset
• Post-Processing Control :
  • Auto Exposure
  • Chromatic Aberration
  • Lens Distortion
• Camera Modes :
  • Pinned
  • Head
• Avatar Meshes Control (On | Off) :
  • Hair Meshes
  • Head Meshes

Changed

• UI Improvements

Fixed

• Levels with scene chunks no longer un-finds the camera

[1.2.0] Regular Update

Added

• Smoothing
• Rotation Offset
• Support Page
• Reset All Button
• Notifications

Known Issues

• Position smoothing may cause the spectator camera to clip through head meshes.
• Levels with scene chunks may un-find the camera, but it won't affect the modifications the mod made

[1.1.0] Regular Update

Added

• Added ability to toggle post-processing.
• Added Colors to the mod's menu

Changed

• Changing values won't be accessible when the camera is not found, reducing confusion.

Known Issues

• Levels with scene chunks may un-find the cam, but it won't affect the modifications the mod made

[1.0.0]

• Initial Release