MonoDirector is BONELAB's very own movie/photo suite. Make an action movie, mockumentary, or a group photo all by yourself. You are the director, actor and cameraman. Make whatever you want.

This mod is open-sourced for open beta, and I want to get this mod to where it should be. Ideally, it should just be a strong enough tool to where anyone can make films by themselves without the aid of another person. It will take a lot of time and effort to make this happen, and you can certainly contribute!

I hope this mod over time reaches my grand vision. Be patient with us, and we'll try out best to get it right.

To install MonoDirector, ensure that you the above dependencies installed:

• MelonLoader
• BoneLib
• AudioImportLib

1. Open the zip file
2. Go inside the "Code Mod" folder
3. Drag all contents of the folder into your game directory

For installing the SDK mod:

1. Subscribe to the mod on mod.io
2. Go into Void G-114 (or the Mod Levels area in BONELAB Hub)
3. Go to Mods, then Downloads
4. Hit the "Download All" button
5. You're done!

If you ever want to act out a scene, but you don't have any friends, MonoDirector has you covered. Simply record from hitting the button on the menu, and all of your movements are recorded.

A strength of the tool is being able to be there with your clones. It certainly helps with whatever scenes you have planned out. On top of this, if you want to voice act, you can enable it in the settings. Now when you record, it will also record your voice. The voice gets played back in real time, when you both record and play back. The possibilities are endless.

MonoDirector provides a (decent) set of tools for any situation that suits your needs.

For example, if you want to have your actors interact with props, you can use the Propifier to set them up. Then when recording begins, your actor will be able to pick up the prop, and then in playback, it'll copy the recorded movements.

The propifier doesn't only work on props, though. It works on any of these (to an extent):

• Guns
• Vehicles
• Breakable Objects

Another tool of interest is the Gimbal Camera. This camera is a handheld camera, that can be enabled in the settings under the Camera category.

The Gimbal Camera allows for steady handheld shots. Shots where the camera needs to be close to action, or a subject (or subjects) of interest. Note though, this item will come at a performance cost.

When enabled, the viewfinder screens on the camera will show up, and now wherever you point the camera, you can see where its facing. The right trigger increases the FOV of the camera, and then the left trigger decreases the FOV.

When all is said and done, and you have all the actors in their right places, now it is time to finally direct everything. Playback everything, get your camera ready, and record. It's that simple when you're doing it solo.

• zCubed for helping out with the project (helped get interpolation in!)
• wnp and Someone Somewhere for helping with audio syncing
• Son of Forehead for the clapperboard, green screens, and the prop lights
• CarrionAndOn for the addition of a handheld camera, and most of the feedback
• Rexmeck for helping with grip event recording
• Stress Level Zero for BONELAB and the Marrow SDK

Want to support me and my future projects? You can donate at my Ko-fi!

Changelog

This is the changelog for MonoDirector! This changelog only features public release versions.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning

[1.2.10] - 4/13/2026

Fixed

• Fixed issues with WideEye interfering with MonoDirector. This means that if you prefer using WideEye's features, you can use them seamlessly with MonoDirector.
• Fixed potential problems that may come up when using FlatPlayer and the FreeCam controls
• Fixed an issue with null props being removed
• Fixed an issue with prop markers not going to the top of props
• Fixed an issue with actor recasting not cleaning up props correctly

[1.2.9] - 3/20/2026

Updated

• Made prop markers smoothly follow props, and they are managed differently

Fixed

• Fixed an issue with the OnGrip patch not working properly on custom guns
• Fixed an issue on deleted props not being cleaned up properly, causing an error

[1.2.8] - 3/9/2026

Fixed

• Fixed magazines floating around during playback
• Fixed prop markers showing up during recordings if props were added

[1.2.7] - 3/7/2026

Added

• Re-added other cameras (including the freecam)!

Updated

• Camera settings will only appear on PCVR, not Quest
• Camera mode selection is done through one page instead of an enum element
• Actors will automatically have their collision disabled outside of playback, then re-enabled during playback
• Default camera mode is "None" instead of "Head"

Fixed

• Fixed an issue with not being able to retrieve the camera holder object
• Fixed an issue with Actors not being accurate to where the player last was after recording finished

[1.2.6] - 3/7/2026

Fixed

• Fixed a problem with the mod incorrectly reporting a pallet needed updating even though the most recent version was installed

[1.2.5] - 3/7/2026

Added

• Added laser pointers to both the Actor Pen and Propifier
• Added new notifications that will tell you if you don't have dependencies installed
• Added a notification to let you know when there are new pallet updates

Updated

• Moved UI sounds into their own bundles so that it doesn't break the mod if someone didn't have AudioImportLib installed
• Actor management panel now faces the player
• Custom SFX is now loaded from "MonoDirector/SFX" instead of "MonoDirector/SFX/Sounds" for simplicity

Fixed

• Fixed issues with the mod coming to a screeching halt if AudioImportLib wasn't installed

[1.2.4] - 3/4/2026

Removed

• Removed the option to bring up the caster menu from BoneMenu due to it not being implemented properly

[1.2.3] - 3/3/2026 (Hotfix)

Added

• Added back the Quest MonoDirector embedded bundle in the DLL

Fixed

• Changed file compression algorithm to something other than LZMA4 because it couldn't be opened with anything

[1.2.2] - 3/3/2026 (Hotfix)

Fixed

• Fixed a backwards compatibility problem with the Quest version because of an incompatible console logger
• Reverted back to using MelonLoader 0.7.0 for compatibility

[1.2.1] - 3/3/2026

Removed

• Removed external pallet downloading code

[1.2.0] - 3/3/2026

Added

• Added spot lights
• Added omni lights
• Added sound source tethering to actors
• Added light intensity, radius, angle, and color gizmos for light tools
• Added a volume gizmo for sound sources
• Added visual effect (VFX) charges and volumes, activated by a gizmo on the top
• Added an "actor pen" tool that allows for easy actor management
• Added a frame object around selected actors
• Added back the prop icons
• Added a feature to check to see if you have the MonoDirector content pallet installed, and notifies you if you don't have it

Updated

• Sound sources, among other tools, have been given a makeover with new sprites and visuals
• Updated the sprite for props
• Brought MonoDirector to Patch 6
• Vehicle functionality (vehicles are still kinematic, but most things are tracked now)

Fixed

• Fixed a bug that, when firing a weapon, would freeze the actor, breaking the mod
• Fixed an issue with the info interface being backwards
• Fixed a problem with prop markers not showing up
• Fixed an issue with removed actors not having their props cleaned up

Removed

• Removed most camera options to make them better in the future

[1.1.1] - 4/26/2024

Added

• Added back the working handheld camera
• A lens to the handheld camera

Updated

• Cleaned up the hierarchy of the handheld camera
• VFX changes in BoneMenu now get reflected across both cameras
• Kinematic on release for the handheld camera now triggers on both grips

[1.1.0] - 4/24/2024

Added

• Added sound sources (2D and 3D)
• Added sound holders and the ability to put music in UserData/Not Enough Photons/MonoDirector/SFX/Sounds
• Added a "Caster Menu" for managing actors you recently created
• Added the ability to recast an actor, or redo the take of an actor

Updated

• Weapon tracking, including casing scale, slide animations, and more (Rexmeck)
• Actor jaw movement

Fixed

• Fixed an issue with horrible random crashes

Removed

• Removed blinding effects that would play when actors got casted
• Removed debug text that would sometimes appear in the console
• Pausing was removed, as it currently does nothing

[1.0.0] - 4/10/2024

Initial release!