Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
CaptainsLog
Logs ship speed, wind, and heading to CSV while you sail, plus a live HUD - empirical data for comparing ship speeds instead of guesswork.
| Last updated | a day ago |
| Total downloads | 58 |
| Total rating | 0 |
| Categories | Mods Client-side Utility AI Generated |
| Dependency string | DeathMonger-CaptainsLog-1.0.0 |
| Dependants | 0 other packages depend on this package |
This mod requires the following mods to function
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.2350
ValheimModding-Jotunn
Jötunn (/ˈjɔːtʊn/, 'giant'), the Valheim Library was created with the goal of making the lives of mod developers easier. It enables you to create mods for Valheim using an abstracted API so you can focus on the actual content creation.
Preferred version: 2.30.0README
Captain's Log
Logs ship telemetry — speed, wind, sail efficiency, rudder, heading — to CSV while you sail, plus a live HUD. Built to gather empirical data on ship speed instead of relying on guessed/community-reported stats.
Features
- Logs a CSV row every time the local player is aboard a moving ship (sample rate configurable, default 2/sec)
- Captures: timestamp, ship name, position, biome, forward speed (m/s and knots), throttle setting, propulsion mode (oars forward/reverse vs sail), rudder, heading, relative wind angle, sail wind-efficiency factor, wind intensity, absolute wind direction
- Small always-on HUD (visible only while aboard a ship) showing live speed, wind, and sail efficiency
- One CSV file per game session, written to
BepInEx/CaptainsLog/shiplog-<timestamp>.csv
Why these columns
Raw speed alone doesn't tell you much — a ship that's "fast" running downwind might be mediocre upwind. Logging wind angle and sail efficiency (GetWindAngleFactor, the game's own point-of-sail multiplier) alongside speed lets you separate "this ship is fast" from "this ship happened to have good wind" when comparing runs.
WindAngleDeg is signed and ranges -180° to +180°: 0° = tailwind (wind at your stern, pushing you forward), +/-180° = headwind (wind on the nose). WindAngleFactor (0-1) is the game's own sail-efficiency curve for that angle — it bottoms out at 0 at +/-180°, sits around 0.7 at 0° (dead downwind), and peaks near a broad reach (roughly +/-90-100°).
SpeedSetting (Stop/Back/Slow/Half/Full) is the ship's five-step throttle. Propulsion translates that into what's actually moving the ship: Idle, Oars-Reverse (Back), Oars-Forward (Slow), or Sail-Half/Sail-Full (Half/Full). Note that the game's own Ship.IsSailUp() isn't an independent sail-raised sensor — it's literally defined as SpeedSetting == Half || SpeedSetting == Full — so we don't log it separately; Propulsion/SpeedSetting already carry that information.
Configuration
The config file is created at BepInEx/config/DeathMonger.CaptainsLog.cfg on first run.
[Logging]
Enabled(default:true) — write samples to CSVSample Interval (s)(default:0.5) — minimum time between logged rows
[HUD]
Enabled(default:true) — show the live speed/wind widget while aboard a shipOffset X (px)/Offset Y (px)— widget position, top-left origin
Requirements
Compatibility
- Client-side only — does not need to be installed on the server
- Read-only — does not modify player state, world state, or any vanilla system
