Installation

1. Install MelonLoader
2. Drop Mods and UserData folders into Rumble Source Directory
3. Activate the LIV camera
4. Enable the mod in the ModUI
5. Make absolute cinema

Description

This mod provides an extensive toolset for manipulating the LIV camera, especially for capturing scripted cinematic shots.

This is a beta version. Not all implemented features are fully functional, the UI is not very polished or intuitive, and there are many features to come.

Features

• Draw splines in the air and animate the camera along them
• Manipulate various aspects of the camera, such as FOV, rotation, and speed
• "Staticize" the camera for tripod shots
• Save and load splines to files

Usage

Getting Started (Spline Tab)

Start by enabling the mod through the ModUI. This will show an in-game UI above your left hand. Point and click with your right hand to create a spline, then press trigger in the open air to place a vertex. Click and drag to create a curved vertex, and grip to move vertices. If you're at all familiar with vector programs such as Adobe Illustrator, this should be an intuitive process.

You can create multiple splines, and only the selected one will be editable. There are various tools for different functions, all accessed through buttons in their respective tabs. Number values, whether they be on UI options or markers, can be modified by holding trigger and moving your hand up and down. Combinations of the primary and secondary buttons will speed up or slow down the movement.

Edit Tab

Spline Order

The spline's placement in the list will determine when it animates after using the "Play All" feature. This placement can be changed with the "Order Left" and "Order Right" buttons.

Move Tool

Grip anywhere and move your hand to slide the entire spline through space. Primary and secondary buttons control the speed.

Pen Tool

Trigger to place a vertex (Corner Point). Hold trigger to create a curved vertex (Symmetric Point). Trigger on an existing vertex to delete it.

Anchor Tool

Hold trigger on a Corner Point to make it a Symmetric Point (for smoothing out splines). Trigger on a point's handle to delete them and revert it to a Corner Point. Grip on a point's handle to detach it, making a Free Point.

Animate Tab

The Animation tab has options to control the animation. You can pause and play from here, as well as add markers, which act as keyframes for controlling things like FOV and speed. With a marker tool selected, trigger on the selected spline's path to create a marker there. Grip to move the marker, and hold trigger to change its value. You can only edit markers that match the tool you have selected, except for the "Select Marker" tool, which can modify any type.

Pause Markers

Pause markers dictate how long the camera will freeze at the marker's location. Setting its value below zero will cause the camera to pause there until you press the primary button on your offhand. It can be useful to place an indefinite pause marker at the beginning of your first spline if you plan on being in the shot, so that you can start the animation with a button press as opposed to fiddling with a menu.

Speed Markers

Speed markers control the speed of the camera. They work like retiming keyframes in video editing programs such as After Effects. The value of the marker becomes the percentage of the way through the animation that the camera will hit that location. For example, if you place an 80% speed marker halfway across the curve, the first 80% of the animation will consist of the camera reaching the halfway point, then the remaining 20% will be the rest, causing the camera to start slow then speed up.

Rotation Targets

By default, the camera will face forwards (along the tangent of the curve) as it animates. To change this, you can set another spline to be a Rotation Target, meaning the camera will point to the corresponding location on the target spline instead. Splines that are Rotation Targets are usually disabled so the camera doesn't animate along them when playing all.

Static Tab

If you don't want to go through the hassle of setting up multiple splines for a simple, static shot, enable the "Staticize" checkbox to force the camera to a single location. The Grab tool teleports the static camera to your hand, and the Move tool allows you to transform the static camera at a distance.

File Tab

Here you can save and load individual splines, or entire sets of splines, to files. These are stored in the mod's folder under UserData, and can be accessed in-game with the file browser in the tab. Click on a file in the list (or go to the next page if it's not there), and load it in.

Load

Delete all existing splines and replace them with the selected file.

Append

Load the selected file as new splines on top of your already existing ones.

Overwrite

Replace existing splines with splines in the selected file, leaving any other splines alone.

Load in XXX

These act as checkboxes to determine whether the selected spline will automatically load when the respective scene loads.

Settings

"Swap Hands" will swap the functionality of your left and right hands.
"Hide Healths + Name Tags" will hide health bars, name plates, voice chat icons, and match tallies, allowing for cleaner recordings. (Note: These elements are only hidden for the LIV camera and will still show up in-game.)
"Camera Hears Audio" will modify the game's stereo audio to be from the perspective of the camera. This makes the recording feel more cohesive, but can be jarring, as the relocated audio is also heard in-game.

Planned Features

• Share curves with other players in parks
• Track curves to structures and players
• Set keystrokes to run when playing/pausing camera (for recording software)
• Load preset curve shapes (like circles) and modify with position/rotation/scale features
• Snapping vertices and values for easier alignment
• Pinning and deleting files in the File tab
• Curve previews in the UI (where the giant white squares are now)
• Non-destructive curve smoothing
• A whole lotta polish (custom icons for buttons, sleeker UI)

Possible Future Additions

• Interface with OBS directly
• Depth of field control (and maybe other post-processing effects)
• Networked curve editing and camera animation

Known Issues:

• Static camera changes are not affected by undo/redo
• The static camera is difficult to place precisely
• Closing the UI through the X button at the top doesn't persist on restart
• Compatibility issues with the green screen mod (???)
• Placing markers on large splines can be finicky and laggy
• Pause Markers and Speed Markers calculate out of order when travelling back in time

Help And Other Resources

Get help and find other resources in the Modding Discord: https://discord.gg/fsbcnZgzfa