
UL自动生成器 开-关 - UndeadLegacy
根据所供电电路的电池电量自动开启和关闭**Undead Legacy汽油发电机**,因此仅在确实需要时才会消耗燃料。
查看大图UL 自动发电机
根据所供电电路的电池电量,自动开启和关闭 **Undead Legacy 汽油发电机**,因此只有在真正需要时才会消耗燃料。
版本 1.0.0 面向 7 Days to Die 2.6(V1.0)上的 Undead Legacy 2.7.x。
## 为什么你需要这个
在发电机开启期间,Undead Legacy 会在**每个电力 tick**(大约每秒 6 次)消耗发电机燃料,*即使电路的电池已经充满电*。那部分多余的电能——以及产生它的汽油——就这样被白白浪费了。
此插件会监视每个电力电路,等待电池真正需要补充时,替你开启/关闭发电机:
- 当电路的综合电池电量降至 `OnPercent`(默认 50%)或以下时,**开启发电机**。
- 当电量达到 `OffPercent`(默认 99%)或以上时,**关闭发电机**。
- 两个阈值为你提供了**迟滞**,因此发电机不会在单一数值附近反复开关。
- 它**绝不会自动启动油箱为空的发电机**——如果燃料低于 `MinFuelPercent`(默认 5%),发电机将保持玩家设定的状态,因此不会熄火。
典型的循环如下:**发电机关闭 → 电池放电至 50% → 发电机自动启动 → 电池回充至 99% → 发电机自动停止。** 只有在电池实际充电时才会消耗汽油。
## 需求
- 7 Days to Die 2.6(V1.0),并安装 **Undead Legacy 2.7.x**。
- Undead Legacy 自带 BepInEx 框架(doorstop + MultiFolderLoader),因此无需单独安装 BepInEx。
- 单人游戏、合作主机或专用服务器(插件仅在**服务器**上运行其逻辑。
## 安装
1. 将整个 **`Zzz_UL_AutoGenerator`** 文件夹复制到游戏的 `Mods` 文件夹中:
```
<7 Days To Die>/Mods/Zzz_UL_AutoGenerator/
├─ ModInfo.xml
└─ UL_AutoGenerator.dll
```
2. 启动游戏。设置文件会在首次启动时自动生成。
3. 完成。无需游戏内设置——包含发电机和电池(或电池组)的电路会被自动管理。
## 配置
所有设置都位于 `BepInEx/config/va.ul.autogenerator.cfg`,首次启动时生成。请在游戏关闭时编辑该文件。
| 设置 | 默认值 | 描述 |
|---|---|---|
| `Enabled` | `true` | 整个插件的总开关。 |
| `ScanIntervalSeconds` | `1` | 每个电路重新评估的频率(真实秒数)。 |
| `OnPercent` | `50` | 当电池电量等于或低于此百分比时启动发电机。 |
| `OffPercent` | `99` | 当电池电量等于或高于此百分比时停止发电机。 |
| `MinFuelPercent` | `5` | 绝不在油箱燃料低于此百分比时自动启动发电机(%)。 |
| `AutoStart` | `true` | 如果为 `false`,发电机**只会在电池充满时自动停止**——它永远不会自行启动。 |
| `DebugLog` | `true` | 将每个开启/关闭决策记录到 BepInEx 控制台/日志。 |
建议的起点:`50 / 99` 是默认值;如果你希望发电机多休息,可以提高 `OnPercent`(再次启动前放出更多余量)。如果你希望它尽可能少空转,请保持 `OffPercent` 较高。
## 工作原理(技术)
- BepInEx **`BaseUnityPlugin`**(GUID `va.ul.autogenerator`)——**无 Harmony 补丁、无 XML 修改、无热加载**。
- 所有 Undead Legacy 访问均通过**反射**在 `ULM_PowerManager.Instance.Circuits` → `ULM_PowerCircuit.Nodes` 上完成,因此插件与 DLL 版本解耦,并在所需类型缺失或重命名时优雅失败(日志中给出明确错误)。
- 每隔 `ScanIntervalSeconds` 使用当前电路状态重新评估。
- 电池电量计算:
- 单个电池单元:`Charge / Capacity`。
- 电池组:汇总所有堆叠的 `UseTimes` 与 `MaxUseTimes`(Undead Legacy 在物品堆叠上追踪电池组的“已用电量”,而不是简单的电量/容量对)。
- 工作**仅在服务器上**运行(由 `ConnectionManager.Instance.IsServer` 和 `GameStateManager.IsGameStarted()` 控制);纯客户端上不会进行任何评估。
- 只有*综合*电池百分比重要——它按容量加权,因此大型电池组在决策中占主导地位。
## 它不做什么
- **不**改变燃料消耗、油箱大小或功率输出(VKZR 的 Generator Autonomy 模组涵盖燃料效率调整)。
- **不**管理风力涡轮机或太阳能板——它们保持始终连接,并会在发电机关闭时愉快地为电池充电。
- **不**触碰没有发电机的电路,或电路上任何位置都没有电池的发电机。
## 兼容性与安全性
- 可与原版 Undead Legacy 及其他发电机/燃料模组一起使用——它只读取节点并切换 `IsOn`。
- 强制 `IsOn = false` 是安全的:Undead Legacy 的 `HandleDisconnect` 只会翻转供电标志,**不会**移除电线或断开链接。
- 发电机状态(`IsOn`、油箱燃料)由 Undead Legacy 自身持久化,因此设置可在存档和世界重新加载后保留。
- 插件不在存档中存储任何数据——可随时安全添加或移除。
## 故障排除 / 支持
- 每个事件都会以 `UL Auto Generator` 前缀记录,因此当出现异常时,BepInEx 日志(`LogOutput.log`)是首先要查看的地方。
- 可通过 `DebugLog = false` 静默全局开启/关闭决策。
- 如果插件报告未找到 UL 电力类型,请确认 Undead Legacy 确实已加载且为最新版本。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。