创建:拯救青蛙港

创建:拯救青蛙港

一个用于创建传送带网络监控与救援的Minecraft模组。

创建

Rescue Frogport

Rescue Frogport 是一款用于 机械动力(Create)(NeoForge)的轻量级附属模组,可解决包裹网络死锁、无效地址投递失败以及传送带线路堵塞问题。它会自动扫描你的链式传送带网络,并将无法路由或拥堵的包裹重定向到专用的 Rescue Frogport(救援蛙口),作为溢出和死信仓库。

为何需要它

在复杂的机械动力物流系统中,传送带网络可能因以下原因而轻易陷入停滞:

  • 死信堆积:玩家删除或重命名了目标蛙口,导致活跃包裹在网络中永久循环。
  • 无地址货物:配置错误的打包机生产出无地址的包裹,填满传送带连接段。
  • 系统拥堵:同一货物的突然激增堆积在单段轨道上,阻塞所有其他交通。

Rescue Frogport 能够原生解决这些问题。它会检测循环段、连接段和链轮,监控包裹状态,并安全地将问题货物从主线路分流到专用的 18 格救援端口(可像普通蛙口一样清空)。

三条救援规则

每个救援蛙口每秒(可配置)扫描其连接的传送带网络,并应用三条救援程序:

  1. 无地址包裹:网络中任何没有地址的包裹会自动被重新寻址并路由到最近的救援蛙口。
  2. 无效地址救援:如果包裹的目标地址不存在或不再连接到传送带网络,则会被路由到最近的救援蛙口。(完全支持通配符匹配,例如:若存在类似 "target*" 的通配符接收器,地址为 "target15" 的包裹将不会被救援。)
  3. 拥堵与堵塞控制:如果同一包裹(相同地址和相同合并内容,忽略盒子样式/颜色和唯一订单 ID)在单段传送带(链轮循环段或连接段)上排队超过配置阈值(默认:10 个),则多余包裹会被重新寻址并路由到最近的救援蛙口。

合成

救援蛙口可通过无序合成配方制作:

输入 输出
1x 机械动力包裹蛙口(create:package_frogport)+ 1x 机械动力电子管(create:electron_tube) 1x 救援蛙口

配置

设置可在世界中服务器的配置文件夹中自定义,路径为 config/rescuefrogport-server.toml:

[server]
    # 允许在单个链式传送带段中的相同包裹(相同内容和相同地址)的最大数量。
    # 超过此数量的多余包裹将被救援。
    # 范围:1 ~ 1000(默认:10)
    congestionThreshold = 10

    # 每个救援蛙口扫描其链式传送带网络的频率(以游戏刻为单位)。
    # 20 刻 = 1 秒。较低的值响应更快,但会消耗更多 CPU。
    # 范围:1 ~ 200(默认:20)
    scanIntervalTicks = 20

许可证

本项目采用 MIT 许可证。

贡献

欢迎贡献!欢迎提出议题或拉取请求。

资产与纹理许可声明

包裹蛙口和电子管的所有原始纹理、模型和资产均为 机械动力模组团队 的独家财产(保留所有权利)。

本模组 不打包、复制或重新分发 机械动力模组的任何资产。所有视觉组件(例如基础的青蛙模型和电子管纹理)均在运行时动态引用并从你本地的原始机械动力模组 JAR 文件中加载,仍受机械动力模组团队保留的所有权利保护。本模组的代码采用 MIT 许可证授权,与机械动力模组的代码一样。