
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.Belt Throttle —— 流速监控器限流阀 v1.3.2
作者:LDG · 适用:Dyson Sphere Program(BepInEx 5)· 无前置依赖(BepInEx 除外)
AI 使用声明 / AI Disclosure
本模组的 C# 代码在编写过程中使用了 AI 工具辅助(代码生成与问题排查),随后由作者在真实游戏环境中完成编译、加载、实测与验证。作者对本模组的全部内容与行为负责。
按 Thunderstore 的政策要求,本包已标注 AI Generated 类别。
The C# source of this mod was written with the help of an AI assistant (code generation and debugging), then compiled, loaded and tested in-game by the author, who takes full responsibility for the content. This package is tagged AI Generated as required by Thunderstore's policy.
English summary — Belt Throttle turns the vanilla Cargo Monitor into a real throughput valve. Open a monitor's panel, flip the Throttle switch on, type how many items per minute you want, and that belt will only pass that many; the rest backs up upstream. It is stack-aware (counts items, not cargo slots) and can also be set in items per second. Switch off = pure vanilla behavior. Nothing is written into the save file, so uninstalling this mod leaves your factory untouched. Requires BepInEx 5 only.
给原版 流速监控器(Cargo Monitor) 补上它本来就该有的能力:真的把流量卡住。
原版的流速监控器只是一块贴在传送带上的仪表,它显示的数值只用来做 Pass / Fail 判定、触发报警或信号,从不限制通过量。这个插件在面板底部加一行 限速器:打开开关、填上每分钟想通过多少个,这条带子就按这个速率放行,多出来的货物堆在监控器上游。
一、用法
-
把流速监控器贴在传送带上(和平时一样)。
-
打开监控器面板,最下面多出一行:
限速器 [ 开关 ] 目标流速 [ 60 ] 个/分钟 放行 3.3% -
点开开关,在输入框里填每分钟通过的个数,回车或点面板别处即生效。
| 状态 | 效果 |
|---|---|
| 开关关闭(默认) | 完全原版行为,插件不碰这条带子 |
| 开关打开 + 速率 60 | 每分钟只放行 60 个,其余堆在监控器上游 |
| 开关打开 + 速率 0 | 等同于不限流 |
| 速率 ≥ 带子满速 | 自动跳过,不限流 |
带子满速:一级 360 个/分、二级 720、三级 1800。
面板右侧的「放行 xx%」是本 tick 的放行比例,填完数就能立刻看出限流是否生效。
二、它是怎么工作的
旧的两次失败都是同一个原因:现代 DSP 的传送带模拟跑在工作线程上。
// GameLogic 的 tick 表
case 2200:
if (单线程) FactoryCargoPathGameTick(); // → CargoPathsGameTickSync()
else FactoryCargoPathGameTick_Parallel(...); // → _cargo_path_parallel() → path.Update()
并行版直接调用 CargoPath.Update(),根本不经过 CargoTraffic.CargoPathsGameTickSync。
之前把「本 tick 该拦哪条带」的计算挂在 CargoPathsGameTickSync 上,所以在多核机器上那段代码从来没执行过
(日志里只有 patch check 和开关记录,没有 限流生效,原因就在这里)。
现在改成:主线程只算一次快照,拦截判定放在 CargoPath.Update 里纯算术完成。
- 主线程(插件
Update,每 15 帧或设置变动时)扫描所有工厂的监控器,生成「path → 放行比例」的只读快照; CargoPath.Update的 Prefix 只做一次字典查询,然后floor(tick × ratio) > floor((tick-1) × ratio)为真就放行,否则整条 path 本 tick 不推进;- 无状态、无锁,工作线程并发调用也安全;
- 没有监控器开启限流时快照是空字典,Prefix 只多一次
Count == 0判断,几乎没有开销。
长期平均流量精确等于设定值,误差不超过一个 tick。不丢货、不复制物品、不往存档写任何自定义数据。
关于堆叠物品
传送带上一个货物格子可能堆叠 N 个物品。默认 StackAware = true:插件会实时采样这条带子上的平均堆叠数,你填的是物品个数——填 120 就是每分钟 120 个物品,哪怕每格堆了 4 个。
想让数字和原版监控器显示的含义完全一致(按货物格子算),把 StackAware 改成 false。
三、设置存在哪
BepInEx\config\LDG.BeltThrottle.settings.txt,一行一个监控器:
# planetId,entityId,enabled,rate,unit
750000001,382,1,60,0
存档本身完全干净。卸载插件后带子恢复原速,只是限速设置会丢失。
从旧版(1.2.0 及更早)升级:新版第一次启动会自动读取旧的
local.dsp.beltthrottle.settings.txt,你改动任意一项设置后就写成新文件名,无需手工迁移。
四、蓝图与复制粘贴
打开限速的监控器复制成蓝图,再粘贴出来,限速设置会一起带过去,不需要手动重填。
原理:原版把流速监控器的设置存在建筑参数数组 BuildingParameters.parameters(int[128])里,蓝图复制粘贴会搬运这份数组。该数组的索引 15、16 在原版两个方向上都没用到(导出只写 0~14、17~21),本插件就用它们存「开关 + 目标流速」:
| 槽位 | 内容 |
|---|---|
parameters[15] |
1 = 开启限速,0 = 未设置 |
parameters[16] |
低 24 位:每分钟流量 × 100;高 8 位:单位(0 = 个/分钟,1 = 个/秒) |
因为原版导入参数时根本不读这两个槽,所以即使以后卸载本插件,存档与蓝图里的残留值也只会被忽略,不会引发异常行为。
同样地,原版的 复制建筑设置 / 粘贴建筑设置(Shift + 右键)走的是同一条链路,一样会继承限速。
两点边界情况:
- 旧蓝图(没有这两个槽)粘贴后不会带限速,也不会清除目标位置原有的限速设置;
- 用「未开启限速」的蓝图覆盖一个已开限速的监控器时,旧设置会保留,需要手动关掉。
这样设计是有意为之:读档重建建筑时会走同一条参数应用链路,若在「无数据」时清除会误删玩家的设置。
五、配置项
BepInEx\config\LDG.BeltThrottle.cfg:
[throttle]
## 总开关,关掉后所有监控器都回原版
Enabled = true
## 按物品个数限流(自动除以平均堆叠数)
StackAware = true
## 排查问题时打开,会在日志里打印每个监控器的目标/满速/放行比例
VerboseLog = false
六、卡住了怎么查
启动日志里每个拦截点都会自检,正常应该是这样:
[BeltThrottle] patch check: CargoPath.Update prefix=1 postfix=0
[BeltThrottle] patch check: BuildingParameters.ToParamsArray prefix=0 postfix=1
[BeltThrottle] patch check: BuildingParameters.FromParamsArray prefix=0 postfix=1
[BeltThrottle] patch check: BuildingParameters.PasteToFactoryObject prefix=0 postfix=1
[BeltThrottle] patch check: BuildingParameters.ApplyPrebuildParametersToEntity prefix=0 postfix=1
后四行是蓝图携带设置用的。如果它们显示 没有挂到补丁,蓝图就不会带限速(限流本身仍然正常)。
- 如果出现
没有挂到补丁,限流不会生效,说明补丁被别的插件抢了,把日志发我; - 打开开关后应该出现一行
限流生效:监控器#12(entity 382) 目标 300 个/分 …; - 如果出现
有限速设置但没有接管任何传送带:设置=105#43353=300;当前工厂 planetId=…,说明监控器编号和当前工厂对不上,把这行发我; - 如果出现
指向的传送带编号无效/没有货运路径之类,说明监控器和带子的绑定关系和预期不一致,也请发我。
七、已知限制
- 限流的实现方式是「让整条传送带在部分 tick 停下」,所以低速率时看起来是走走停停(例如 30 个/分时约每 60 tick 挪一次)。平均流量准确,但视觉上不是匀速滑动。
- 同一条传送带上挂了多个监控器时,取最严格的那个生效。
- 监控器本身的「监测周期」不影响限速,限速只看你填的目标流速。