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.

✨ What’s New in 3.0.0

• Complete code structure overhaul with improved logic, readability, and maintainability.
• New Handheld Camera with built-in lighting, zoom controls, and a preview screen.
• Presets System: Save and load camera settings; share them easily via .json files.
• removed legacy "Pinned"/"Head" camera modes.

🎮 Features

• FOV Control

• Preferences Saving

• Auto-Apply & Auto-Save (experimental)

• Offset Adjustments

• Position

  • Rotation

• Smoothing (Stabilization)

• Position

  • Rotation

• Avatar Mesh Toggle

• Hair Meshes

  • Head Meshes

• Post-Processing Adjustments

• Auto Exposure

  • Chromatic Aberration
  • Lens Distortion

• Handheld Camera

• Zoom In/Out

  • Built-in Lighting
  • Preview Screen

• Presets System

• Save/Load settings

  • JSON file sharing

🎮 Handheld Camera Controls

📤 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\Meta\Software\BONELAB

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

📦 Installation

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\Meta\Software\BONELAB\

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:

[Ko-fi – @HL2H0](https://ko-fi.com/hl2h0

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)

Tools

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

💡 Future Plans

• MKGlow support
• Custom UI

📜 Changelog

See the Releases page for detailed 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