You are viewing a potentially older version of this package. View all versions.
Landoria-SagaCapture-1.0.2 icon

SagaCapture

Records high-definition Valheim videos with automatic switching between your gameplay view and a second camera that follows your character.

Date uploaded a week ago
Version 1.0.2
Download link Landoria-SagaCapture-1.0.2.zip
Downloads 33
Dependency string Landoria-SagaCapture-1.0.2

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2351 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2351

README

SagaCapture

Records high-definition Valheim videos with automatic switching between your gameplay view and a second camera that follows your character.

Video demo

SagaCapture video demo

Requirements

  • Windows x64.

  • An NVIDIA GPU with NVENC support and a recent NVIDIA driver.

    To check your GPU, run nvidia-smi in Command Prompt and find its model in the NVIDIA Video Encode and Decode GPU Support Matrix. Check that H.264 (AVC) YUV 4:2:0 is marked YES.

  • FFmpeg, which is used to create the final MP4 file. It is not bundled and must be installed separately.

Set environment variable FFMPEG_PATH to the absolute path of the FFmpeg bin folder containing ffmpeg.exe before starting Valheim. For example, in PowerShell:

[Environment]::SetEnvironmentVariable("FFMPEG_PATH", "C:\tools\ffmpeg\bin", "User")

Record a video

Press F8 to start or stop video recording.

Videos are saved in the SagaCapture folder inside your Windows Videos folder. The folder is created automatically.

Settings

Open this BepInEx file for recording settings:

BepInEx/config/Landoria.SagaCapture.cfg
Section Setting Default Description
Controls CaptureModeShortcut F8 Starts or stops Capture Mode.
CinematicCameraRendering MaximumFrameRate SameAsGame Sets 30, 60, or SameAsGame. The latter preserves active VSync, or limits the game and video to 60 FPS when VSync is off.
CinematicCameraRendering ShowFrameRate false Shows the cinematic-camera FPS counter in the top-left corner.
Recording Quality Medium Sets the recording quality to Low, Medium, High, or Highest. Lower values reduce file size and encoding load.
GameplayCamera IncludeUI true Shows UI while Valheim displays its mouse cursor or a runestone text. Otherwise gameplay shots have no UI. When false, these interactions do not force gameplay cuts. The Escape menu always uses the cinematic camera.
WorldRendering GrassDistance 0 Sets grass draw distance in meters for gameplay and the cinematic camera. 0 keeps Valheim's original distance. Higher values can reduce performance.
Director MinimumShotDuration 8 Sets the minimum shot duration in seconds.
Director MaximumShotDuration 15 Sets the maximum shot duration in seconds.

Performance recommendation

SagaCapture uses the current game resolution. Keep the game fast enough to maintain the selected recording rate of 30 or 60 FPS. If needed, lower the game resolution from 4K (2160p) to 2K (1440p) or Full HD (1080p). Prefer a native resolution when performance allows it.

Contributions welcome

CineCapture is the underlying capture project used by SagaCapture. We welcome contributions to expand its support across more platforms, GPUs, and graphics APIs.

See the project on GitHub: cine-capture/CineCapture.

Operating system GPU Graphics API Status
Windows x64 NVIDIA with NVENC Direct3D 11 ✅ Supported
Windows x64 AMD Direct3D 11 🙌 Contributors needed
Windows x64 Intel Direct3D 11 🙌 Contributors needed
Windows x64 NVIDIA with NVENC Direct3D 12 🙌 Contributors needed
Linux NVIDIA, AMD, or Intel Vulkan 🙌 Contributors needed
macOS Apple silicon Metal 🙌 Contributors needed

Testers are also welcome. Share your feedback and results to help validate CineCapture on different hardware and environments.

Contact

Report bugs through GitHub Issues.

CHANGELOG

Changelog

1.0.2

  • Upgrade CineCapture to version 1.0.2 to fix audio drifting progressively out of sync with video.
  • When IncludeUI is true, show gameplay UI while the cursor or runestone text is visible.
  • Use the cinematic camera while the Escape menu is open.
  • Add configurable grass draw distance for gameplay and cinematic shots.
  • Log rejected audio blocks.

1.0.1

  • Save the current recording when logging out or exiting the game.

1.0.0

  • Initial version