模组文件结构：修订间差异

2020年11月23日 (一) 00:45的版本

模组文件结构

本地模组

本地模组必须位于~/.local/share/Paradox Interactive/Hearts of Iron IV/mod或C:\Users\<Username>\Documents\Paradox Interactive\Hearts of Iron IV\mod，应该包括：

'.mod'文件，它告诉启动器如何处理模组文件夹。（文件名没有特殊要求，仅本地模组需要，当上传到steam创意工坊时该文件不会上传）
模组文件夹或者包含模组数据的压缩文件。模组数据要与游戏文件有相同的文件结构。
descriptor.mod文件在模组文件夹内部——它应当包含与上面的 .mod 文件相同的信息。（注意：文件名必须为 descriptor.mod，且不能用 UTF-8 BOM 编码储存）
模组图片（可选） - 模组文件夹中命名为 thumbnail.png 的文件, 起到 Steam 创意工坊模组图片的作用。（注意：必须使用 .png 格式并命名为 'thumbnail.png';尺寸不重要，但应该按照 1:1 的比率。）

游戏启动器的模组配置工具可以自动创建基本的文件结构。前往Mods 标签页，然后点击Mod 工具和创建 Mod。注意文件夹和文件的名字在 macOS 和 Linux 上大小写敏感。

Steam 工坊模组

从 steam 创意工坊订阅和下载的模组位于.../Paradox Interactive/Hearts of Iron IV/workshop/content/394360或在某些情况下位于...\SteamLibrary\steamapps\workshop\content\394360

从 Steam 创意工坊下载的模组与手动安装或创建的模组其处理方式有所差异：
虽然模组的 .mod 文件会出现在模组文件夹（表示为remote_file_id），但是模组的内容被存储在...\Paradox\Hearts of Iron IV\workshop\content\<remote_file_id>
remote_file_id是创意工坊给予模组的一个标识。这个标识被用来表示模组 .mod 和 zip 文件的名字，但在 .mod 和 descriptor.mod 文件中是这样表示的：

name="New Ideologies"
archive="workshop/content/281990/678893824/newideologies.zip"
tags={
	"Balance"
	"Gameplay"
}
remote_file_id="678893824"
supported_version="1.0.0.19987"

注意：从游戏 1.9.0 开始，新创建的模组不再存储在 .zip 压缩包中

创建一个模组

总原则

修改游戏的模组的文件结构应与原版游戏保持一致。
文件夹中找到的所有文件都会被游戏加载。
所有 .txt 文件都应使用 UTF-8 without BOM 的格式，本地化（localisation）文件都应该使用 UTF-8 BOM 的格式。
要覆盖原版文件，使用相同的文件名。
要添加新内容同时不改变任何原版文件，使用一个不同的文件名。
游戏除文件目录的变化外不会作进一步的变化检查。如果想在文本文件里新添一行，则需要复制整个文本文件后再在复制后的文件里添加。

创建简单的本地模组

例如，要创建一个名为“Test1”的模组，则要在...\Paradox\Hearts of Iron IV\mod目录下新建一个名为test1.mod的文本文件和名为'test1'的文件夹。

test1.mod的内容应该与下述一致：

name="Test1"
path="mod/test1"
tags={
	"Alternative History"
}
picture="thumbnail.png"
supported_version="1.5.4"

这样做是为了给游戏启动器提供模组的信息。包括了模组的名称、位置（来自 mod 文件）、标签（额外的描述符）、图片名称和支持的游戏版本。

创建次级模组

有时你会想你的模组能依赖其他模组，并且按照一定的加载顺序。模组通常会按字母顺序加载（所以列表中最后一个模组会覆盖前面的模组）。但是有些东西可能会影响这点，所以如果你需要一个特定的加载顺序，确保你写明了依赖关系，这需要在 .mod 文件的 "dependencies" 下写出其全名来指定。

name="testmodB"
path="mod/testmodb/"

# this guarantees we load testmodA first before our testmodB is loaded
dependencies= { 
	"testmodA" 
}
supported_version="1.5.2"

增加模组内容

例如，一个简单的修改就可以改变游戏中显示的文本。

要改变加载界面中出现的名人名言，请把游戏原版文件，“.../Hearts of Iron IV/localisation/loading_tips_I_english.yml”，中的“localisation/loading_tips_I_english.yml”文件复制到你新创建的“mod/test1”文件夹下的“localisation”文件夹。

文件结构现在看起来应如下所示：

 ...\Paradox Interactive\Hearts of Iron IV\mod
     test1.mod
     test1 (dir)
       localisation (dir)
         loading_tips_I_english.yml

当“loading_tips_I_english.yml”未被改变时，游戏将会像往常一样正常运行。但是如果改变了，游戏就会使用新内容而不是惯常的“loading_tips_I_english.yml”。修改模组文件夹中的“loading_tips_I_english.yml”文件，让它包含这些内容：

 l_english:
  LOADING_TIP_0:0 "Test1 mod"

当游戏加载这个模组并以英文运行时，唯一显示的名人名言就会是这句“Test1 mod”。

小提示

要准确理解代码中的东西是怎么工作的，查看游戏文件以及搜索你的模组会改变什么东西等类似的事会很有帮助
另外，你可以在...\steamapps\workshop\content\394360下搜索其他用户模组的文件
尽量减少对原版文件的覆盖，这样你在管理模组让它与最新版游戏保持一致，并且减少与其他模组的冲突时都会更方便一些
测试模组时，查看...\Documents\Paradox Interactive\Hearts of Iron IV\logs\error.log下的错误日志很有帮助，这能让你在有些东西不起作用时得到相关线索。

参见

根据你的模组要做什么，你可能会想浏览一些与部分更基础的游戏内容修改相关的页面：

Country creation - 如何创建一个新的国家，指定国旗，添加新国家到游戏里
National Focus modding - 如何修改国策树
Idea modding - 如何添加/修改国家理念
Event modding - 如何添加/修改事件

模组制作

文件	效果 • 条件 • 定义 • 修正 • 修正列表 • 作用域 • 本地化 • on action • 数据结构 (标记, 临时标记, 国家别名, 变量, 数组)

脚本	成就修改 • AI修改 • AI focuses • 自治领修改 • 权力平衡修改 • 剧本/标签 (游戏规则)• 建筑修改 • 人物修改 • 修饰性TAG修改 • 国家创建 • 军队修改 • 决议制作 • 装备修改 • 事件修改 • Idea修改 • 意识形态修改 • 军工商修改 • 国策制作 • 资源修改 • Scripted GUI • 科技制作 • 单位修改

地图	地图 • 省份 • 补给区域 • 战略区域

图形图像	界面 • 图形资产 • 实体模型 • 后期特效 • 离子效果 • 字体

装饰性	肖像 • 命名列表 • 音乐 • 音效

其他	控制台指令 • 故障排除 • 模组结构 • 成就代码分析 • Mod相关 • Nudger修改

@@ 第6行： / 第6行： @@
 * ''' '.mod'文件'''，它告诉启动器如何处理模组文件夹。（文件名没有特殊要求，仅本地模组需要，当上传到steam创意工坊时该文件不会上传）
 * '''模组文件夹'''或者包含模组数据的压缩文件。模组数据要与游戏文件有相同的[[#Game structure|文件结构]]。
-* '''descriptor.mod文件'''在模组文件夹内部——它应当包含与上面的.mod文件相同的信息。（注意：文件名必须 为descriptor.mod，且不能 用UTF-8 BOM编码储存）
+* '''descriptor.mod文件'''在模组文件夹内部——它应当包含与上面的 .mod  文件相同的信息。（注意：文件名必须 为 descriptor.mod，且不能 用 UTF-8 BOM  编码储存）
-* 模组图片 （可选） - a file named '''thumbnail.png''' in the mod folder, to serve as Steam Workshop mod picture (Note: Must use .png format and 'thumbnail.png' name; dimensions aren't important, but should be 1:1 ratio)
+* 模组图片 （可选） - 模组文件夹中命名为 '''thumbnail.png''' 的文件, 起到 Steam 创意工坊模组图片的作用。（注意：必须使用 .png 格式并命名为 'thumbnail.png'; 尺寸不重要，但应该按照 1:1 的比率。）
-The game launcher's mod config tool '''can create basic structure automatically'''. Just go to ''Mods'' tab, then click ''Mod Tools'' and ''Create Mod''.
+游戏启动器的模组配置工具''' 可以自动创建基本的文件结构''' 。前往''Mods'' 标签页，然后点击''Mod 工具'' 和'' 创建 Mod'' 。
-Note that folder and file names are case sensitive on Mac OS X and Linux.
+注意文件夹和文件的名字在 macOS 和 Linux 上大小写敏感。
-===Steam工坊模组===
+===Steam  工坊模组===
-Subscribed and downloaded mods from the steam workshop are in <code>.../Paradox Interactive/Hearts of Iron IV/workshop/content/394360</code> or sometimes <code>...\SteamLibrary\steamapps\workshop\content\394360</code>
+从 steam 创意工坊订阅和下载的模组位于<code>.../Paradox Interactive/Hearts of Iron IV/workshop/content/394360</code> 或在某些情况下位于<code>...\SteamLibrary\steamapps\workshop\content\394360</code>
-Mods downloaded from the Steam Workshop are treated differently than those manually installed or created:<br />
+从 Steam 创意工坊下载的模组与手动安装或创建的模组其处理方式有所差异：<br />
-Though the mods .mod files will appear in the mod folder (represented by a ''remote_file_id''), The content of the mod will be stored in <code>...\Paradox\Hearts of Iron IV\workshop\content\394360\<remote_file_id></code><br />
+虽然模组的 .mod 文件会出现在模组文件夹（表示为''remote_file_id'' ），但是模组的内容被存储在<code>...\Paradox\Hearts of Iron IV\workshop\content\<remote_file_id></code><br />
-The ''remote_file_id'' is an ID given to mods from the workshop. The ID is displayed as the name of the mod's .mod and zip files, but is further represented within the .mod and descriptor.mod files as such:
+''remote_file_id'' 是创意工坊给予模组的一个标识。这个标识被用来表示模组 .mod 和 zip 文件的名字，但在 .mod 和 descriptor.mod 文件中是这样表示的：
   name="New Ideologies"
@@ 第28行： / 第28行： @@
   remote_file_id="678893824"
   supported_version="1.0.0.19987"
-'''Note:''' Newer mods, starting with game version 1.9.0 are no longer stored in a .zip archive
+''' 注意：''' 从游戏 1.9.0 开始，新创建的模组不再存储在 .zip 压缩包中
 ==创建一个模组==
 ===总原则===
-*Mods modify the game with the same file structure as in the vanilla game.
+* 修改游戏的模组的文件结构应与原版游戏保持一致。
-*All appropriate files found in the folder are loaded
+* 文件夹中找到的所有文件都会被游戏加载。
-*All .txt files should use UTF-8 without BOM format, Localisation files should use UTF-8 BOM Format
+* 所有 .txt 文件都应使用 UTF-8 without BOM 的格式，本地化（localisation）文件都应该使用 UTF-8 BOM 的格式。
-*To overwrite vanilla file, use the same file name
+* 要覆盖原版文件，使用相同的文件名。
-*To add content without changing any vanilla files, use a different file name
+* 要添加新内容同时不改变任何原版文件，使用一个不同的文件名。
-*The Game will not check any further than the file directory for changes. If one is trying to add a line to a text file, one must copy the entire text file and add the line within said text file.
+* 游戏除文件目录的变化外不会作进一步的变化检查。如果想在文本文件里新添一行，则需要复制整个文本文件后再在复制后的文件里添加。
 ===创建简单的本地模组===
-For example, to create a mod called "Test1", create a new text file called ''test1.mod'' and a folder named 'test1' within <code>...\Paradox\Hearts of Iron IV\mod</code>.
+例如，要创建一个名为“Test1”的模组，则要在<code>...\Paradox\Hearts of Iron IV\mod</code> 目录下新建一个名为''test1.mod''的文本文件和名为'test1'的文件夹。
+''test1.mod''的内容应该与下述一致：
-The contents of ''test1.mod'' should be as follows:
   name="Test1"
   path="mod/test1"
@@ 第53行： / 第53行： @@
   supported_version="1.5.4"
-This is done to provide the game launcher with information about the mod. This includes the mod's name, location (from the mod file), tags (extra descriptors), picture name, and supported game version.
+这样做是为了给游戏启动器提供模组的信息。包括了模组的名称、位置（来自 mod 文件）、标签（额外的描述符）、图片名称和支持的游戏版本。
 ===创建次级模组===
-Sometimes you will want your mod to depend on other mods, and also require a certain loading order. Mods will usually load in alphabetical order (so the mod last in the list will overwrite the earlier). But some things may affect this so if you need a certain load order and be clear that you have dependencies this needs to be specified by including its full name in the .mod file under "dependencies".
+有时你会想你的模组能依赖其他模组，并且按照一定的加载顺序。模组通常会按字母顺序加载（所以列表中最后一个模组会覆盖前面的模组）。但是有些东西可能会影响这点，所以如果你需要一个特定的加载顺序，确保你写明了依赖关系，这需要在 .mod 文件的 "dependencies" 下写出其全名来指定。
   name="testmodB"
@@ 第67行： / 第67行： @@
 ==增加模组内容==
-For example, a simple modification could be changing the text that appears in the game.
+例如，一个简单的修改就可以改变游戏中显示的文本。
-To change the quotes that appear in the loading screen, copy the "localisation/loading_tips_I_english.yml" file from the base install of the game, ".../Hearts of Iron IV/localisation/loading_tips_I_english.yml" to a "localisation" folder you create in the new "mod/test1" folder.
+要改变加载界面中出现的名人名言，请把游戏原版文件，“.../Hearts of Iron IV/localisation/loading_tips_I_english.yml ”，中的“localisation/loading_tips_I_english.yml”文件复制到你新创建的“mod/test1 ”文件夹下的“localisation”文件夹。
-The file structure now looks like the following:
+文件结构现在看起来应如下所示：
    ''...\Paradox Interactive\Hearts of Iron IV\mod''
@@ 第79行： / 第79行： @@
        loading_tips_I_english.yml
-As "loading_tips_I_english.yml" is unaltered, the game will run the same as usual. However, if it is changed, the information will be used by the game instead of the usual "loading_tips_I_english.yml". Modify the "loading_tips_I_english.yml" file in the mod folder so that it contains this:
+当“loading_tips_I_english.yml ”未被改变时，游戏将会像往常一样正常运行。但是如果改变了，游戏就会使用新内容而不是惯常的“loading_tips_I_english.yml ”。修改模组文件夹中的“loading_tips_I_english.yml ”文件，让它包含这些内容：
    l_english:
     LOADING_TIP_0:0 "Test1 mod"
-When the game is loading with this mod active in the English language, the only quote shown will be "Test1 mod".
+当游戏加载这个模组并以英文运行时，唯一显示的名人名言就会是这句“Test1 mod ”。
 ==小提示==
-*To understand how certain things in the code work, it can be useful to look into game files and search for things similar to what your mod is supposed to change
+* 要准确理解代码中的东西是怎么工作的，查看游戏文件以及搜索你的模组会改变什么东西等类似的事会很有帮助
-*Alternatively, you can search the files of other users' mods in <code>...\steamapps\workshop\content\394360</code>
+* 另外，你可以在<code>...\steamapps\workshop\content\394360</code> 下搜索其他用户模组的文件
-*Try to minimize vanilla file overwrites, this will make it both easier for you to manage your mod content to keep it up to date, and reduce risk of conflict with other mods
+* 尽量减少对原版文件的覆盖，这样你在管理模组让它与最新版游戏保持一致，并且减少与其他模组的冲突时都会更方便一些
-*When testing the mod, it can be very useful to look into Error log <code>...\Documents\Paradox Interactive\Hearts of Iron IV\logs\error.log</code> to gain a clue when something isn't working
+* 测试模组时，查看<code>...\Documents\Paradox Interactive\Hearts of Iron IV\logs\error.log</code> 下的错误日志很有帮助，这能让你在有些东西不起作用时得到相关线索。
 ==参见==
-Depending on what your mod is supposed to do, you may want to visit some of these pages relating to some more basic game content modding:
+根据你的模组要做什么，你可能会想浏览一些与部分更基础的游戏内容修改相关的页面：
-* [[Country creation]] - How to create a new country, assign flag, place the new country into the game
+* [[Country creation]] - 如何创建一个新的国家，指定国旗，添加新国家到游戏里
-* [[National Focus modding]] - How to edit National Focus tree
+* [[National Focus modding]] - 如何修改国策树
-* [[Idea modding]] - How to add/edit National Ideas
+* [[Idea modding]] - 如何添加/ 修改国家理念
-* [[Event modding]] - How to add/edit an Event
+* [[Event modding]] - 如何添加/ 修改事件
 {{Modding navbox}}
 [[Category:Modding]]