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
  • Hair Meshes
  • Head Meshes
• Post-Processing Adjustments
  • Auto Exposure
  • Chromatic Aberration
  • Lens Distortion
• View Modes
  • Handheld Camera
  • Free Camera
• Presets System
  • Save/Load settings
  • JSON file sharing

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.

As they say: sharing is caring.

Importing

1. Have your friend send you their .json preset file.

2. Paste the file into this folder: [GameRootDir]\UserData\WideEye Resources\Presets

   • the [GameRootDir] For Steam is : C:\Program Files (x86)\Steam\steamapps\common\BONELAB
   • For Meta Link : C:\Program Files\Oculus\Software\Software\BONELAB

3. Reopen the Presets page and you should see the imported preset.

📦 Installation

Note: Mod Managers may not download WideEye correctly. Manual installation is recommended.

1. Download the latest release from Thunderstore.
2. Extract the contents of the ZIP.
3. Copy the included Mods and UserData folders into your BONELAB root directory.
   • Typically found at: C:\Program Files (x86)\Steam\steamapps\common\BONELAB\
   • or C:\Program Files\Oculus\Software\Software\BONELAB\

   Make sure you have copied the UserData folder and the md_resource.bundle inside it, as it contains essential resources for WideEye to function properly.

Then you are ready to go!
Enjoy WideEye!

💬 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

🛠 Requirements

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

📖 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

💡 Future Plans

• MKGlow support
• Custom UI

📜ChangeLog

Latest Release 3.1.0

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

visit the Releases page for previous changelogs.