Cinematic Camera System (MLCam) For Minecraft 1.20.3+

The Cinematic Camera System allows you to set camera tracks for smooth cutscene viewing for players.

Features:
- Create cinematic cutscenes that smoothly follow a specified path.
- Set a fixed or moving target that the camera will track while moving.
- Set a stationary camera that will follow the movement of the track's camera.
- Use curve control points to allow for curved motion between two points along the track.
- Set delays and callbacks for better control over what happens during a cutscene.

# Important: The gamerule spectatorsGenerateChunks must be set to true for this datapack to work correctly.

Here are the steps to install the data pack and the resource pack (contained in the zip file download):
- Step 1: Unzip the MLCam.zip file in your downloads folder.
- Step 2: Place the ml_cam and ml_ces folders into your Minecraft world's datapacks folder.
- Step 3: Place the resources.zip file into the main directory of your Minecraft world.
- Note: The resource pack is only needed while editing your camera tracks. When you are done with setting up your cutscenes, you can remove the resource pack from your world.

***

# Setup: Steps to take for creating a camera track

## Note: When creating a track point, it will be summoned at eye level.

- You must first run this function to be an editor for the Cinematic Camera System:
/function ml_cam:editor

- Once you have the editor items, you can add a point with the New Track Point item to create the path that the camera will follow. You can also right-click a track point to access its settings, or right-click and hold to start moving the point around in the world.

- A point can have a delay time that will hold the camera at that point for the specified amount of time. Right-click a track point to access the menu and set the delay time.

- A point can have a callback command that will be executed as the camera when it reaches that point. Right-click a track point to access the menu and set the command callback.

- A point can be converted into a curve control point by right-clicking it and toggling the Is Curve Control Point option. This will create a smooth curve between two points. The particles will help you to visualize the curve path.

- To delete a track point, left-click it and select Confirm, or right-click it and select Delete.

- To insert a point between two other points along the track, stand somewhere in between the two points and right-click the Insert Track Point item.

***

- To add a view target for the camera to face while it's moving, right-click the Camera View Target item. Or you can use an existing track as the view target so that the camera will face the moving camera target on the selected track. To do this, right-click the Camera Track Settings item, and select the Use View Target Track option, then select the track you want to use. You can also right-click the Camera View Target item on an entity and the option to set the view target on that entity will show up in your chat.

- To add a stationary camera that will only rotate to follow the track's main camera (or a moving view target), right-click the Stationary Camera item.

- To make a camera jump to another track once it has completed its current track, right-click the Camera Track Settings item, select the Track Jump Target option, then select the track you want for the jump. IMPORTANT: If you create a loop with track jumps, the player will not be able to leave the cutscene unless you cancel the player, abort the cutscene, or the player leaves spectator mode.

- For other track settings, or to change the current track being edited, right-click the Camera Track Settings item.

- Once you have your track setup, you can disable the particles and visuals by right-clicking the Camera Track Settings item, and toggling those options for each track.

***

# Preview: Allows an editor to preview the camera movement/tracking along the track

- To preview a track, right-click the starting point of a track (the red point), and select one of the preview options.
- To preview the stationary camera for a track, right-click the stationary camera object, and select the preview option.

# Cutscene: Allows a player to view the track cutscene

- To get a command that will run or abort a cutscene for a specific track, right-click the Camera Track Settings item, then select one of the cutscene command options for the desired track.

- To cancel a cutscene for a specific player, run this command as the player:
/execute as @p run function ml_cam:cutscene/cancel

***

# Important Notes:

- For more efficiency while using the datapack, be sure to turn off particles and visuals for a track when you're not editing it. See the above notes for info on how to turn off these options.
- The gamerule spectatorsGenerateChunks must be set to true in order for this datapack to work correctly.
- This datapack uses the MLCES datapack, which is included in the download.
- To unload the datapack, run this function (Warning: Unloading the datapack will remove all camera tracks from the world):
/function ml_cam:system/unload