This project is no longer maintained; please use HisenWeb/IronNestFCS-Smart instead.

IronNestFCS

Demo Video

Iron Nest: Heavy Turret Simulator 的 MelonLoader Mod，为游戏中的重型炮塔加入一套自动化火控系统（Fire Control System, FCS）：在地图上点选目标，Mod 会自动解算弹道、采购/装填炮弹、调整炮塔方向与仰角，并完成确认与击发的全套流程。

基于游戏 Demo 版本开发，使用 IL2CPP + MelonLoader。

安装教程

本教程假设你只有一款原版游戏，没装过任何 Mod。按顺序一步步做，不用懂任何技术。

第 0 步：确认你有一款能正常玩的游戏

1. 打开 Steam，在游戏库里找到 Iron Nest: Heavy Turret Simulator
2. 先正常启动一次，确认游戏能打开、能进入关卡——确保游戏本身没问题，再开始装 Mod
3. 关掉游戏

第 1 步：下载 MelonLoader

MelonLoader 是运行本 Mod 必需的前置工具（所有 MelonLoader Mod 都要它）。

1. 打开浏览器，访问 MelonLoader 官方下载页：

   https://github.com/LavaGang/MelonLoader/releases/latest

2. 在页面的下载列表里找到 MelonLoader.Installer.exe（Windows 安装器），点击下载

   • 认准文件名里有 Installer 的那个，别下错

3. 如果浏览器/系统提示"此文件可能有风险"，选择 保留 / 仍然下载——游戏 Mod 工具经常被安全软件误报，这是正常现象

4. 下载完成后，文件应该在你电脑的"下载"文件夹里

第 2 步：安装 MelonLoader

1. 双击运行 MelonLoader.Installer.exe
2. 在安装器界面里选择游戏 Iron Nest: Heavy Turret Simulator
   • 如果列表里找不到，点 Browse / 浏览，手动选择游戏根目录
   • 游戏根目录怎么找？Steam 库 → 右键游戏 → 管理 → 浏览本地文件，弹出的窗口就是
3. 点击 Install / 安装，等待它跑完
4. 验证是否装好：打开游戏根目录，应该能看到一个 MelonLoader 文件夹——看到了就是装好了

第 3 步：下载本 Mod

1. 打开本仓库的 Releases 发布页：Releases
2. 下载 IronNestFCS_v1.0.7.zip（火控，必装）
3. （可选）如果你还想用"自定义唱片机"，再下载 CustomRecords_v1.0.2.zip
4. 解压你下载的 zip（右键 → 全部解压缩），得到文件夹

第 4 步：把 Mod 装进游戏（重点，仔细看）

1. 打开解压出来的文件夹，里面应该有 Mods、UserData、UserLibs 三个文件夹（唱片机的压缩包打开后先进入里面的 CustomRecords 文件夹，也能看到这三个）
2. 打开游戏根目录（Steam 库 → 右键游戏 → 管理 → 浏览本地文件）
3. 把解压出来的 Mods、UserData、UserLibs 三个文件夹，一个一个地、整个拖进游戏根目录
   • ⚠️ 注意：拖的是文件夹本身，不是打开文件夹去拖里面的文件
   • 如果弹出"目标文件夹已存在，是否合并/替换？"→ 选 是 / 合并
   • 没弹窗也正常，直接放进去就行
4. 放完后，游戏根目录里应该同时有 Mods、UserData、UserLibs 这三个文件夹（不是三个子文件夹里的东西，是三个文件夹本身）
5. 如果你还下载了唱片机压缩包，用同样的方式把它的三个文件夹也拖进去

第 5 步：（可选）放入你自己的音乐

自定义唱片机需要音乐文件才能生效：

1. 打开游戏根目录 → UserData → CustomRecords 文件夹（第一次装可能还没有，自己新建一个也行）
2. 把你的 .mp3 / .wav / .flac 音乐文件放进去
3. （可选）给每首歌配一张封面：把同名图片（.png / .jpg / .jpeg）放在旁边，例如 song.mp3 配 song.png

第 6 步：启动游戏，检查是否成功

1. 从 Steam 正常启动游戏
2. 如果 MelonLoader 装好了，启动时屏幕上会弹出一个黑色控制台窗口——别关它，那是正常现象
3. 进入有炮塔和地图桌的关卡
4. 如果游戏画面左上角出现火控状态面板，说明安装成功 🎉
   • 如果面板提示 Dial 未绑定，按键盘 F9 重新绑定即可
5. 使用步骤见下文"使用"章节

功能

• 一键打击：点击地图上的炮兵目标（T1~T4），自动为其下达一次完整的打击任务。
• 双炮管任务调度：任务进入队列后由调度器自动派给空闲炮管，一管炮打完一发自动拉取下一个任务，两管炮并行作业。
• 自动弹道解算：读取目标的方向角与距离，自动设定装药、弹种并解算所需仰角。
• 多弹种支持：AP / HCHE / HE / STAR / SMK，可在面板上选择当前弹种；弹仓缺弹时自动到采购台购买。
• 自动击发（可选）：通过面板上的 Auto Fire 开关切换是手动还是自动完成最后的击发动作。
• 状态面板：IMGUI 窗口实时显示两管炮的当前任务、目标参数与待派发任务数。
• 热重载开发：火控逻辑独立成可卸载的程序集，开发时改完代码按 F9 即可在不重启游戏的情况下重新加载。
• 自定义唱片机（附带的独立 Mod）：把 UserData/CustomRecords/ 下的音频文件（.mp3 / .wav / .flac，封面取同名图片或内嵌封面）自动克隆成场景内的 RecordDisk，换上合成封面与音轨。

架构

工程拆分为四个程序集，核心是为热重载服务的宿主 / 逻辑分离设计：

项目	角色	说明
IronNestFCS	宿主 Mod	稳定加载、永不重载。负责首次加载 Logic、监听 F9 触发热重载、转发生命周期回调。
IronNestFCS.Abstractions	契约	仅含 IFcsModule 接口。只加载一份，是唯一能安全跨 AssemblyLoadContext 边界传递的类型。
IronNestFCS.Logic	火控逻辑	所有高频改动的火控代码：弹道解算、任务调度、炮塔/炮管操控、UI。被装进可回收的 ALC，按 F9 卸载并重载。
IronNestFCS.CustomRecords	独立 Mod	与火控无关的场景装饰，扫描 UserData/CustomRecords/ 下的音频文件，为每个文件克隆一张 RecordDisk 并替换音轨与封面。

热重载的关键点：Logic 程序集从内存字节加载（不锁住磁盘 dll），装进 isCollectible 的 AssemblyLoadContext；重载时先 Shutdown（撤销 Harmony 补丁、停止协程、清空 IL2CPP 引用）再卸载旧 ALC，最后从磁盘重新加载新版本。详见 LogicReloader.cs 与 FSC.cs 中的注释。

构建与安装

前置条件

• 已安装 .NET 6 SDK（见 global.json）。
• 游戏本体，并已为其安装 MelonLoader（IL2CPP）。

配置游戏路径

各 .csproj 通过 GameDir 属性定位游戏目录下的 MelonLoader 程序集。请把以下三个文件里的 GameDir 改成你本机的游戏安装路径：

• IronNestFCS/IronNestFCS.csproj
• IronNestFCS.Logic/IronNestFCS.Logic.csproj
• IronNestFCS.CustomRecords/IronNestFCS.CustomRecords.csproj

<GameDir>你的路径\Iron Nest Heavy Turret Simulator</GameDir>

构建

dotnet build IronNestFCS.sln -c Release

各程序集的输出位置：

• 宿主 Mod（IronNestFCS.dll）：放入游戏的 Mods/ 目录，由 MelonLoader 自动加载。
• 火控逻辑（IronNestFCS.Logic.dll）：输出到 UserData/IronNestFCS/（不放进 Mods/，由宿主在运行时反射加载）。
• 契约（IronNestFCS.Abstractions.dll）：放入 UserLibs/，确保宿主与逻辑共用同一份接口。
• 自定义唱片机（IronNestFCS.CustomRecords.dll）：放入 Mods/。把音频文件（.mp3 / .wav / .flac）放入游戏的 UserData/CustomRecords/ 目录，封面两种方式任选：① 同名图片文件（song.mp3 配 song.png/.jpg/.jpeg，音频与图片分开存放）；② 音频文件内嵌封面（TagLib 标签）。进场景后自动为每个文件克隆一张 RecordDisk；两种封面都没有的文件会被跳过。目录不存在时首次运行会自动创建，无需手工准备素材。构建时依赖（CSCore、TagLibSharp）会自动拷贝到 UserLibs/（不能留在 Mods/，否则会被 MelonLoader 误当作 Mod 加载）。

IronNestFCS.Logic.csproj 默认已把 OutputPath 指向 $(GameDir)\UserData\IronNestFCS\，构建即就位，改完代码进游戏按 F9 即可生效。

使用

1. 启动已安装 MelonLoader 与本 Mod 的游戏。
2. 进入包含炮塔与地图桌的关卡场景。若火控面板提示 Dial 未绑定，按 F9 在当前场景重新绑定。
3. 在控制台旁的按钮上选择弹种（默认 HE），并按需开启 Auto Fire。
4. 拖动地图上的目标标记 (1~4) 到目标位置。
5. 点击地图右侧的目标按钮（T1~T4）下达打击任务，Mod 会自动完成解算、装填、瞄准与击发。
6. 左上角面板实时显示两管炮的任务进度与队列情况。

开发热重载

修改 IronNestFCS.Logic 内的代码后，重新构建该项目（dll 会直接输出到游戏的 UserData/IronNestFCS/），切回游戏按 F9 即可加载新逻辑，无需重启游戏。

贡献

欢迎提交 Issue 和 Pull Request。

• 发现 Bug、有功能建议或疑问，请提交 Issue。
• 改进代码请提交 Pull Request。改动火控逻辑时请留意 FSC.cs 中关于热重载与协程的约定（不要在 Logic 中注册新的 IL2CPP 类型、协程必须登记以便卸载时停止、跨 ALC 只能传递 IFcsModule）。

免责声明

本项目为非官方的第三方 Mod，与游戏开发商无关。仅供学习与单机娱乐使用，使用风险自负。