本Mod为模组制作教程&模板类，请开启debug模式并在编辑器中打开文件夹以获得最佳体验。Mod中教程及提供工具仅供学习交流使用。
教程Mod中所含文件夹基本均有说明文档及模板，工具类均存放于tools文件夹中。
tips：由于HOIModEditor程序的特殊性，单独从
tools文件夹中独立出来。
制作mod所常用的文本编辑器有VS code（以下简称VSC）、PyCharm（以下简称PYC）与Notepad++（以下简称NP++）。
| 软件 | VS code | PyCharm | Notepad++ |
|---|---|---|---|
| 优点 | 插件较多、用户数量多 | 可通过嵌入提示快速了解信息，支持添加多个Mod进索引 | 轻量、无需插件和复杂配置 |
| 缺点 | 插件配置及上手难度较大 | 插件较少，有时语言解析会出现不明问题 | 功能有限，不适合大型项目开发 |
tips：使用本Mod的人员建议使用 PyCharm 以获取最佳开发体验。
- Chinese (Simplified) (简体中文) Language Pack for Visual Studio Code（VSC中文语言包）
- CWTools - Paradox Language Services（P社语言解析工具）
- VModer - HOI4 Language Server（CWTools扩展）
- HOI4 Mod Utilities（部分界面图形化预览工具）
- Paradox Language Support（P社语言解析工具）
- Translation（可与 Paradox Language Support 插件联动提供一些额外功能）
- 单击左侧Mod创建
- 按照提示输入的Mod的各项信息
- 完成后单击开始创建按钮，一个空白Mod便创建完毕。
- 打开启动器，单击左侧Mod 库。
- 单击上传 MOD按钮，点击创建 MOD。
- 名称处输入Mod名称，版本处输入Mod版本号，路径处输入想让Mod所处文件夹名称，标签处勾选符合Mod的标签。
- 完成后单击创建 MOD按钮，一个空白Mod便创建完毕。
新创建的Mod文件夹保存于路径%userprofile%\Documents\Paradox Interactive\Hearts of Iron IV\mod中，Mod文件夹名称为此前输入的路径。
使用VSC或PYC打开文件夹，并在插件中设置游戏本体文件夹路径。
- 点击左下角，打开设置，点击扩展。
- 找到钢四模组工具，在Install Path一栏输入游戏文件夹路径，在Mod File一栏输入模组定义文件（即
descriptor.mod文件）路径。 - 找到CWTools Configuration，在Cwtools > Cache: Hoi4一栏输入游戏文件夹路径。
- 找到VModer Configuration，在Game Root Path一栏输入游戏文件夹路径。
- 按下快捷键Ctrl+Alt+M，在游戏目录一栏输入游戏本地文件夹路径，或点击快速选择游戏目录自动寻找。
- 在模组依赖一栏添加其他Mod（可选，通常用于制作附属Mod时使用）。
等待索引完成，即可开始制作Mod。
descriptor.mod文件即模组定义文件，其中包含有Mod的各种信息。详细内容参考 descriptor.md 文件。
Mod封面文件，同时也是上传至Steam创意工坊的封面文件。
Mod文件夹结构与原版游戏基本相同，关于原版文件夹内容可参考本Mod中documentation\folder.html文件或此页面。
Mod中文件读取遵从下列条件：
- 当Mod文件与游戏本体文件不重复时，同时读取。
- 当Mod中部分文件与游戏本体文件重复，优先读取Mod中的文件。
- 当读取至
descriptor.mod文件中replace_path的文件夹时，跳过游戏本体中次文件夹，直接读取Mod中此文件夹。 - 当子Mod与主Mod文件重复时，优先读取子Mod中的文件。
debug模式是为了便于对游戏内数据进行各项测试的模式，可通过下列方式开启：
- 在Steam库中找到钢四，右键单击属性。
- 在通用中找到高级启动选项，输入
-debug。
- 找到游戏根目录，为
dowser.exe文件创建一个快捷方式。 - 右键单击快捷方式，打开属性。
- 在目标路径后面添加
-debug。
tips:注意此处是
" -debug"而非-debug，短横前方有空格！
debug模式与正常模式略有区别：
- 游戏主界面加载完成后将会自动使用记事本弹出
error.log文件。 - 在主界面按下
~键将会显示gui边框，游戏中需通过控制台输入gui来打开。 - 显示gui边框时按住
Ctrl+Alt+鼠标右键可以对gui进行打开文件、查看路径以及刷新操作。 - 本地化等修改可热更新（新建文件除外）。
- 多人模式将禁用。
日志文件位于%userprofile%\Documents\Paradox Interactive\Hearts of Iron IV\logs中，其中error.log与game.log两个文件最为常用。
通常情况下，当游戏出现错误时，错误信息会被记录在error.log文件中；game.log一般记录的是游戏运行时的日志（如log = xx此类效果的记录）。
当游戏出现严重错误甚至崩溃时，查看日志能够更有效地排查出错误原因。
tips：某些错误可能在崩溃前来不及被记录，甚至根本不会被记录。