HL2H0-WideEye icon

WideEye

WideEye is a BONELAB mod that lets users customize spectator camera options, such as FOV and more.

Last updated 3 days ago
Total downloads 12213
Total rating 7 
Categories Code Mods
Dependency string HL2H0-WideEye-4.0.0
Dependants 0 other packages depend on this package

This mod requires the following mods to function

gnonme-BoneLib-3.0.0 icon
gnonme-BoneLib

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

Preferred version: 3.0.0
WNP78-FieldInjector-2.1.1 icon
WNP78-FieldInjector

A utility for other mods to inject monobehaviour fields into the IL2CPP domain.

Preferred version: 2.1.1

README

WideEye

ko-fi

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


Controls

Handheld Camera

Button Action
Right Handle - Menu Button Pin camera in place
Right Handle - Trigger Zoom in
Left Handle - Menu Button Toggle preview screen
Left Handle - Trigger Zoom out
Ring - Trigger Toggle Bult-in Spotlight
Ring - Menu Button Toggle Spotlight Color
Preview Screen - Menu Button Flip Screen for Selfies

Free Camera

Key Action
W A S D Move around the scene
R Reset camera position
Q/E Move up/down
Shift(Hold) Move Faster
Left Mouse Button (Hold) Rotate/Move camera
LMB + Scroll Wheel Zoom in/out

📤 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

ko-fi

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


📜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.