本帖最后由 不取了 于 2026-11-5 15:45 编辑
【原创框架 / 寻接手】势力争霸地面战扩展 —— 地表突击框架 (Surface Assault Framework)
“这不是一份完成品，是一份把位置钉好了的空架子。”
代码在哪、数据长什么样、几处接口各管什么，都已经定死；剩下的往里填。
如果你只想知道“这东西能跑吗”：现在不能。它没有任何逻辑，也一张贴图都没有。
一、 它想干什么？
远行星号里打地面战，现在的做法是弹个进度条、算个数。这个框架想给那一步换个样子：真让你看见一群人在打。
流程五步，其中四处是接口：
① 进入 -> ② 空降进场 -> ③ 地面交火 -> ④ 结算回写
Nexerelin 界面加按钮 -> 运输艇从天而降 -> 步兵/坦克/轰炸机 -> 存活/损失折算
拦下并改道 -> 火焰包裹、减速落地 -> 2D 掩体判定 -> 写回 Nexerelin
底线与原则：
[]不做完整的独立游戏：全部叠在现有战斗场景上。
[]不做室内战：2D 平面上摆几个区域当掩体，够用了。
[]不覆盖别人的资源：贴图只读检索，不往别人 mod 里写东西。
[]空降是一段过场，不是操作。
二、 现在有什么、没什么？
[]✅ mod_info.json：写好了，前置已声明。
[]✅ 目录结构：立好了。
[]✅ groundBattleDefs.json：结构完整，数值全是 null。
[]✅ strings.json：八条界面文字（中文）。
[]⚠️ data/scripts/ 下的 5 个 .java：空壳 + TODO 注释，一行逻辑都没有。
[]❌ jars/surface_assault.jar：不存在（所以故意没写 modPlugin）。
[]❌ graphics/ 贴图：一张都没有。
[]❌ 编译环境：没配。
三、 为什么空着？
不是因为懒。生成战斗逻辑这件事，写得出来不等于写得对——一个数值算错，玩家打完这一仗，存档里的陆战队就凭空少了三千人。这种东西放上去比空着危险。
所以这一版只做了一件事：把该占的位占住，把不该猜的地方标成 TODO。
四、 五个空壳分别该干什么？（都在 data/scripts/）
[]SurfaceAssaultCorePlugin.java：入口。负责注册改道的入口、持有全局状态、读配置、传结果。
[]GroundBattleCreationPlugin.java：接口①进入。拦下 Nexerelin 的界面，必须能退回原版，不能卡死玩家。
[]OrbitalDropPlugin.java：接口②空降。纯过场，建议写成状态机（下落-落地-卸兵-完成），别堆布尔标记。
[]BunkerOverlayPlugin.java：接口③掩体。每帧判区域，给减伤/惩罚。注意性能，别每帧 new 对象。- GroundBattleResultBridge.java：接口④结算。这一步写错会改坏存档！ 建议先做“只算不写”看日志，折算必须守恒。
五、 前置依赖（已声明）
（id 是从盘上逐个读出来的，没猜）
nexerelin / lw_lazylib / shaderLib (注意不叫GraphicsLib) / MagicLib / lunalib / BoxUtil
六、 接手建议顺序
[]先让它被认出来：进 mod 列表看报不报错（不需要 jar）。
[]解出接入点：从 ExerelinCore.jar 里看插件链，别照抄网上教程。
[]先写接口 ④：把数字算对写回对地方，打扎实了后面不会坏档。
[]然后空降，最后交火：空降是演出，先跑通“能进场能结束”的链条。
七、 贴图是目前最大的缺口
一张都没有。这一块可以单独拆出来给别人：步兵、悬浮坦克、轰炸机、掩体区域、空降舱、火焰尾迹、落地尘土、界面按钮。（只读、不覆盖别人资源，这条别破）
八、 去向
这个框架挂在谁名下都行：做成骤雨军事公司的拓展内容也好，做成势力争霸的扩展也好，甚至独立 mod 都行。
没有任何东西锁死方向，单位全是可替换的配置项。
九、 问 / 改 / 提
随便改，改坏了说一声就行。真要发补丁，附上“你改了哪一处、为什么”，比附一整包重写的文件有用得多。
🎁 附：赛博炼丹实录与个人吐槽
[spoiler=点击展开：大肥鱼冲浪与阿尔法鱼的诞生]
个人吐槽：
我绝对不会说的事情：检索信息忘记限速差点把中文论坛扫爆，后面经过教育引导，现已即时纠正，顺便对受到影响的各位进行（我非常的抱歉对于自己的大肥鱼的上网冲浪行为没有做出正确的引导方式）
（ps:家里的鱼写的，也包括这个说明内容）
关于确保自己的鱼用来了解游戏的运作方式：我把整个远行星号的文件包本体都喂了进去。
好消息是，鱼没死，甚至进化了（这玩意儿像个阿尔法核心）。
| 
发表于 
以及对于某些不爱看帖子简介直接下载文件的论友们，还有第二关在等着你
这一口贯穿星辰（打出仅基本壳子的成本）
发表于 
版版，改好了，顺便置顶了一个防呆）避免有人跳过了简介直接下载安装问题