讨论

编辑“模组结构”

警告：您没有登录。如果您做出任意编辑，您的IP地址将会公开可见。如果您登录或创建一个账户，您的编辑将归属于您的用户名，且将享受其他好处。

该编辑可以被撤销。 请检查下面的对比以核实您想要撤销的内容，然后发布下面的更改以完成撤销。

最后版本 您的文本
第1行： 第1行：
{{version|1.1}}{{需要翻译}}
{{需要翻译}}
Mods文件 位于 ''~\Paradox Interactive\Crusader Kings III\mod''  文件夹中
Mod 位于 该路径下 ''~\Paradox Interactive\Crusader Kings III\mod'', 里面必须包含:
* Windows下的默认路径： {{cite file|%USERPROFILE%\Documents\Paradox Interactive\Crusader Kings III\mod}}
* Linux下的默认路径： {{cite file|~/.local/share/Paradox Interactive/Crusader Kings III/mod}}
每个mod需要两个部分：


* 一个<code>.mod</code>后缀的纯 文 本 文件 ，包含使用该mod所需的元数据
* 一个 *.mod 文 件, 用于告诉启动器如何处理mod 文件 夹
 
* mod 文件夹或 者是压缩包 包含 了mod的数据。mod数据必须和 游戏 本体中 CK2game.exe 所在路径 的 文 件和文件夹 架构一致 。注意文件和文件 夹 名 称 在Mac和Linux 系统 上 需要 区分大小写。
* 一个mod 文件夹 （ 或<code>.zip</code>文件）， 包含 此mod对 游戏的 修改内容，如事 件 、图像、决议 和 角色
 
两部分都必须位于上面的 文件夹 中，并且共享相同的名称，但文件扩展名除外；否则，游戏启动器将无法识别mod 。 请 注意 ， 文件 夹 和文件名在Mac和Linux上 是 区分大小写 的。
 
== 创建初始文件 ==
 
为了更为便捷以及避免人为错误，建议通过游戏启动器生成初始mod文件。
 
# 打开游戏启动器。
# 通过滚动或按“开始游戏”按钮下的 "Mod "标签，导航到 "Mods "部分。
# 点击"Mod工具 "按钮。
# 点击 "创建mod "按钮。
# 在这里，你可以创建你的mod，包括名称、版本（mod版本，而非游戏）、目录（将始终位于上述游戏的mod文件夹中）和任意标签。启动器提供的标签包括：
 
{| class="wikitable"
|-
| Alternative History || Historical
|-
| Balance || [[Map modding|Map]]
|-
| [[Bookmarks modding|Bookmarks]] || Portraits
|-
| Character Focuses || [[Religion modding|Religion]]
|-
| Character Interactions || Schemes
|-
| [[Culture modding|Culture]] || [[Sound modding|Sound]]
|-
| [[Decision modding|Decisions]] || Total Conversion
|-
| [[Event modding|Events]] || [[Localization|Translation]]
|-
| Fixes || Utilities
|-
| Gameplay || Warfare
|-
| Graphics
|}
 
也可以通过回到 "Mod工具 "菜单，然后在下拉列表中选择你的mod来更改建议的游戏版本、缩略图和描述（显示在创意工坊里）。
 
这个过程将创建以下内容。
* mod文件夹，以你的mod命名。
* 一个descriptor.mod文件，包含在mod文件夹内。
* 另一个.mod文件，这个文件以mod命名，位于mod文件夹旁边 。


== *.mod 文件 ==
== *.mod 文件 ==


  游戏 使 用的.mod 文件 是纯文本文件， 其 中包含了相应mod 的 元数据。每个mod都有两个.mod文件。
  注意： 使 用Crusader Kings III启动器，您可以通过导航到 <Mods> -> <Mod Tools (Next to Manage Mods)> -> <Create Mod> 并键入以下内容来生成mod 文件 夹及 其 对应 的* .mod文件。 相应 的 名称，版本 ， 版本兼容性 ， 图标 ， 标签和mod 文件夹 目录/存档 。 由于以这种方式开始创建mod容易得多，因此强烈 建议 您首先进 行 此操作 ， 然后根据 需要 对* .mod 文件 进行更改。
* (modname).mod ，位于mod的 文件 夹旁边 。 这个是必须 的， 没有它 ， 启动器将无法识别mod。
* descriptor.mod ， 位于mod 文件夹 内 。建议 这个文件和其他文件保持一致，删除文件中包含path键的 行， 因为这一行并不 需要 出现在描述 文件 中


=== 语法 ===
== mod 文件 夹 ==
 
与其他游戏 文件 类似，单行注释可以使用哈希（#）开始。要将一个值设置为一个键，对于单个值使用格式key="value"；对于列表则使用以下结构
<pre>
list={
"element0"
"element1"
"element2"
}
</pre>
 
=== 键 ===
下表描述了可在.mod文件中使用的键。


.mod 文件的内容:
{| class="wikitable"
{| class="wikitable"
! 键
! 是否必需
! 描述
! 示例
|-
|-
| name
! Key !! Required? !! Effect !! Example
| 是
| 用于确定启动器中显示的名称。
| name="My Mod"
 
|-
|-
| version
| name || Yes ||  在启动器中显示的名称 || name="My Mod"
|  是
| 允许你为你的mod定义使用版本，该键定义为一个字符串。
| version="0.0.1"
 
|-
|-
| tags
| path || Yes || Defines which folder is the mod's folder. It is NO LONGER RELATIVE to The CK3 folder. Instead, you must use the entire file path. || path = "C:/Users/Example/Documents/Paradox Interactive/Crusader Kings III/mod/my_mod"
| 否
| 设置mod被认为属于的标签。与 Steam Workshop 的类别相关联。
|
<pre>
tags={
"Culture"
"Decisions"
"Fixes"
}
</pre>
 
|-
|-
| supported_version
| version || No ||  允许你为mod 定义 一个 版本， 类型是字 符 串 || version="0.0.1"
| 在mod目录里的文件是必需的；
在descriptor.mod中不是必需的
| 定义 该mod支持的最新版本；如果mod支持版本低于游戏 版本， 启动器会弹出警告。CK3使用语义化版本（即主版本号.次版本号.修订号）。通配 符<code>*</code>可用于定义版本范围。
| supported_version="1.1.3"
 
|-
|-
| path
| picture || No || Determines the Steam Icon. || picture="thumbnail.png"
| 在mod目录里的文件是必需的；
在descriptor.mod中不是必需的
| 设置哪个文件夹是mod的文件夹。注意，它不再是相对于''Crusader Kings III''主文件夹，而是相对于《十字军之王III》用户文件夹（如上所述）。另外，也可以使用整个路径。
|
* <code>path="C:/Users/Example/Documents/Paradox Interactive/Crusader Kings III/mod/my_mod"</code> (Windows)
* <code>path="/home/example/.local/share/Paradox Interactive/Crusader Kings III/mod/my_mod"</code> (Linux)
* <code>path="mod/my_mod"</code> (Relative, any OS)
|-
| remote_file_id
| 如果要上传和更新Steam创意工坊mod，则必需。当mod上传时，该键会自动设置。
| 必须与mod的Steam Workshop ID匹配。可以在Steam Workshop URL的末尾找到, 例如编号"2220762808"的mod位于 https://steamcommunity.com/sharedfiles/filedetails/?id=2220762808.
| remote_file_id="2220762808"
 
|-
| picture
| 否
| Determines the Steam icon.
| picture="thumbnail.png"
|}
|}
=== 基础例子 ===
下面的例子展示了一个.mod文件的基本内容。请随意复制并粘贴到您自己的.mod文件中，记得更改具体细节以符合您自己的mod和游戏版本。注意，descriptor.mod文件不需要path键。
<pre>
version="0.0.1"
tags={
"Culture"
"Decisions"
"Fixes"
}
name="My Mod"
supported_version="1.1.3"
path="mod/my_mod"
</pre>
== Mod文件夹 ==
用来编辑游戏的文件必须放在mod文件夹里面，然后再由游戏加载。这些文件往往要放在特定的文件夹里，否则可能无法被游戏加载。下面列出了一些常见的例子
{| class="wikitable"
! Type
! Folder
|-
| Events
| events
|-
| Decisions
| common\decisions
|-
| Defines
| common\defines
|-
| Traits
| common\traits
|}
具体内容，可以使用本页底部的导航框查阅相关的修改页面，或者在游戏文件中查找 (Windows/Steam: {{cite file|C:/Program Files (x86)/Steam/steamapps/common/Crusader Kings III/game}}) 并将给定文件的文件夹结构复制到（并不包含） {{cite file|game}} 文件夹中
== Tips ==
* 当编辑你的mod文件夹和.mod文件时，你可以在启动器中重新加载mods来更新它们，而无需重新启动它。在 "mods "部分，按 "Manage all mods"，然后按 "Reload installed mods"。如果你的mod没有显示出来，可以尝试这一操作。
* 一旦你创建了你的初始mod结构，强烈建议你使用某种形式的备份系统（就像把你的文件复制到别的地方一样简单），或者源代码控制，比如Git / GitHub。如果你丢失了你的mod文件或以某种方式破坏了你的mod，而你又想回到一个旧的版本，这将会有很大的帮助。
* 当创建你的.mod文件时，确保你正确地遵循语法规则，否则你的mod可能根本不会显示出来。例如，注意在需要的地方使用引号（""），尤其是在路径和名称等值的周围。
* 检查所有地方的拼写，包括文件和文件夹的内容和名称。即使是最简单的错误也会造成很大的问题。
{{Modding navbox}}
{{Modding navbox}}
[[Category: 模组制作]]
[[Category:Modding]]
[[en:Mod structure]]
[[en:Mod structure]]
请注意您对十字军之王3百科的所有贡献都被认为是在知识共享署名-非商业性使用-相同方式共享下发布，请查看在十字军之王3百科:版权的细节。如果您不希望您的文字被任意修改和再散布，请不要提交。
您同时也要向我们保证您所提交的内容是您自己所作，或得自一个不受版权保护或相似自由的来源。 未经许可，请勿提交受版权保护的作品！

为防止机器编辑，请完成下方验证

取消 编辑帮助（在新窗口中打开）

本页使用的模板：