钢铁洪流 · MOD 制作教程

本手册是《钢铁洪流》RTS 游戏 MOD 系统（gsdzmod 框架）的完整制作教程，从零开始讲解如何制作、打包、上传、启用一个 MOD。风格仿照 Windows CHM 帮助文件，左侧为可折叠目录树，支持索引与全文搜索。

本教程适用对象

想为《钢铁洪流》添加新单位、新建筑、新武器、新国家的制作爱好者；
想制作自定义战役地图并打包进 MOD 的玩家；
想替换单位/建筑贴图（PNG）或使用 .r 脚本素材的进阶制作者。

快速开始（30 秒版）

准备一个文件夹，内含：mod.ini（必须）+ 可选的 units.ini / buildings.ini / weapons.ini / factions.ini / art.ini / campaigns.ini，以及 res/、map/ 子文件夹；
把整个文件夹压缩成 zip，把扩展名改为 .gsdzmod；
进入游戏主菜单 → M O D → 导入 .gsdzmod → 启用该 MOD；
回到主菜单 → 单机模式，即可看到新内容生效。

提示：MOD 数据文件与贴图或.r文件 其版权等 由创作者所有，任何非官方自然人不得未经允许不得侵权。

目录导航

章节	内容	难度
一、入门与打包	什么是 MOD、目录结构、打包流程	★
二、mod.ini 清单	mod.ini 元数据与引用文件字段	★★
三、单位	units.ini 单位代码讲解	★★★
三、建筑	buildings.ini 建筑代码讲解	★★★
四、武器	weapons.ini 武器代码讲解	★★★
四、国家	factions.ini 国家/阵营代码	★★
五、美术	art.ini 与 PNG 素材引用	★★
五、.r 素材	.r 脚本素材格式（多素材/绘制指令）	★★★
六、战役地图	campaigns.ini + map/ 地图文件	★★★
七、上传启用	上传、启用/停用、热切换、卸载	★
七、FAQ	常见问题与排错	★

示例 MOD 目录结构

my_mod/
├── mod.ini                 ← 必须！说明 mod 名称与引用哪些文件
├── units.ini               ← 新增单位（可选）
├── buildings.ini           ← 新增建筑（可选）
├── weapons.ini             ← 新增武器（可选）
├── factions.ini            ← 新增国家（可选）
├── art.ini                 ← PNG 素材配置（可选）
├── campaigns.ini           ← 战役地图清单（可选）
├── res/                    ← 素材文件夹
│   ├── myTank.png          ← PNG 素材（文件名=素材名）
│   └── myTank.r            ← .r 脚本素材（可含多个素材）
└── map/                    ← 战役地图文件夹
    └── myMission.json      ← 战役地图 JSON

如何开始制作 MOD →