类似MC漏斗与矿车模组-SC Logistics
声明 :本模组完全由本人于workbuddy平台使用DeepSeek(深度求索)进行开发,只担任写提示词的任务 API版本最低 1.9.4!!! SC Logistics 物流与高速熔炉模组Survivalcraft 2.4.0.0 + SCAPI 1.9.5.1(正式版)· Android · .scmod 给《生存战争》补上一条真正的铁路物流线。这不是“加了几块方块”的小模组。它把成熟游戏里那套铁路物流——铁轨自动成线、矿车自动行驶、停车站调度、漏斗矿车装卸、玩家骑乘驾驶——从零实现到了 Survivalcraft 的 SCAPI 上,并针对触屏重新设计了驾驶手感。铺下第一段铁轨,它会自动向前延伸;转角自动变弯,上坡自动变坡道。放一辆矿车,它会沿着整张铁路网自己跑,到站减速、停稳、往返。漏斗矿车经过箱子下方会抽取,经过地面会吸走掉落物,经过熔炉会把料送进去,而且不会打断正在炼制的配方。想自己开?骑上普通矿车,视线朝哪、推杆就往哪走,视角能转满一圈,过弯时镜头平滑跟随。工程包含三种核心方块(漏斗、铁轨、停车站)、两种矿车(普通、漏斗)、完整的铁路网络与占用调度,以及一套在真实游戏进程里跑通的端到端验收(会造一个真实玩家骑上矿车去验证视角)。源码可直接 dotnet build 打包成 .scmod。据我所知,这是 Survivalcraft 社区里第一个把上述铁路物流完整做出来的模组。如果它能帮你省下几个月的踩坑时间,这个仓库就值了。欢迎 Issue、PR,或把它移植到其他 API 版本。非官方模组,与 Candy Rufus Games 无关;Survivalcraft 及相关素材版权归其作者所有。 本仓库是该模组的完整可编译工程,不是设计稿。所有 C 代码都针对真实的 SCAPI 1.9.5.1 源码编写,并且已经在实际游戏进程中完成过加载验证。第 1 节 这个模组做了什么一句话:把“铁轨 + 矿车 + 漏斗”这套物流玩法,完整地做进 Survivalcraft。· 铁轨会自动成形:放下第一段,后面按你的方向继续铺就行;两侧相对自动变直线,两侧垂直自动变弯道,一头平连、另一头高一格时自动变坡道。不用记形状,也不用卡角度。 · 矿车会自己跑:放在轨道上就沿线行驶,默认 8 格/秒(设置里可调)。一条连续铁路同一时间只允许一辆车,不会出现两辆车互相顶飞。 · 停车站负责调度:放在线路末端,右键在「停止 / 往返」之间切换。到站停在站台前一格,不穿模、不挡按钮。 · 漏斗与漏斗矿车负责搬运:漏斗按朝向单方向输出、从上方容器抽取、可吸取地面掉落物;漏斗矿车是完整的移动容器(5 格),边跑边装卸,经过目标不停车。 · 熔炉产线可以无人值守:漏斗给熔炉投料时强制“输入区只占一个槽”,不会因为第二种矿物被塞进第二格而打断炼制。 · 想自己开就骑上去:普通矿车可骑,推杆向前就朝视线方向走、向后就倒车,视角能转满一圈,过弯时镜头平滑跟随。每条规则的细节(数据位、网络划分、断轨、区块边界等)在第 8 节「玩法」。第 2 节 和《我的世界》比:像在哪、不一样在哪、差在哪像的地方是心智模型:铁轨、矿车、漏斗三件套,合成配方也刻意贴近——5 个铁锭摆 U 形做矿车,铁锭围一圈加箱子做漏斗,6 铁锭加木棍出 16 段铁轨。玩过 MC 的人不需要重新学一套词汇。不一样的地方是“谁来决定车怎么动”。MC 把这件事交给红石:动力铁轨要充能,到站要用探测铁轨加电路,分流要用转辙轨。这个模组把它收进三个方块里:铁轨自己成形、矿车自己跑、停车站管停与往返。代价是自由度——能调的东西比红石少得多。逐项对比· 铁轨形状——MC:手动逐段摆放,弯道、坡道由玩家朝向决定;SC Logistics:自动推导,相对两格变直线,垂直变弯道,上坡变坡道。 · 动力——MC:动力铁轨加红石或煤,无动力时靠推;SC Logistics:没有动力铁轨,矿车自驱,速度全局可调。 · 到站调度——MC:探测铁轨加红石电路自己搭;SC Logistics:停车站方块,右键切「停止 / 往返」。 · 岔道分流——MC:有转辙轨,可做树状网络;SC Logistics:没有岔道,只能单线两端跑。 · 同时在线车辆——MC:任意多辆;SC Logistics:一条连续网络只允许一辆。 · 漏斗矿车——MC:5 格,吸上方容器与地面,向下方容器输出;SC Logistics:5 格,同样三件事,且经过容器不停车。 · 漏斗给熔炉投料——MC:直接塞,两个输入槽有料就可能打断炼制;SC Logistics:强制输入区单槽,不打断正在炼制的配方。 · 玩家驾驶——MC:可骑,WASD 控制,岔道口可选方向;SC Logistics:可骑,推杆前后加视线定方向,视角 360°,没有岔道可选。 · 红石——MC:完整体系;SC Logistics:完全没有。 · 物品分拣——MC:漏斗加比较器加红石自己搭;SC Logistics:没有过滤器,也没有比较器输出。 · 平台——MC:Java 与基岩,全平台;SC Logistics:仅 Android,限定 SCAPI 1.9.5.1 与游戏 2.4.0.0。 · 多人——MC:支持;SC Logistics:未适配,首版单人。差的地方在下一节展开。一句话概括:它把“一条线、一辆车、两端跑”做到了能长期无人值守,但还没有 MC 那种“用红石把几十辆车编排成一张网”的复杂度。第 3 节 目前的不足3.1 功能上还缺什么1.完全没有红石。没有红石接口,不能用拉杆、压力板、计时器控制矿车,也不能用比较器读容器存量。2.没有动力铁轨和刹车轨。矿车永远自驱,速度只能全局调,做不到“这段加速、那段减速”。3.没有岔道。铁轨只有直线、弯道、坡道,每个节点两个端口,做不了树状分流、环线或站场。4.一条网络只能一辆车。运力上限就是“一条线一辆”,也没有矿车连接或编组。5.没有分拣与过滤。漏斗不能“只收铁矿”,也不能按物品类型分流。6.没有时刻表。停车站只有“停”和“往返”,做不了“每 30 秒发一班”或“装满才走”。7.没有运输矿车(箱子矿车)。普通矿车不存货,想搬东西只能用漏斗矿车,而它只有 5 格。3.2 用起来会遇到的限制1.骑乘只能前后。摇杆左右不参与转向(也没有岔道可选),掉头靠倒车或停车站。2.骑乘时停车站失效。到站只停在站前,需要自己倒车离开;漏斗矿车停在「停止」模式的站前时,要把站台切到「往返」才会放行。3.漏斗只有 5 格,且没有白名单。一次搬不了太多,也不能只搬某一种物品。4.区块没加载时矿车冻结。跨区块长途运输在加载边界会有一次停顿(数据不丢,重新加载后从原进度继续)。5.漏斗矿车不能骑。这是刻意的:点按只打开库存,避免骑上去把物流线开走。3.3 工程与平台1.只有 Android,且绑定 SCAPI 1.9.5.1 与游戏 2.4.0.0。API 升级需要重新适配(部分内部字段是直接引用的)。2.多人未适配。首版按单人设计,没有做服务端与客户端同步。3.美术朴素。铁轨是贴地薄板,没有枕木和道钉;矿车是程序生成的双面几何,没有轮子动画。4.规模没验证。端到端验收覆盖的是单线、少量实体;几十辆车、上千格轨道的性能没有实测数据。5.界面只有中文。国际用户要么改代码,要么等翻译。6.没有真机自动化测试。逻辑层有单元测试和进程内验收兜底,但触屏手感只能靠人测。第 4 节 仓库里有什么· SCLogisticsMod/ —— 完整 C 工程(源码、Assets、工程文件),可直接编译 · SCLogisticsMod/bin/Debug/SCLogisticsMod.scmod —— 已编译打包的模组文件,可直接安装 · dist/SCLogisticsMod.scmod —— 同一份成品,交付副本第 5 节 构建方法需要 .NET 10 SDK(模板与游戏本体都使用 net10.0)。 安装 .NET 10 SDK(Linux/macOS) curl sSL https://dot.net/v1/dotnet install.sh | bash s channel 10.0 cd SCLogisticsMod dotnet build c Debug 产物:bin/Debug/SCLogisticsMod.scmod工程的 PostBuild 目标会自动把输出目录打包成 .scmod(modinfo.json 在根,资源在 Assets/)。依赖包来源写在 nuget.config 中(SurvivalcraftAPI.Survivalcraft 1.9.5.1),首次还原需要联网。第 6 节 安装1.把 SCLogisticsMod.scmod 放到 /storage/emulated/0/Survivalcraft2.4 API1.9/Mods(或在文件管理器里点开 .scmod 选择「生存战争 API 插件版」打开)。2.启动游戏,在模组管理里确认 SC Logistics 物流与高速熔炉 已启用。3.进入存档即可使用。模组带有「物流设置」页:漏斗吸取地面掉落物开关、漏斗转移周期(默认 8 游戏刻)、矿车速度(默认 8 格/秒)。第 7 节 内容与合成· 漏斗 HopperBlock —— 5 铁锭加 1 箱子(铁锭围一圈,中间箱子) · 矿车 MinecartBlock —— 5 铁锭(U 形) · 漏斗矿车 HopperMinecartBlock —— 1 矿车加 1 漏斗(竖排) · 铁轨 RailBlock —— 6 铁锭加 1 木棍,产出 16 段 · 停车站 StationBlock —— 4 铁锭加 2 木棍第 8 节 玩法8.1 漏斗· 5 格独立库存,随方块实体存档。右键漏斗可以打开它的 5 格库存界面。 · 漏斗有朝向(与 Minecraft 一致):出口永远朝向被你点击的那个方块。点在方块顶面,出口朝下;点在某个侧面,出口朝那个方向;点在地面,出口朝上(无意义,建议避免)。出口面贴图中心有蓝色六边形孔,玩家一眼就能看出它朝哪边。 · 放置优先于交互:手里拿着漏斗时,对着箱子或熔炉按放置键会直接放漏斗,不会打开容器;空手时右键容器仍然是正常打开。 · 每 8 游戏刻(约 0.4 秒)执行一次:只朝出口方向输出一件物品,再从上方容器拉取一件。输出端满了就保留物品等下一轮,不做多方向均匀分配。 · 从上方容器拉取时:普通容器任意槽位;熔炉只从成品槽或残留槽抽取。 · 向熔炉投料时严格遵守「输入区只占一个槽」:原版熔炉会把所有非空输入槽一起送进配方匹配,两个槽有东西就会打断炼制。因此漏斗的逻辑是:有同种物品只补那个槽;输入区全空只填 0 号槽;槽里是别的物品则不投;已经混料则暂停投料,等熔炉炼完。这样一条生产线可以长时间无人值守,不会因为「第二种矿物被塞进第二格」而停摆。 · 默认吸取上方一格内的地面掉落物(可在模组设置中全局关闭)。 · 破坏漏斗会掉落方块本身与全部库存(由游戏的方块实体流程完成)。8.2 铁轨· 数据位:bit0 1 为形状(直线、弯道、坡道),bit2 3 为朝向。 · 放置后形状自动推导:两侧相对为直线;两侧垂直为弯道;单侧平连且反方向上方有轨为坡道。 · 铁轨不可碰撞,玩家可以站上去或穿过去。 · 铁轨是薄板,不遮挡相邻方块:IsFaceTransparent 六个面都返回 true,所以贴着轨道放置的方块、轨道下方方块的顶面、上方方块的底面都会正常生成,不会出现「轨道四周一圈透明、能看到方块背后」的缺面。 · 拆除或放置轨道会触发网络重算;区块加载时通过 OnBlockGenerated 重建节点,区块卸载时清理节点。8.3 矿车· 矿车只能放在铁轨上:矿车物品的 IsPlaceable 固定为 false,对着地面或沙地使用只会提示「矿车必须放在铁轨上」,不会生成实体,更不会变成能被打飞的方块。 · 对着铁轨使用矿车物品生成实体;空车会自动沿线行驶。 · 普通矿车可骑乘,漏斗矿车不可骑乘:普通矿车的骑乘按钮照常出现;漏斗矿车模板里没有 Mount 组件,点按只会打开 5 格库存,行驶完全交给停车站逻辑。 · 骑乘时由玩家控制,且“往哪看就往哪走”:骑上普通矿车后自动行驶与停车站全部失效,推摇杆向上等于朝视线方向走、向下等于朝视线反方向倒车,松开即停;视线几乎与轨道垂直时沿用上一次的前后判断,不会左右乱跳。下车后矿车原地停下等你回来。 · 骑乘时视角完全自由、没有身后死角:骑乘期间由 SubsystemSCRiderView 接管视角,水平可连续转满 360°(含正后方),垂直正负 82°,灵敏度与走路一致;松开摇杆或手指时保持当前视角不动,下车时把残余偏航并入身体朝向,镜头不会突然弹回正前方。过弯时车体朝向按切线平滑跟随(15/s),镜头不会被猛甩 90°。注意原版 LookAngles 的 setter 会把偏航硬夹在正负 140°(这也是早期版本身后“约 60° 转不过去”的原因),骑乘时改为直接写 m lookAngles 字段并自己做 2π 归一化,绕开这个夹取。 · 漏斗矿车点击(交互键或触屏点按)打开 5 格库存界面;它不能被骑乘。 · 矿车是实心实体:有碰撞箱,玩家可以站在车上;TerrainCollidable 仍为 false,所以它只贴着轨道走,不会被地形顶飞。 · 模型是双面几何(每个面正反两份)加有厚度的车壁,任何角度都不会出现「像玻璃一样透明」的缺面;漏斗矿车在此基础上多一圈外扩的漏斗口。 · 一条连续铁路网络同一时间只允许一辆矿车,已占用时会提示「这条铁路已经有矿车了」。 · 经过漏斗或漏斗矿车卸货时不减速、不停车;没卸完的留在库存里,下次经过继续卸。 · 漏斗矿车(完整实现):5 格库存,每 0.05 秒(行驶中、停住时都算)依次执行三件事。第一,向下输出:轨道下方一格如果是漏斗、箱子或熔炉,就转入 1 件;第二,从上方容器抽取:上方一格是箱子或漏斗就直接抽,是熔炉只抽成品槽;第三,吸取掉落物:车身周围(水平 1.2 格、上方 1.6 格内)的地面物品自动装车。向熔炉输出时沿用普通漏斗的「输入区只占一个槽」规则,不会打断正在炼制的配方。 · 破坏矿车(攻击至血量归零)时,矿车本体加全部库存同时掉落,不会复制也不会丢失。 · 失去轨道就不再存在:脚下铁轨被拆掉时,矿车会把本体和库存掉在原地并移除实体,不会留下一个悬空、能被武器推着滑行、还能穿模的“幽灵车”。 · 区块未加载时矿车冻结,重新加载后从原进度继续。 · 撞到断头轨会停在格心;之后把轨道接上,它会自动继续行驶(停车站「停止模式」造成的停车需要玩家骑上去,或者把站台切到「往返」放行)。8.4 停车站· 放在铁轨末端,本身是轨道网络的一个节点(只有一个端口,自动朝向相邻铁轨)。 · 矿车不会开进站方块内部:到站时停在站台前方一格的铁轨中心,与方块保持一格距离。这样既不会穿模,也不会挡住站台正面的按钮,随时可以右键换模式。 · 右键切换模式。「停止」:矿车停在站前,等待玩家交互(骑上矿车即重新启动,启动方向自动背离站台)。「往返」:矿车到站前沿立即掉头沿原路返回。 · 刚把停车站放到末端时,停着的矿车不会被自动唤醒——先设好模式,再骑上矿车或交互启动。 · 两端可各放一个停车站、各自独立设置模式。 · 掉头或停止不改变漏斗矿车库存。8.5 高速熔炉阵列推荐布局(侧视,同一列)y+2 原料铁轨 漏斗矿车(原料)在此行驶 y+1 原料漏斗 矿车向下卸货 y+1 燃料铁轨 漏斗矿车(燃料)在此行驶(相邻一列) y0 燃料漏斗 矿车向下卸货(在熔炉背面那格) y0 原版熔炉 上方漏斗输入原料、背面漏斗输入燃料 y 1 成品漏斗 从熔炉成品槽抽取 y 2 成品箱要点· 原料与燃料是两条完全独立的铁路、两辆独立的漏斗矿车,互不同步。 · 上方漏斗把物品送入熔炉的熔炼输入槽;侧面漏斗送入时按物品类型分流:可燃物进燃料槽,其余进原料槽。(原版 ComponentFurnace 只暴露槽位、没有“面”的概念,所以用物品类型分槽才不会出现煤卡在原料槽的死锁。) · 熔炉成品槽满了以后不再产出,输入槽随后填满,漏斗自动跳过该熔炉,不会堵死整条铁路。 · 多台熔炉并排时,每台熔炉由自己上方的漏斗供货,漏斗的轮询让多台炉子都能拿到料。第 9 节 关键设计取舍· 转移规则“满则不转、不复制、不消失”:InventoryOps 先查容量,再写入,最后扣源,扣失败就回滚。 · 约 8 游戏刻一次转移:20 tick 每秒换算成秒,累加器调度,可在设置里改。 · 一条网络一辆车:端口连通性 BFS 划分网络,生成时做占用检查,合并时按 Entity.Id 仲裁。 · 断轨安全停止:端口未连接时矿车停在格心,绝不跨越或瞬移。 · 轨道类型不拆网络:网络只按端口连接关系划分,直线、弯道、坡道同属一网。 · 存档与区块:轨道节点由区块回调重建;矿车把 Cell、进度、方向、停止态写进实体存档。 · 停车站两端独立:模式存在方块数据的 bit2,随地形存档。 · 首版不做分岔、电压、过滤器:未实现,也未预留会误导的接口。