根据当前FPS限制自动调整Valheim的LOD偏差，并带有传送门恢复功能和FPS、目标、LOD及时钟叠加显示。

自动LOD偏移

当前版本： 1.1.0

自动LOD偏差调整Unity的 QualitySettings.lodBias 根据测量到的帧率。性能下降时它会迅速做出反应，而性能保持稳定时则会更加谨慎地提高视觉距离。

这是一个客户端模组。它只改变安装该模组的玩家所看到的视觉细节和叠加层；服务器和其他玩家不需要安装此模组。

该模组适用于标准英灵神殿传送门，不依赖PortalPreload或QuickTeleport。这些模组仅作为兼容性案例。

功能

• 自动根据当前帧率平衡视距。
• 使用快速降低和谨慎提升，以避免反复出现大幅帧率下降。
• 在性能严重下降时包括紧急LOD缩减。
• 检测《英灵神殿》游戏内的帧率限制器，若不可用则回退至显示器刷新率，或接受一个固定的目标帧率。
• 在传送门旅行期间降低细节层次，抵达后恢复自动控制。
• 提供可配置的帧率、目标、细节层次和时钟叠加显示。
• 为覆盖层和自动控制提供可配置热键。

LOD阶段

自动控制仅使用以下阶段：

1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 50, 75, 100

当其他模组或手动更改提供了中间值时，降低数值会选择下一个更低的有效阶段，而提高数值则会选择下一个更高的有效阶段。

FPS操控

降档使用快速指数FPS平均值。默认情况下，该平均值必须在0.25秒内持续低于当前生效的下限阈值。之后控制器会下降一档，并应用0.25秒的降档冷却。

提升操作采用较慢的FPS平均值。该平均值必须持续高于当前上限阈值达1秒。在LOD 10以下时，每次提升增加两级，但最高不超过10。在LOD 10或以上时，每次提升前进一个表格阶段。上升冷却时间为1秒，之后必须再次满足高FPS条件。

降低效果始终优先。冷却期间FPS测量继续进行。

性能下降

每个FPS目标提供严重和临界阈值：

• 低于严重阈值持续0.25秒后，若当前值更高，LOD将直接切换至3。
• 低于临界阈值0.25秒时，LOD直接切换为1。
• 任一事件发生后，增长将被封锁1秒。仍可进行进一步削减。

目标帧率和显示检测

目标帧率 = 0 启用自动目标检测。AutoLodBias首先读取瓦尔海姆游戏内当前激活的FPS限制器。如果该限制器不可用或设置为无限制，则读取 Screen.currentResolution.refreshRateRatio，将其四舍五入到最接近的整数帧率，并将该值用作目标。无效或不可用的显示数据将回退到60帧率。在图形菜单中更改瓦尔海姆的帧率限制器会刷新自动目标。

阳性 目标帧率 始终选择手动模式，并将该精确值用作FPS目标。当Valheim或图形驱动程序有FPS限制器时使用此项。例如，设置 目标帧率 = 110 为110帧率上限。

所有目标使用相同的阈值计算：下限、上限、严重和临界分别为目标值的85%、97%、67%和50%。必要时会对数值进行修正，以保持：

暴击 < 严重 < 下限 < 上限

计算出的运行时阈值不会覆盖配置文件。

传送门行为

传送世界.传送(玩家) 为本地玩家提供提前启动信号。AutoLodBias会立即将LOD设为1并暂停FPS控制。

到达检测主要基于水平位置的跳变。到达后，LOD保持在1级持续0.75秒，随后恢复为3级，同时所有FPS平均值和计时器重新开始计算。传送门超时和恢复超时可防止LOD无限期停留在1级。

AutoLodBias不会传送玩家、跳过加载检查、调用PortalPreload或QuickTeleport API，也不会声明对这些模组的依赖。

英灵神殿显示距离

瓦尔海姆的 显示距离 图形设置控制着与AutoLodBias相同的Unity LOD偏移值。当自动控制启用时，AutoLodBias会故意用基于FPS的LOD阶段覆盖该菜单值。如果你想让游戏自行控制显示距离，请在禁用AutoLodBias后手动使用Valheim设置。

覆盖层与快捷键

覆盖层保持在一行，并在测得的FPS旁边显示当前活动目标：

94 FPS | 目标：90 FPS | LOD：15 | 14:35

设置 显示目标帧率 = false 隐藏 目标：90 FPS 部分。

默认显示本地真实时间。可在单独的 时钟 类别：

[时钟] ShowClock = true Use24HourClock = true

设置 使用24小时制 = false 对于12小时制，或者 显示时钟 = false 把它藏起来。

• Alt+F1：切换叠加层
• Alt+F2：切换自动控制

左右 Alt 键均受支持。禁用自动控制将取消传送门状态、重置控制器，并恢复默认 LOD 3。

配置示例

自动瓦尔海姆限制器与显示器检测：

[帧率] 目标帧率 = 0

手动 60 帧目标：

[FPS] TargetFPS = 60

手动 90 FPS 目标：

[FPS] 目标帧率 = 90

手动设置110 FPS目标以匹配FPS限制器：

[FPS] 目标帧率 = 110

主要设置：

[通用] 启用 = true 默认细节层次偏移 = 3 [帧率] 目标帧率 = 0 快速平滑秒数 = 0.15 慢速平滑秒数 = 1.0 低时长 = 0.25 高时长 = 1.0 严重时长 = 0.25 危急时长 = 0.25 下调冷却 = 0.25 上调冷却 = 1.0 紧急后提升锁定 = 1.0 [传送门] 传送门细节层次偏移 = 1 传送门恢复细节层次偏移 = 3 到达后低时长 = 0.75 位置跳变阈值 = 50 传送门超时 = 8 恢复超时 = 3 [叠加显示] 显示叠加层 = true 显示目标帧率 = true 横向位置 = 15 纵向位置 = 15 字体大小 = 16 刷新间隔 = 0.25 [时钟] 显示时钟 = true 使用24小时制 = true [快捷键] 切换叠加层按键 = F1 切换模组按键 = F2 需要Alt键 = true

安装

模组管理器

使用 r2modman 或 Thunderstore Mod Manager 安装 AutoLodBias。BepInEx 会作为依赖项自动安装。

手动

1. 为英灵神殿安装BepInExPack。
2. 复制 AutoLodBias.dll 至 BepInEx/plugins/AutoLodBias/.
3. 启动一次英灵神殿。配置文件创建于 BepInEx/配置/domen.valheim.autolodbias.cfg.

兼容性

• 仅客户端；无需安装专用服务器。
• 已在 Valheim 1.0.7、Unity 6000.0.75 和 BepInEx 5.4.23.5 环境下测试。
• 仅使用Harmony补丁来检测本地标准传送门旅行。
• 不需要PortalPreload、QuickTeleport、Jotunn或ServerSync。
• 没有当前隔离组合测试，就不能声称PortalPreload兼容性。

AI辅助创作

本模组及其文档和Thunderstore包部分或全部由OpenAI Codex协助创建。

许可证

根据以下许可协议授权 PolyForm 非商业许可 1.0.0.

允许非商业用途的使用、修改和再分发。再分发或修改后的版本必须包含许可证，并保留此署名声明： AutoLodBias 由 LEGIOmods 提供，版权所有 2026。 商业用途需另行获得LEGIOmods的许可。