航行时记录船速、风向和航向到CSV文件，并显示实时HUD——用实测数据比较船速，不再靠猜测。

舰长日志

航行时将船只遥测数据——速度、风力、风帆效率、舵角、航向——记录为CSV文件，并显示实时HUD。专为采集船只速度的实测数据而设计，不再依赖猜测或社区报告的数值。

---

功能

• 每当本地玩家乘坐移动中的船只时记录一行CSV数据（采样率可配置，默认每秒2次）
• 捕获内容：时间戳、玩家、船名、位置、生物群系、前进速度（米/秒和节）、油门设置、推进模式（划桨前进/后退与帆船）、舵、航向、相对风向角、帆风效系数、风力强度、绝对风向
• 小型HUD，仅在船上时可见：速度以节（或米/秒）显示，风向及风力强度，帆升起时的帆效率，以及舵转向时的状态
• HUD位于你的快捷栏下方，包括AzuExtendedPlayerInventory添加的第二行，或者像Azumatt的Ship Stats那样位于船的舵图标旁边
• 每个游戏会话一个CSV文件，写入至 BepInEx/CaptainsLog/shiplog-<timestamp>.csv
• A 玩家 每一行上的列，这样不同人的日志就可以合并了
• 可选服务器安装：专用服务器日志 每 玩家扬帆起航，合而为一

---

服务器日志

在专用服务器上安装该模组后，它会写入 BepInEx/CaptainsLog/飞船日志-<timestamp>.csv 只要服务器运行，它就会按每艘船配置的采样间隔，记录每一艘有舵手或帆、桨已启用的船。

• 玩家 是舵手。如果没人掌舵（帆还升着），那就是运行船只游戏的玩家。
• 速度是精确的，不是估算的。航行玩家的游戏会运行船只的物理模拟，并将其速度发送到服务器，服务器会记录该速度。
• 玩家无需安装模组即可记录航行。服务器日志没有HUD，并且 [抬头显示] 那里的设置会被忽略。
• 一艘繁忙的服务器大约每秒写入两行正被驾驶的船只数据，每艘船每小时约0.7 MB。

---

为什么是这些柱子

单看原始速度说明不了什么——一艘顺风“快”的船，逆风时可能很平庸。记录 风向角 和 航行效率 (获取风向角度系数，游戏自带的帆向倍率）结合速度，能让你在比较不同跑法时，把“这艘船本身快”和“这艘船恰好赶上了好风”区分开来。

方向舵 是舵所在的位置，从-1（左满舵）到1（右满舵），这才是真正操控船只的地方。

英灵神殿的风没有速度，只有一个从0到1的强度（风力强度），它把帆力从25%调整到100%。帆力并不取决于船当前的速度，因此船可以轻易超过你据此推算出的任何“风速”，HUD之所以用百分比显示风，就是这个原因。（Azumatt的Ship Stats将其按满强度10米/秒换算为节，这只是一个约定俗成的做法。）

在HUD上， 从…… 是风相对于船体的来向，而非罗盘方向： 后方，一个 四分之一 （在正后方67.5°范围内）， 光束，那个 弓，或 前方，在 端口 或 右舷 侧面。那 高效 帆船航线上的角色是 风角度系数 （如下），这仅取决于该角度。

风向角度 是有符号的，范围从 -180° 到 +180°： 0° = 顺风 （顺风推送你前行）， +/-180° = 逆风 (迎风)。 风向角度系数 对于该角度，(0-1) 是游戏自带的航行效率曲线（船.获取风向系数）：顺风时系数为0.7，风正好从正横（±90°）吹来时升至1.0，在±139°时回落到约0.78，然后在±143°时降为0。在正前方约37°范围内，帆完全不提供推力。

速度设置 (停止/返回/慢/半/满) 是飞船的五级油门。 推进器 将其翻译成真正推动飞船运行的东西： 待机, 桨-反向 (返回）， 前进划桨 (慢速），或 半帆/满帆 (半/满）。请注意，游戏本身的 船帆已升起 不是独立的扬帆传感器——它的定义就是 速度设置 == 一半 || 速度设置 == 全速 ——所以我们不单独记录它； 推进/速度设置 已经携带了那条信息。

---

配置

配置文件已创建于 BepInEx/配置/DeathMonger.CaptainsLog.cfg 首次运行时。

[日志记录]

• 启用 （默认： 真) — 将样本写入CSV
• 采样间隔（秒） （默认： 0.5）— 记录行之间的最短时间（每艘船，在服务器上）

[平视显示器]

• 启用 （默认： 真) — 在船上时显示实时速度/风向小组件
• 位置 （默认： 快捷栏下方) — 下方快捷栏 位于最低快捷栏行下方，包括来自AzuExtendedPlayerInventory等模组的第二行； 居中 位于船舵图标旁边并跟随船只； 左上 是角落里的一个固定位置
• 微调 X (像素) / 微调 Y（像素） （默认： 0) — 将该部件从该位置移开（正值 = 向右 / 向下）
• 背景不透明度 （默认： 0.5) — 文字后面的深色面板； 0 隐藏它
• 速度单位 （默认： 节) — 节, 米每秒或 节与米每秒 （括号内为米/秒）；仅限舰船速度
• 显示风向角度 默认： 真）— 添加风相对于船只的来源方向，例如 风：右后方来风，39%
• 显示飞船名称 （默认： 真）——第一行标明你所乘坐的船只类型（英灵神殿中的船只没有单独的名字）

---

需求

• BepInEx 5
• 约顿

---

兼容性

• 默认客户端安装。服务端安装为可选，仅用于添加服务器日志；客户端加入时无需安装。
• 只读——不会修改玩家状态、世界状态或任何原版系统