控制灯光与燃料的特别病房

🔥 守光者 - 模组文档

🔥 概述

守塔人 为瓦尔海姆添加了一个新的可建造控制器部件，让你能以智能联网的方式管理火焰和光源。

该模组专为拥有大量火把、火盆、壁炉、营火、壁灯以及其他使用瓦尔海姆的 壁炉 组件。

有了灯塔看守人，你可以：

• 🔥 在一个地方开启或关闭所有连接的火焰源
• ⛽ 自动为范围内的火堆分配燃料
• 📦 在守光者体内储存燃料
• 🔗 将多个光之守护者连接到一个共享网络
• 📏 在游戏内调整控制器范围
• 🚫 将单独火源排除在守光者控制之外
• 🌐 在多人游戏中保持系统同步

🧩 守灯人可与《英灵神殿》原版火源配合使用 壁炉 组件。

---

🏗️ 此模组新增内容

🔥 灯塔守护者

一种新的建造部件，可作为火焰与光源控制中心。

守光者可以：

• 检测其半径内的火源
• 切换附近灯光 开/关
• 关闭灯光时防止燃油消耗
• 将燃料储存在其内部储存空间
• 自动补充兼容的火焰
• 与其他光之守护者连接成更大的网络

---

🧾 配方

守灯人是用锤子建造的。

资源	数量
石头	20
红宝石	4
锡	5
树脂	15

需要：

• 🔨 锤子
• 🧰 附近有切石机

---

🎮 操作

动作	输入
打开燃料库	E
切换连接灯光的开/关	Alt + E
切换自动补给燃料 开/关	Ctrl + E
增加范围	+ 或 小键盘 +
减少范围	- 或 小键盘 -
对单个火光选择忽视或服从守光者	Ctrl + E 悬停火焰时

⚠️ 在英灵神殿中 替代 参数输入 交互() 不是键盘上的 Alt 键。Lightkeeper 会直接检测真实的键盘 Alt 键。

---

🔗 网络系统

守光者之间可以相互连接，作为一个网络运作。

两位光之守护者相连时 其中一个的半径触及到另一个.

示例：

守灯人A范围：10米 守灯人B范围：15米 两者间距：12米 A无法覆盖B。B可以覆盖A。结果：已连接。

这意味着较大范围的光守即使较小范围的光守无法回连，也能与其连接。

---

📏 动态范围

每位守光者的半径均可调整。

悬停于光之守护者时：

• 按下 + 增加射程
• 按下 - 缩短射程

切换射程可以：

• 连接新的守光者
• 断开旧守光者
• 合并网络
• 分离网络

范围变化后会重新计算网络。

---

🔥 灯光控制

当灯塔守护者网络开启时：

• 受控火焰可正常燃烧
• 燃油消耗正常运作
• 自动燃料可在启用时为火堆补充燃料

当守光者网络关闭时：

• 受控燃烧已被强制关闭
• 受控火堆停止消耗燃料
• 自动加油未运行

切换一个光守会影响其当前网络中所有相连的光守。

---

⛽ 自动燃料系统

守光人可以使用连接到守光人容器的燃料自动补充火源。

自动补充燃料已全网络启用：

• 如果你在一个已连接的守光者上关闭自动燃料，整个连接网络都会关闭自动燃料。
• 如果开启，整个连接的网络都会开启。

自动加油仅在以下情况运行：

• 守光者网络已开启
• 自动加油已开启
• 网络内有有效的火源
• 火源未被忽略
• 连接的存储中有匹配的燃料
• 当前没有玩家打开仓库

---

📦 燃料储存

每个光明守护者都有一个小型内置存储空间。

存储容量：

宽度	身高	槽位
3	4	12

这不是用来替代完整箱子的。它是控制器网络的紧凑型燃料缓冲。

如果连接了多个光守，它们可用的存储会被视为共享燃料池。

---

🧠 智能燃料分配

自动燃料系统以高效为设计目标。

它不会试图在每一帧都为所有火焰添加燃料。

而是：

• 按时间间隔运行
• 消耗一个网络领袖
• 批量检查火灾
• 轮流扫描
• 跳过无效或已销毁的对象
• 跳过当前由玩家打开的容器
• 补充缺失的燃料，而不是一次只添加一个物品

这有助于避免大型基地中出现帧率飙升。

---

👑 网络领袖

一个连通网络中只有一个光守执行自动燃料逻辑。

这可以防止：

• 重复加油
• 多个控制器消耗同一份燃料
• 扫描过多
• 多人游戏不同步问题

队长将从已连接的网络中自动选出。

---

🚫 忽视单个火焰

每个火源都可以被排除在守光者的控制之外。

悬停在火源上时：

动作	输入
切换忽略/服从灯塔守护者	Ctrl + E

已忽略的火焰：

• 不要被Lightkeeper强制开启或关闭
• 不从光明守护者接收自动燃料
• 继续使用原版行为

这对于装饰性火焰、特殊的模组光源或由其他系统控制的光源非常有用。

---

🌐 多人游戏行为

守灯人专为多人游戏设计。

重要状态存储在ZDO数据中：

• 控制器开/关状态
• 自动补给开启/关闭状态
• 控制器半径
• 火焰免疫状态

这允许系统在以下情况下持续存在：

• 世界重载
• 服务器重启
• 玩家重新连接
• 区域卸载/重载

---

⚙️ 性能说明

守光者避免昂贵的全局扫描。

系统使用：

• 已注册控制器列表
• 已注册的射击列表
• 限时清理
• 批量射击检查
• 网络队长逻辑
• 仅在需要时使范围缓存失效

已销毁或移除的火灾会自动验证并清理。

---

🧩 兼容性说明

守灯人旨在与其它涉及火源的模组兼容。

重要兼容性选择：

• 普通 E 火焰上仍保持原版行为
• 守灯人控制器使用修饰键执行特殊操作
• 单次射击可无视守灯人
• 该模组适用于使用原版 壁炉 组件

未来的光照/颜色控制模组应该能更容易共存，因为Lightkeeper将以下内容分离：

• 灯光开/关控制
• 自动燃料控制
• 开火无视状态

---

🧪 示例设置

[Lightkeeper A] —— 已连接 —— [Lightkeeper B] —— 已连接 —— [Lightkeeper C]

如果这些通过半径连接：

• 关闭A会同时关闭A、B和C
• 关闭B的自动加油会同时禁用A、B和C的自动加油
• 储存于任何已连接且可用的守光者中的燃料均可使用
• 如果一名玩家打开了某个储物箱，则该储物箱会被跳过。

---

📘 翻译支持

所有面向玩家的文本均使用以下格式的翻译键：

$tag_lightkeeper_*_bal

翻译JSON键不应包含 $ 前缀。

示例：

{ "tag_lightkeeper_name_bal": "灯塔守卫", "tag_lightkeeper_open_storage_bal": "打开燃料储藏处" }

---

🌍 翻译键

守灯人
控制区域内火源并集中管理燃料补给
开启
关闭
打开燃料存储
切换灯光
切换自动加燃料
调整范围
自动加燃料时跳过打开的存储。
$piece_noaccess
守灯人已开启。
守灯人已关闭。
自动加燃料已启用。
自动加燃料已禁用。
守灯人范围：
忽略守灯人
服从守灯人
此灯光现在忽略守灯人。
此灯光现在服从守灯人。

---

❓ 常见问题

守夜人能和原版火把和篝火一起用吗？

是的，只要该物件使用的是英灵神殿的 壁炉 组件。

自动加油支持不同燃料类型吗？

是。控制器会检查每个火源使用的燃料物品，并且只从存储中提取匹配的燃料。

自动加注燃料会改变开放的存储空间吗？

不。如果玩家使用了守灯人存储，那么该存储会在该自动燃料结算中被跳过。

如果火焰被摧毁会发生什么？

系统会在清理过程中验证已注册的触发事件，并移除无效引用。

如果我更改控制器范围会发生什么？

网络缓存已失效，控制器网络已重新计算。

我可以排除特定的火焰吗？

是的。悬停在火上并按 Ctrl + E 切换是否忽略Lightkeeper。

关闭自动加燃料只影响一个控制器吗？

不。自动补给开关对所有当前连接的光守都是全网统一的。

如果网络之后分裂了会怎样？

每个控制器都会保留其上次存储的状态。分离后，后续的开关切换仅影响当前连接的网络。

---

💬 社区与支持

• 加入我们的Discord： 巴隆德的巢穴
• 在Ko-fi上支持： ko-fi.com/balrond1020

---

📌 最终备注

守灯人旨在减少重复的添火维护，同时保留英灵神殿燃料系统的意义。

它赋予玩家控制权、自动化和便利性，同时不会让火源变成免费的无限光源。