tehAon的按需燃料 - 燃料节省 - 熔炉与营火自动关闭(服务端)

tehAon的按需燃料 - 燃料节省 - 熔炉与营火自动关闭(服务端)

锻造炉、营火和化学工作站只在真正工作时燃烧燃料。最后一件物品不会过度燃烧,制作队列清空时火焰会熄灭,卡住的工作站会变暗直到你腾出空间。剩余燃料会保留。空置的工作站仍会燃烧供热。仅服务端生效;玩家无需安装任何东西。

[size=5][b]Fuel On Demand(燃料按需消耗)[/b][/size]
[i]7 Days to Die — 仅服务端[/i]

[size=4][b]我该下载哪个文件?[/b][/size]
[list]
[][b]游戏 V3.0.0 至 V3.3.0[/b] → [b]Fuel On Demand 0.5.0[/b](主文件)。一个构建版本即可覆盖以上全部版本。[/]
[/list][b]在 V3.3 上,你必须使用 0.4.1 或更高版本。[/b] V3.3 改变了游戏存储物品堆叠的方式,所有更早的版本在该版本上第一次熔炉计时(tick)时都会自动关闭。[b]在 V3.0.1 或更高版本上,你必须使用 0.2.3 或更高版本。[/b] V3.0.1 改变了本模组读取的某个内容,所有更早的版本在每次工作站计时时都会报错。如果你用的游戏版本本模组未覆盖,它会在服务器日志中告知你并自动关闭——你的工作站将表现得和原版一样,其他一切不受影响。旧版游戏对应的构建版本仍可在“文件”选项卡的 [b]Old versions[/b](旧版本)/ 归档文件中获取。

熔炉、营火和化学工作站仅在真正工作时才会消耗燃料。

[b]不止是自动熄火。[/b] 在队列清空时熄灭火只是简单的一部分。本模组还会阻止每次制作和熔炼最后一个物品时的过度消耗,在熔炉卡住时熄火,而不是让它白白烧掉一整堆木头却毫无产出,并在你腾出空间时自动重新点燃——而且所有这些在服务器重启后仍会保留状态。

[b]从 OcbStopFuelWaste 迁移过来?[/b] 那个模组针对游戏 1.0,无法在 V3 上加载,而且除了服务器外还必须安装在[i]每个客户端[/i]上。本模组仅限服务端——你的玩家无需安装任何东西,并可以保持 EasyAntiCheat 开启——而且它还覆盖了 OCB 自己页面列出的会破坏其自动停止功能的两种情况:制作队列填满输出槽位,以及熔炼达到堆叠上限。

原版中,一个点燃的工作站会一直燃烧,直到你注意到并手动关闭。它会为了完成一个只需再 2 秒的制作而多消耗一整单位燃料。而且当一个卡住的熔炉毫无进展时,它还会心安理得地烧掉一整堆木头。本模组修复了以上全部三个问题。

附加好处:一个燃烧中的工作站每计时(tick)都会触发一次 AI 导演的热度事件。在工作完成时熄火意味着被遗忘点燃的熔炉不再向热度地图贡献——预计尖啸者(screamer)会更少。

[size=4][b]功能[/b][/size]
[list]
[][b]绝不超量燃烧。[/b] 每次计时消耗的燃料以剩余工作量为上限,因此完成一个 0.3 秒的制作只消耗 0.3 秒的燃料,而不是一整个计时。覆盖整堆原材料,不只是最后一个物品。[/]
[][b]工作停止时停止燃烧。[/b] 制作队列清空以及最后一份原材料熔炼完成后——火焰熄灭。[/]
[][b]工作站卡住时停止燃烧并熄火。[/b] 输出槽位已满,或熔炼单位槽位达到堆叠上限,意味着无法取得进展,因此燃料消耗冻结,工作站熄灭。你一腾出空间的瞬间它就会重新点燃。一个点着却不消耗任何东西的熔炉看起来像是仍在工作;而熄灭的熔炉让你一眼就能看出它没有在工作。[/]
[][b]尽可能绕过卡住的情况。[/b] 如果队列前端的制作无法输出,但后面的某个可以,工作站会将该项提前并改为处理它,而不是直接停工。不会取消、退还或丢失任何东西,被跳过的项会保留它已经花费的制作时间。[/]
[][b]重启后仍保留状态。[/b] [i](0.5.0 新增)[/i] 一个因输出已满而熄灭的熔炉,在服务器重启后或你离开时基地被卸载后,仍会在你腾出空间时自动重新点燃。[/]
[][b]保留你的部分燃料。[/b] 剩余的燃烧时间会被保留,并在你下次点燃工作站时优先使用。[/]
[][b]不影响纯加热模式。[/b] 在没有任何东西的情况下点燃工作站,它会持续燃烧,完全和原版一样。只有曾经有工作、然后完成的工作站才会被熄灭。[/]
[][b]窗口打开时保持不干预,之后补上。[/b] 当玩家打开工作站 UI 时,游戏会在他们的客户端而非服务器上对该工作站进行计时,因此模组不去干预它,它会像原版一样燃烧。窗口一关闭火焰就会熄灭——包括工作在他们站在里面时已完成的情况。[/]
[/list]
[size=4][b]设置[/b][/size]
全部五项行为默认开启。模组文件夹中的 [b]Config/fuelondemand.xml[/b] 让你只保留想要的部分:
[list]
[][b]CapFuelToWork[/b] — 关闭 = 无论剩余工作多小,原版都会消耗一整个计时的燃料。[/]
[][b]ExtinguishWhenDone[/b] — 关闭 = 原版会让火焰燃烧,直到玩家手动关闭。[/]
[][b]PauseWhenJammed[/b] — 关闭 = 原版会让毫无进展的熔炉烧掉一整堆木头。[/]
[][b]ExtinguishWhenJammed[/b] [i](0.3.0 新增)[/i] — 关闭 = 卡住的工作站会保持点燃但不消耗任何东西。它只会重新点燃[i]本模组[/i]熄灭的火焰;你手动关闭的火焰会保持关闭。[/]
[][b]SkipJammedCrafts[/b] [i](0.3.0 新增)[/i] — 关闭 = 队列完全不被干预,卡住的工作站会停滞。这是唯一会改变你能看到的内容的设置,因为它会重排你安排好的队列,而且该顺序会被保存。[/]
[/list]最常见的配置:[b]限制过度燃烧但让我的熔炉保持点燃[/b]——CapFuelToWork 为 true,ExtinguishWhenDone 为 false。启动时读取一次,因此请编辑后重启服务器;最终生效的配置会打印在日志中。

[b]在更新间保留你的设置:[/b] fuelondemand.xml 每次下载都会被覆盖——新设置及其文档就是这样传达给你的。只把你修改过的行放进 [b]Config/fuelondemand.local.xml[/b],该文件不随任何下载附带,也永远不会被覆盖:
[code]<fuelondemand>
  <setting name="ExtinguishWhenDone" value="false"/>
</fuelondemand>[/code]非 true/false 的值、未知的设置名称或损坏的文件各会记录一行日志并保留默认值——模组绝不会因为自己的配置而启动失败。

[size=4][b]安装[/b][/size]
需要 [b]7 Days to Die V3.0.0 至 V3.3.0[/b]。[b]专用服务器保持 EasyAntiCheat 开启[/b]——专用服务器不会因反作弊而限制模组 DLL。[b]单人游戏和主机托管游戏需要关闭 EAC[/b],因为在那里的服务器运行在你自己的受 EAC 保护的游戏进程内。
[list=1]
[]将 [b]FuelOnDemand[/b] 文件夹解压到服务器的 [b]Mods/[/b] 文件夹中。[/]
[]在专用服务器上,[b]EACEnabled[/b] 保持原样。在单人游戏或作为主机时,使用启动器的 [b]Play (No EAC)[/b](无 EAC 启动)选项启动。[/]
[]重启服务器。日志应显示:
[code]INF [FuelOnDemand] 0.5.0 — for game V3.0.0-V3.3.0; built against V 3.0.0 (b259), running on V 3.3.0 (b18)
INF [FuelOnDemand] patched TileEntityWorkstation.HandleFuel
INF [FuelOnDemand] patched TileEntityWorkstation.UpdateTick
INF [FuelOnDemand] config: capFuelToWork=on extinguishWhenDone=on pauseWhenJammed=on extinguishWhenJammed=on skipJammedCrafts=on
INF [FuelOnDemand] InitMod complete — 2 method(s) patched.[/code]第一行会告诉你模组构建所针对的游戏版本以及你正在运行的版本。如果它显示 [b]disabled[/b](已禁用),说明你用的游戏版本本构建未覆盖——请从本页获取匹配的文件。如果你看到 [b]No methods were patched[/b](未修补任何方法),说明游戏更新移动了这些方法;模组处于惰性安全状态,但需要重新构建。[/
]
[/list]
[b]客户端不安装任何东西。[/b] 两个被修补的方法都位于游戏自身的 IsServer 守卫之后,因此它们绝不会在客户端执行,而火焰/燃料状态通过原版的图块实体同步进行复制。在单人游戏和监听服务器主机上也可用,因为主机就是服务器。

[b]支持任意游戏语言。[/b] 模组在游戏中不显示自己的任何文本,因此无论你的玩家使用何种语言都能正常工作。

注意:在专用服务器上你完全不需要禁用 EAC,因此不存在这对你的玩家有何影响的问题。(如果你仍然禁用了它,服务器的 EAC 授权器会变为非活动状态,不会向连接的客户端提出任何要求,因此启用了 EAC 的客户端仍可加入——这是对游戏代码的解读,而非实际加入测试。)

[size=4][b]兼容性[/b][/size]
[list]
[][b]V3.0.0、V3.0.1、V3.1、V3.2.0 和 V3.3.0。[/b] 一个构建版本覆盖全部五个,并已逐一验证:DLL 绑定的每个成员在全部五个版本上都能解析,每个版本的无头专用服务器都能加载它、应用两个补丁、通过模组的自检,并到达 StartGame 而无异常。V3.3 将模组读取的物品堆叠字段改成了属性,这导致 v0.4.1 之前的每个版本在该版本上自动关闭——在 V3.3 上你需要 v0.4.1 或更高版本。V3.0.1 改变了模组读取的一个成员,这导致 v0.2.3 之前的每个版本在每次工作站计时时都会报错——在 V3.0.1 或更高版本上你需要 v0.2.3 或更高版本。[/]
[]仅限原版 TileEntityWorkstation。自带工作站图块实体的全面改造包(Darkness Falls、Undead Legacy)不在覆盖范围内。[/]
[]不兼容其他修补相同方法的燃料节省模组。[/]
[]如果未来的游戏更新移动了模组读取的某些内容,它会在日志中说明并禁用自身,让工作站表现为原版。它不会让你的游戏崩溃——但需要重新构建。[/]
[/list]
[size=4][b]致谢[/b][/size]
[list]
[][b]OcbStopFuelWaste[/b](作者 [b]OCB[/b])确立了本模组所遵循的方法:限制传递给 HandleFuel 的时间,并在工作完成时熄火。它针对游戏 1.0,无法在 V3.0 上加载,它还修补了客户端的 工作站 UI(这就是它必须安装在客户端上的原因),其仓库没有附带许可证文件。未复制任何源代码——本模组是针对 V3.0 程序集编写的——但设计上归功于它。[/]
[][b]KitsuneFuelSaver[/b](MIT)由 [b]Kitsune-Den[/b] 编写,采用了不同的路线:当制作队列清空时熄火,而不限制燃料消耗。[/]
[]使用游戏自带的 Harmony 库([b]Mods/0_TFP_Harmony[/b]);不打包任何额外内容。[/]
[]模组由 [b]tehAon[/b] 制作。以 MIT 许可发布——随意 fork、发布,无需许可。[/]
[/list]
[size=4][b]本模组的原创之处[/b][/size]
覆盖批量熔炼的燃料上限、针对输出已满和熔炼单位槽位已满的停滞检测、在剩余工作无法精确推导时拒绝设置上限(上限设得过低会导致免费熔炼)、保留纯加热模式的“有工作 → 无工作”边沿触发,以及仅限服务端运行。

[line]
[size=5][b]Bug、求助与更新[/b][/size]
遇到 Bug 或想获取更新消息?请在此处的 [b]Bugs[/b] 选项卡发帖,或加入 tehAon 模组 Discord——我所有 7 Days to Die 模组的中心:
[b][url=https://discord.gg/DYCzCPSvwa]discord.gg/DYCzCPSvwa[/url][/b]

[center][size=3]由 [b]tehAon[/b] 制作 — [url=https://next.nexusmods.com/profile/tehAon]更多我的 7 Days to Die 模组[/url] • MIT 许可[/size][/center]