Villagers Keep TFC Lamps Lit

村民会为 TFC 灯具添油

一款 Minecraft 模组，让 TerraFirmaCraft 灯具更适合用于永久建筑：附近的村民会
为灯具添油。

📝 功能

现有功能

• 灯具燃料不足时，村民会自动为附近的 TFC 灯具补充燃料
• 随机补充燃料，让维护过程更自然
• 只会为已经点亮的灯具补充燃料（空灯或未点亮的灯具会被忽略）
• 所有数值均可配置，方便微调体验

计划中的功能

• 添加燃料白名单/黑名单配置
• 添加配置，以指定可自动为灯笼补充燃料的其他实体
• 根据燃料预计燃烧时长设置补充冷却时间，防止无限抽取燃料（目前这应该不是什么大问题；更多信息见下文）

📕 工作原理

灯具方块每次收到随机刻更新时，模组都会检查附近是否有村民（应该适用于任何继承 TFC
LampBlock 类的方块实体）。如果范围内有村民，且灯具燃料低于配置的阈值，
灯具就会被补充燃料，直到达到一个随机燃料量（具体范围由配置定义）。

✏️ 配置

所有数值均可在附带的配置文件中调整（位于 forge_dir/config/villagerskeeptfclampslit.toml）：

• villagerRange：村民与灯具之间需要保持的维护距离（方块）
• 默认值：24
• 最小值：1，最大值：Integer.MAX_VALUE

• fuelThreshold：村民开始为灯具补充燃料时的燃料量（mB）
• 默认值：50
• 最小值：1，最大值：254
• 注意：每 mB 燃料约可燃烧 8000 刻（约 6–7 分钟）

• minFuelReplenish灯具补充燃料后达到的最小燃料量（mB）
• 默认值：75
• 最小值：1，最大值：250

• maxFuelReplenish：灯具补充燃料后达到的最大燃料量（mB）
• 默认值：150
• 最小值：1，最大值：250

ℹ️ 技术说明

如果使用了可以抽取流体的模组（例如 Create），那么村民补充燃料时，可能可以无限抽取燃料。
不过，这应该不是什么大问题，因为：

1. 灯具只会在随机方块刻时补充燃料
2. 如果灯具在收到刻更新前就被抽空，就会熄灭
3. 必要时可以调低配置数值，以阻止非常缓慢的抽取等机制。

基本上，只有在抽取流体的速度足够慢，或是找到办法让
灯具中始终留有少量流体时，才有可能实现无限抽取。之后我可能会通过添加正式的冷却时间来完善此功能，限制灯笼的
补充频率；这也是我计划为此模组添加的功能之一。

⚖️ 许可证

本项目采用 MIT 许可证。欢迎将其加入整合包。