BeltThrottle
限流阀:给原版流速监控器加上限速开关和目标流速输入框,传送带只按设定的每分钟个数放行,支持堆叠物品,设置随蓝图继承,关闭开关即恢复原版。 / Turns the vanilla Cargo Monitor into a real flow valve: throttle switch + rate box, the belt passes only the set items per minute, stack aware, settings kept in blueprints.Changelog
[1.3.2] - 2026-11-21
按 Thunderstore 版主要求做的 README 合规调整,代码与游戏内行为没有任何变化。
变更
- 移除 README 末尾的「八、构建」小节(其中的
build.bat打包命令属于开发流程说明,Thunderstore 全球规则要求包里不包含开发 / 测试相关内容); - 版本号递增到 1.3.2。
升级
直接覆盖安装即可,限速设置与蓝图不受影响。
[1.3.1] - 2026-11-20
纯文档与元数据更新,DLL 与 1.3.0 完全一致,游戏内行为没有任何变化。
变更
manifest.json的简介(模组管理器列表里显示的那一行)改为中文在前、英文在后的双语写法,国内玩家一眼就能看懂用途;- 简介长度压到 243 字符,符合 Thunderstore 的 250 字符硬上限(上一版是 281 字符,已超出限制);
- 1.3.0 的包已提交,Thunderstore 不允许同版本号重复上传,故以 1.3.1 重新发布。
升级
直接把新包覆盖安装即可,限速设置与蓝图不受影响。
[1.3.0] - 2026-11-20
新增:限速设置跟随蓝图
打开限速的监控器复制成蓝图后,粘贴出来的新监控器自动沿用蓝图里的限速开关与目标流速,不再需要手动重设。
实现方式:原版把流速监控器的设置存在 BuildingParameters.parameters(int[128])里,蓝图复制粘贴会搬运这份数组。其中索引 15、16 在原版两个方向上都未使用,本版将限速数据写入:
parameters[15]:1= 开启限速,0= 未设置;parameters[16]:低 24 位为「每分钟流量 × 100」,高 8 位为单位(0 = 每分钟,1 = 每秒)。
涉及的五个补丁点:
CopyFromFactoryObject:复制时把当前监控器的限速写进参数槽位;ToParamsArray:把 15/16 补进最终参数数组,真正进入BlueprintBuilding.parameters;FromParamsArray:粘贴时把 15/16 从蓝图参数读回;PasteToFactoryObject:覆盖建造 / 粘贴建筑设置时应用;ApplyPrebuildParametersToEntity:蓝图粘贴出的新建筑在 prebuild 建成时应用(这条是最容易被漏掉的一条)。
「无数据」时不清除既有设置——因为读档重建建筑也会走同一条参数链路,清除会误删玩家配置。
兼容性:原版导入参数时不读 15/16,卸载本插件后残留值被忽略;旧蓝图没有这两个槽,粘贴后视为未开启限速。原版「复制 / 粘贴建筑设置」(Shift + 右键)同样会继承限速设置。
[1.2.2] - 2026-11-20
合规重发版,游戏内功能与 1.2.1 完全一致,DLL 未做任何逻辑改动。
变更
- README 顶部补充 AI 使用声明(中英双语),配合 Thunderstore 的 AI 内容披露要求;
- 包在 Thunderstore 页面标注 AI Generated 类别;
- 版本号递增到 1.2.2。1.2.1 因缺少 AI 披露被审核拒绝且包内容不可变,只能以新版本提交。
升级
无需任何操作,存档与限速设置完全兼容。
[1.2.1] - 2026-11-19
首个公开发布版,限流逻辑与 1.2.0 完全一致(1.2.0 已实测通过)。
变更
- 作者改为 LDG,插件 GUID 由
local.dsp.beltthrottle改为LDG.BeltThrottle; - 配置文件随之变为
BepInEx\config\LDG.BeltThrottle.cfg; - 限速设置文件迁移到
LDG.BeltThrottle.settings.txt。首次启动会自动读取旧的local.dsp.beltthrottle.settings.txt,已有的限速配置不会丢,改动任意一项后自动写成新文件; manifest.json补齐 Thunderstore 依赖xiaoye97-BepInEx-5.4.17。
升级注意
GUID 变了,旧版(local.dsp.beltthrottle)和新版会被 r2modman / BepInEx 当成两个插件。
请先在 r2modman 里卸载旧的 BeltThrottle,再安装本版,避免两个 DLL 同时加载。
[1.2.0] - 2026-11-19
修正(1.1.1 仍然无效的真正根因)
- 传送带不是在主线程逐条推进的。
GameLogic的 tick 表里:case 2200: if (单线程) FactoryCargoPathGameTick() else FactoryCargoPathGameTick_Parallel()。 并行版_cargo_path_parallel直接调用cargoPath.Update(),完全绕开CargoTraffic.CargoPathsGameTickSync。 1.1.x 把「本 tick 该拦哪条带」的计算挂在CargoPathsGameTickSync的 Prefix 上,在你的机器上这个方法从来没被调用过, 所以补丁挂上了也一条日志都没有。 - 新实现不再依赖任何每 tick 的主线程回调:主线程(插件
Update)只负责重建「path → 放行比例」的只读快照, 拦截判定放在CargoPath.Update的 Prefix 里,用floor(tick×ratio) > floor((tick-1)×ratio)纯算术判断, 无状态、无锁、工作线程安全。 - 快照通过
volatile引用整体替换发布;没有监控器开启限流时是空字典,Prefix 只多一次Count == 0判断, 基本没有性能开销(也顺手去掉了 1.1.x 每 tick 全量扫monitorPool的开销)。 - 新增诊断:有限速设置却没接管任何传送带时,日志会打出「设置里的 planetId#entityId」和「当前工厂的 planetId」, 一眼能看出是不是编号对不上。
- UI 里改开关或改流速后会立刻重建快照,不用等下一次轮询。
[1.1.1] - 2026-11-19
修正(1.1.0 面板正常但限流无效)
- 拦截记录被写坏的根因:
GameLogic每个 tick 会对所有已创建的工厂各调一次CargoTraffic.CargoPathsGameTickSync。原实现在每次调用开头Blocked.Clear(),于是后一个工厂把前一个工厂刚标记的传送带全部清空,限流从没生效过。现在改为「按 path 引用打 gameTick 时间戳、过期自然失效」,不再有任何全局清空。 - 补丁改成逐个类显式挂载(
CreateClassProcessor),并在启动日志里用Harmony.GetPatchInfo校验CargoPath.Update、CargoPathsGameTickSync是否真的挂上,挂不上会直接报 Error。 - 启动/停止限流时会打一行日志(限流生效 / 恢复满速),
VerboseLog=true时每 64 tick 输出诊断行(放行比例、path 长度、本 tick 拦截数、累计拦截 Update 次数)。
[1.1.0] - 2026-11-19
重做(1.0.x 实测无效)
- 限流方式整个换掉。原来去改传送带 chunk 的「每 tick 前进格数」,但 chunk 数据会被游戏在拼带、升级、读档时重建,写进去的值随时失效,实测完全没有效果。现在改为直接拦截
CargoPath.Update:需要限流的传送带本 tick 不推进,货物停在原地。 - 面板底部新增「限速器」开关 + 目标流速输入框,不再借用原版那个隐形的「目标流量」框。开关关闭 = 100% 原版流速监控器。
- 速率用时间占空比控制:目标 N 个/分 → 每 tick 放行比例 = N / 满速,累加器攒够 1 放行一 tick,长期平均精确等于设定值。
- 支持堆叠物品:默认按「物品个数」限流,自动除以带上的平均堆叠数(
StackAware)。 - 面板右侧实时显示「放行 xx%」,填完数立刻能看出是否生效。
- 限速设置独立存放在
BepInEx\config\local.dsp.beltthrottle.settings.txt,存档保持干净。 - 去掉 RequirePower / RestoreBeltSpeedOnSave(新方案不改带速,没有这两类问题)。
[1.0.1] - 2026-11-19
修正
- 「目标流量」那个数字就是输入框,但原版没有可见边框,几乎所有人都以为它只是一行说明文字。现在面板打开时会给这个数字加青色描边、必要时补一层淡背景,一眼能看出「这里能填数」。
- README 补上「怎么填」「监测周期会改变填写含义」的说明。
[1.0.0] - 2026-11-19
首个版本。
新增
- 流速监控器限流:把监控器的「流速」数值变成真实的限流值。目标 N 个/分钟时,监控器所贴的传送带段每分钟只放行 N 个,多余货物堆积在监控器上游,流出段稳定按设定值输出。
- 流速为 0 时自动不限流;拆监控器 / 断电 / 提高目标到满速以上,都会自动恢复原版带速。
- 每 tick 先恢复再重算,不会留下卡死的传送带。
- 存档写入前把带速恢复原版(
RestoreBeltSpeedOnSave),存档保持干净、卸载插件后旧存档也不会异常。 - 配置项:
Enabled、RequirePower、VerboseLog、RestoreBeltSpeedOnSave。
说明
- 限流作用在监控器所在的那一段传送带(chunk)。不限流时与原版完全一致。
- 只改
CargoTraffic的 tick 与存档入口,不新增物品、不改 prefab、不写自定义存档字段。
