CinematicPath Mod for Valheim 🌟

CinematicPath is an innovative mod for Valheim that turns your game into a powerful tool for creating cinematic videos. Imagine: you fly freely through the Viking world, place checkpoints, customize smooth paths with Bezier curves, edit speeds and angles, and then playback everything for the perfect shot. Ideal for content creators, streamers, and fans looking to capture epic moments! 🚀

This mod uses quadratic Bezier curves for ultra-smooth camera movement, supports saving and loading paths in JSON, and offers an intuitive editing menu. No more tedious editing — create professional videos right in the game!

Key Features ✨

• Free Cam Mode: Fly without restrictions, adjusting speed and mouse sensitivity. Perfect for scouting and camera positioning.
• Checkpoints and Segments: Add checkpoints with a mouse click, edit positions (X/Y/Z), rotations (Yaw/Pitch), segment durations, curve amounts, tilt angles, and rotation reversal.
• Smooth Paths: Uses quadratic Bezier curves for natural camera motion between checkpoints. Automatic speed calculations for movement and rotation based on distance.
• Path Playback: Start playback from any checkpoint, with full synchronization of player/camera position and rotation. Stop anytime.
• Visualization: Displays checkpoint markers (red spheres), path lines (white), labels, and segments in real-time for easy editing.
• Editing Menu: Full GUI menu for all elements — edit everything in one window, add/delete checkpoints, preview changes without saving.
• Save and Load: Store paths in JSON files, create new saves, overwrite, or delete. Auto-save on exit.
• Configuration: Customizable keys (default F9-F11) and parameters (flight speed, default movement speed).
• Compatibility: Integrates seamlessly with Valheim via Harmony patches, with no conflicts with most mods.

The mod is built in C# using BepInEx and Jotunn, ensuring stability and performance.

Tip: In Path Playback mode, use the keyboard shortcut CTRL+F3 to hide the game interface for a nice, clean recording.

Installation 🛠️

1. Install Dependencies:

   • BepInExPack Valheim (version 5.4.2333 or higher).
   • Jotunn (version 2.27.1 or higher).
   • HookGenPatcher (version 0.0.4 or higher).
   • Json.NET (version 13.0.4 or higher).

2. Download the Mod:

   • Grab the latest version from Thunderstore.

3. Install:

   • Extract the files to your Valheim's BepInEx/plugins/ folder.
   • Launch the game — the mod initializes automatically.

Tip: Use a mod manager like r2modman or Thunderstore Mod Manager for automatic installation.

Usage 📖

Default Keybinds (Configurable in config.cfg)

• F10: Toggle Free Cam mode.
• F11: Play/stop path playback.
• F9: Clear all checkpoints.

In Free Cam Mode

• Left Mouse Button (LMB): Add a checkpoint (camera position and rotation).
• Right Mouse Button (RMB): Open the editing menu.
• WASD + Space/Ctrl: Move the camera.
• Shift: Boost flight speed.
• Mouse Wheel: Adjust flight speed.

Editing Menu

• Opens with RMB in Free Cam.
• Checkpoints: Edit position (X/Y/Z), rotation (Yaw/Pitch). Buttons: "Edit by Free Cam" (edit in flight), "DELETE CP".
• Connections (Segments): Adjust duration (s), curve amount, tilt angle (0-360), reverse rotation. Buttons: "ADD CP" (insert midpoint checkpoint), "Reset this" (reset to defaults: move speed 10, curve 0, tilt 0, reverse off).
• Actions:
  • "Run from CP": Start playback from the specified checkpoint.
  • "Preview": View changes (updates visuals without saving).
  • "Apply": Apply and save changes.
  • "Cancel": Discard changes.
• Saves: Create, load, overwrite, or delete paths.

Path Creation Tips

1. Enter Free Cam (F10).
2. Add checkpoints with LMB (at least 2 for a path).
3. Open the menu (RMB) for fine-tuning.
4. Use "Preview" to test visuals.
5. Save the path and playback (F11).

Paths are stored in BepInEx/config/mrGMD.cinematicpath.paths.json.

Configuration ⚙️

Edit BepInEx/config/mrGMD.cinematicpath.cfg:

• Controls: Change keys (ToggleFreeCam, Play, Clear).
• Movement: FlySpeed (default 10), MouseSens (default 2).
• Playback: DefaultMoveSpeed (default 10) — base speed between checkpoints.

The mod supports float inputs with dots or commas (automatic replacement).

Known Issues and Tips ❗

• Performance: Long paths with many segments may strain low-end PCs — use fewer checkpoints. During playback (F11), your character moves stealthily with the camera. This is done to ensure all map objects and lighting are properly loaded. At this point, your character is invisible and invulnerable. Keep in mind that this also puts a strain on your system.
• Compatibility: Works with most mods, but test with major overhauls.
• Bugs: If visuals don't update, restart Free Cam. Report issues in the issues section!
• Version: Current 0.2.0 — includes GUI and save fixes.