
BeltThrottle
Turn the vanilla Cargo Monitor into a real flow valve: a switch and a target-rate field are added to the panel, and the belt only passes the set items per minute. Stack aware. Switch off = vanilla behavior.Belt Throttle —— 流速监控器限流阀 v1.2.1
作者:LDG · 适用:Dyson Sphere Program(BepInEx 5)· 无前置依赖(BepInEx 除外)
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\local.dsp.beltthrottle.settings.txt,一行一个监控器:
# planetId,entityId,enabled,rate,unit
750000001,382,1,60,0
存档本身完全干净。卸载插件后带子恢复原速,只是限速设置会丢失。
四、配置项
BepInEx\config\local.dsp.beltthrottle.cfg:
[throttle]
## 总开关,关掉后所有监控器都回原版
Enabled = true
## 按物品个数限流(自动除以平均堆叠数)
StackAware = true
## 排查问题时打开,会在日志里打印每个监控器的目标/满速/放行比例
VerboseLog = false
五、卡住了怎么查
启动日志里每个拦截点都会自检,正常应该是这样:
[BeltThrottle] patch check: CargoPath.Update prefix=1 postfix=0
- 如果出现
没有挂到补丁,限流不会生效,说明补丁被别的插件抢了,把日志发我; - 打开开关后应该出现一行
限流生效:监控器#12(entity 382) 目标 300 个/分 …; - 如果出现
有限速设置但没有接管任何传送带:设置=105#43353=300;当前工厂 planetId=…,说明监控器编号和当前工厂对不上,把这行发我; - 如果出现
指向的传送带编号无效/没有货运路径之类,说明监控器和带子的绑定关系和预期不一致,也请发我。
六、已知限制
- 限流的实现方式是「让整条传送带在部分 tick 停下」,所以低速率时看起来是走走停停(例如 30 个/分时约每 60 tick 挪一次)。平均流量准确,但视觉上不是匀速滑动。
- 同一条传送带上挂了多个监控器时,取最严格的那个生效。
- 监控器本身的「监测周期」不影响限速,限速只看你填的目标流速。
七、构建
build.bat :: 编译 → pkg → dist\BeltThrottle-1.2.1.zip