沉浸式自动加油站

沉浸式自动燃料补给器

用三个装饰性燃料容器让你的炉火和灯火持续燃烧，完美融入你的英灵神殿建筑。在容器中储存燃料，它们会自动供给附近受支持的物品。

## 柴火架

一个装饰性的原木架，配有配套的壁炉工具架。

• 为营火、壁炉、篝火、铁火盆、石炉和热水浴缸供给燃料。
• 优先使用普通木材，其次是核心木材和优质木材。
• 不为窑炉、攻城锤、火把或火盆供给燃料。
• 建造消耗：30 木材、6 铁、3 青铜。

## 点灯人的木桶

一个装饰性的半桶，装满树脂，配有铲子和溢出的树脂。

• 树脂：立式木火把、立式铁火把、壁灯、杰克灯笼和雪灯笼。
• 黏菌：立式绿色火把。
• 灰矮人眼球：立式蓝色火把。
• 建造消耗：1 桶箍、12 木材、3 青铜、25 树脂。

## 火盆煤斗

一个装饰性的煤斗，配有铁提手和安装的铲子。

• 煤炭：立式火盆和悬挂式火盆。
• 灰矮人眼球：立式蓝色火盆。
• 不为熔炉、高炉或其他消耗煤炭的制作站供给燃料。
• 建造消耗：4 青铜、2 铁、25 煤炭。

## 特性

• 三个部件均需要锻造台才能建造。
• 每个容器有六个物品栏位，按 3 × 2 排列。
• 默认补给半径为 12 米，每个部件可单独配置。
• 放置时以白色地面圆圈显示配置的范围。
• 连接显示会列出供给的物品及其每现实小时当前的燃烧速率。
• 受支持的目标会在悬停文本中显示其供给者。
• 在受支持的目标上按 Shift + E 可切换其自动补给。
• 每个目标只接收其对应的燃料。蓝色光源使用灰矮人眼球而非树脂或煤炭。
• 无关物品可以存放在容器中，不会被消耗。
• 供应容器打开时，补给会暂停。
• 破坏容器会通过原版破坏行为返还其制作材料和剩余内容物，受原版世界设置影响。已消耗的燃料不会返还。

## 供给运作方式

补给检查大约每五秒运行一次，各容器之间的时间错开。目标必须处于已加载状态才能接收燃料。新加载的目标以及多人游戏中的所有权变更可能需要额外时间才能补充燃料。

当兼容的容器重叠时，最近的容器为目标供给。空的最近容器不会自动将供给切换到更远的容器。

显示的燃烧速率估算的是已连接且正在燃烧的目标消耗燃料的速度。它不是物品离开容器的实时测量值。补充现有短缺可能导致多个燃料物品同时被取出，即使每小时燃烧速率相对较低。

## 多人游戏保护措施

1.0.0 之后的更新增加了所有权稳定检查、壁炉补充前的已过燃烧处理、壁炉存入立即验证，以及对快速重复壁炉取出的保护。

这些保护措施针对潜在的多人游戏燃料丢失场景。请报告任何无法解释的燃料丢失、复制或同步问题，以便进行调查。

## 配置

每个部件都有各自的建造菜单开关和半径设置。通过 Configuration Manager 或以下文件进行配置：

BepInEx/config/camde.valheim.immersiveautofuelers.cfg

• 半径设置范围为 1 至 128 米。
• 多人游戏使用服务器的半径和建造菜单设置。
• 在建造菜单中隐藏某个部件不会禁用已放置的部件。
• 诊断日志在每个玩家的计算机或服务器上本地配置。

## 诊断日志与错误报告 — 版本 1.0.3+

三个容器的诊断日志默认启用。它会记录物品栏变更、物品移动、燃料转移、所有权变更、连接数量以及对已存入燃料的后续检查。

日志保存在你的英灵神殿安装文件夹内：

BepInEx/ImmersiveAutoFuelers-Logs

该文件夹包含单独的带时间戳文件，文件名以以下内容开头：

inventory-
fueling-

重启游戏会创建新的会话文件，而不会清除之前的诊断日志。诊断存储总量限制约为 50 MB。当需要空间时，较旧的已完成日志对会被自动删除。

你可以在 Configuration Manager 中禁用记录，位于：

诊断 → 启用诊断日志

或在模组的配置文件中设置以下选项：

[Diagnostics]
Enable diagnostic logs = false

## 如何报告问题

如果你注意到无法解释的燃料丢失、复制或其他问题：

1. 大致记录发生时间和你观察到的现象。
2. 如有可能，正常退出英灵神殿，以便保存缓冲的日志。
3. 复制并打包（ZIP）整个 BepInEx/ImmersiveAutoFuelers-Logs 文件夹。
4. 同时附上：
• BepInEx/LogOutput.log
• BepInEx/config/camde.valheim.immersiveautofuelers.cfg
5. 通过 Nexus 私信或错误报告中的下载链接将压缩包发送给我审阅。

对于多人游戏问题，请尽可能附上主机或专用服务器以及受影响玩家的日志。请清晰标注每个压缩包，以便我能跨机器对比同一会话。

请及时复制文件：正常的 BepInEx LogOutput.log 可能在游戏重启时被覆盖，较旧的诊断文件可能在达到存储限制时被删除。

日志包含玩家名称、标识符、世界标识符和游戏内位置。如果你不希望这些信息公开，请私下分享。

## 前置需求

• 适用于英灵神殿的 BepInEx 5。
• Configuration Manager — 可选，用于在游戏内编辑设置。

## 安装与更新

通过 Vortex 安装，或手动安装：

1. 安装 BepInEx 5。
2. 关闭英灵神殿。
3. 将此模组的 ZIP 解压到你的英灵神殿安装文件夹。
4. 确认 DLL 位于：

BepInEx/plugins/ImmersiveAutoFuelers/ImmersiveAutoFuelers.dll

只保留一份已安装的插件副本。使用 Vortex 时，替换之前的版本并部署更改。

对于多人游戏，请在主机或专用服务器以及每个客户端上安装相同版本。