村民保持TFC灯具点亮

村民为群峦传说油灯添油

一个 Minecraft 模组，通过让附近的村民维护油灯，使群峦传说（TerraFirmaCraft）中的油灯能够更持久地用于永久性建筑。

📝 特性

当前特性

• 当附近的 TFC 油灯燃料不足时，村民会自动为其补充燃料
• 自然的维护感，补充量随机
• 只会为已点燃的油灯补充燃料（空灯或未点燃的油灯会被忽略）
• 所有数值均可配置，便于微调体验

计划特性

• 增加配置以白名单/黑名单指定燃料
• 增加配置以允许更多实体自动补充灯笼
• 根据燃料燃烧所需时间设定补充冷却时间，以防止无限抽取燃料（目前来看这不算大问题；更多信息见下文）

📕 工作原理

当油灯方块被 tick 时（应适用于任何继承 TFC LampBlock 类的方块实体），模组会检查附近的村民。如果村民在范围内，且油灯的燃料水平低于配置的阈值，油灯将被补充至一定随机量的燃料（数量由配置中的范围决定）。

✏️ 配置

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

• villagerRange：村民需要与油灯保持的距离（以方块为单位）才能维护它

  • 默认值：24
  • 最小值：1，最大值：Integer.MAX_VALUE

• fuelThreshold：村民将补充油灯的燃料水平（以 mB 为单位）

  • 默认值：50
  • 最小值：1，最大值：254
  • 注意：每 mB 燃料大约可持续 8000 tick（约 6-7 分钟）

• minFuelReplenish：油灯被补充燃料的最小量（以 mB 为单位）

  • 默认值：75
  • 最小值：1，最大值：250

• maxFuelReplenish：油灯被补充燃料的最大量（以 mB 为单位）

  • 默认值：150
  • 最小值：1，最大值：250

ℹ️ 技术说明

当使用可以抽取流体的模组（例如机械动力 Create）时，随着村民不断补充燃料，理论上可以无限抽取燃料。不过这应该不是什么大问题，因为：

1. 油灯只会在随机方块 tick 时被补充燃料
2. 如果油灯在被 tick 前被清空，它将会熄灭
3. 如有需要，可以调低配置值，以防止类似极慢速泵抽取的机制。

基本上，唯一可能实现无限抽取的方式是，要么你以足够慢的速度抽取流体，要么你找到一种方法让油灯中始终保持少量流体。我以后可能会通过为灯笼补充燃料添加适当的冷却时间来优化这一点，这也是我计划为这个模组添加的功能之一。

⚖️ 许可证

本项目基于 MIT 许可证授权。欢迎将其整合到整合包中。