模组制作

Modding, 或称为“模组制作”,是修改基本游戏（即原版）的行为, 无论是供个人使用，或者是公开发布给其他玩家，比如发布到Steam创意工坊。

就所有p社游戏而言，ck2的模组制作有很大开放性，可以很显著的延伸游戏的内容，增强游戏的可玩性。 mod制作者的动机各不相同：更好的翻译成母语，更多的事件及决议，更棒的地图，亦或游戏整体大修改等等。

mod制作非魔术邪说也，人皆可学习相关知识以制作mod，这个指引旨在降低ck2模组制作的门槛。不过，无论学习资料有多么的好，制作mod的过程都会是十分曲折的，并且学习资料无法取代对阅读基础代码，以及不断调试的需要。总之，制作mod不是一天两天的功夫，而是一项宏伟的工程，努力是必须的。

指引

• 为您的修改创建mod：即使是小的更改也要创建个人mod，并且切勿直接修改Steam CKII文件夹中的游戏文件，因为它们可能会在没有警告的情况下被覆盖。
• 使用优质的文本编辑器 来编辑文件并搜索多个文件。请参见文本编辑器。
• 验证你的mod 使用The Validator，它将为您节省许多麻烦和时间，以解决崩溃和错误。
• 尽量减少对原版文件的覆盖 通过添加单独的文件或尽可能地从文件夹加载，以改善mod兼容性和维护。
• 使用适当的合并工具 以便在文件夹之间合并，并将修改后的原版文件更新为新的Vanilla补丁。
• 备份您的工作 以避免丢失一切。如果是一个MOD制作组，请考虑使用诸如GitHub之类的源代码控制系统充当备份并管理协作。
• 使用ANSI（Windows-1252）编码 用于文本文件。
• 适当缩进 以轻松发现未闭合的花括号。原版使用1个制表符来缩进而不是空格。
• 使用注释 以＃字符开头，来记住编写棘手内容的原因。

文本编辑器

以下是支持CK2编程语言的文本编辑器:

• Notepad++: CKII 语言文件
• Sublime Text: Sublime Text 3语法高亮
• Atom: language-crusader-kings--i-i

Mod结构

mod文件被放置在 ~\Paradox Interactive\Crusader Kings II\mod, 里面必须包含:

• .mod 文件, 告诉启动器如何加载你的mod
• 包含mod数据好的文件夹或者是zip压缩包。mod数据的文件结构必须和本体的游戏结构相同，注意文件夹和文件的名称大小写在Mac和Linux上是敏感的，这意味着 Abc 和 abc 会被视为两个mod。

.mod 文件的文件名不能包含任何空格，否则在启动器重启的时候，不会被自动选中。

.mod 文件的内容如下所示：

关键字	必需?	效果	例子
name	Yes	你的mod显示在启动器中的名称	name = "My Mod"
path	Yes	定义哪个文件夹是你的mod文件夹。 其路径是相对于~\Documents\Paradox Interactive\Crusader Kings II\ .	path = "mod/MyMod"
user_dir	No	告诉启动器存储游戏或临时文件到特定的文件夹。 这对能改善mod的兼容性（例如新的标题，旗帜，宗教，文化，建筑之类的），让文件不会混淆在一起。 警告：不要给主mod的子mod设置 user_dir，因为所有激活mod的user_dir会连接在一起。	user_dir = "MyMod"
archive	No	定义一个zip压缩包来代替文件夹。设置它的路径，路径是相对于 ~\Documents\Paradox Interactive\Crusader Kings II\ 的。这是从Steam创意工坊下载的mod使用的格式，但是在将mod上传到创意工坊时，必须使用path结构。	archive = "mod/mymod.zip"
replace_path	No	告诉启动器覆盖对应文件夹的所有内容，并且只从mod中的指定路径加载。这是删除原版东西的唯一有效方式，而这经常被完全改动类mod所使用。 Notes: replace_path作为文件夹工作，而不是文件.，覆盖一个文件，只需要在mod中创建一个同名文件。 replace_path只对对应文件夹中的文件有效，其子文件夹中的文件无效. 例如，覆盖“history”并不会覆盖“history/characters”。 为了缩小mod体积、增强mod兼容性，尽可能少用replace_path. 在旧版本中，replace_path在被安装到CK2安装目录/mod时通常被忽视，因此必须放入使用者文件。（见CK2模组目录） 除非你确实需要使用replace_path才使用，通常不用。	replace_path = "history" replace_path = "history/characters"
dependencies	No	告诉启动器，在此mod之前必须加载另一个mod。另一个模组将首先加载，允许另一个模组覆盖某些文件（否则第一个模组将先加载）。一个dependencies不是必要的；如果mod有一个集，则不需要加载dependencies。这只是 .mod文件告诉启动器应首先加载哪些文件的一种方式。 如果dependencies里的mod的名称包含空格，则必须将其括在转义引号中。"\"Mod with space in name\""	dependencies = { "MyMod" "\"Another Mod\"" }
picture	No	模组文件夹下的图像可用作Steam创意工坊的展示图片。（将显示为 268 像素× 268 像素 JPEG）	picture = "MyMod.jpg"
tags	No	Steam创意工坊的标签列表。警告:不要忘记包含空格的标签的引号。	tags = { "Tag1" "Tag 2" }
supported_checksums	No	脚本条件将计算为true的预期校验和列表。这可以在事件模组制作中使用，以向玩家显示警告。supported_checksums	supported_checksums = { ABCD EFGH }

以下是一些示例模组文件，具体取决于模组的类别：

小型mod

小型mod更常见一些，为了保证和其它小型mod的兼容性，请不要使用user_dir或者是replace_path。

 name = "Small Mod"
 path = "mod/SmallMod"
 picture = "SmallMod.jpg"
 tags = { "Mods" "Small" }

大型mod

大型模组通常使用 user_dir 使保存内容无论如何都无法在开启此mod前加载。对于总转化模组， replace_path 用于完全覆盖在模组中没有意义的原版文件夹（histroy，flags等）。

 name = "Big Mod"
 path = "mod/BigMod"
 user_dir = "BigMod"
 replace_path = "history/provinces" 
 picture = "BigMod.jpg"
 tags = { "Mods" "Big" }

子mod

主mod的子mod通常用 dependencies 来覆盖主mod的文件。

 name = "Sub Mod"
 path = "mod/SubMod"
 dependencies = { "\"Main Mod\"" }
 picture = "SubMod.jpg"
 tags = { "Mods" "Main Mod" }

游戏数据

• 控制台指令，对于调试模组非常有用
• 定义，影响一些原版的硬编码行为
• 作用域，条件，和 指令 被用于脚本编写
• 修正, 用于影响游戏所做的计算
• 地图数据

游戏结构

游戏数据是由包含游戏文件的文件夹及子文件夹的结构组成。

模组遵循与基础游戏相同的文件夹结构，因此在加载游戏时，引擎将合并来自原版和mod的文件。在大多数文件夹中，引擎将加载其中的所有文件，这允许mod添加新的定义（头衔，宗教等），而无需复制和修改原版文件。若要利用这一点，请务必了解如何在文件级别和定义级别加载脚本。

加载模组时的行为如下：

• 引擎根据某些硬编码的加载顺序处理文件夹和文件。
• 如果将当前文件夹定义为 replace_path ，则该文件夹中的所有原版文件都将被忽略，并且只会加载mod文件（如果有）。
• 如果 mod 文件夹和原版文件夹都包含同名的文件，则将忽略原版文件，并使用mod版本。
• 在给定的文件夹中，文件的处理顺序通常是字母数字的，合并了 vanilla 和 mod 文件名，尽管某些文件夹可能具有不同的行为
• 在多次遇到相同的定义（头衔，宗教，决议等）时，重复的定义可能：
  • 被忽略（先加载的定义成为游戏内容）
  • 完全覆盖上一个定义（最后一个定义成为游戏内容）
  • 部分覆盖以前的定义（定义被合并/加法，这只有在实际有要合并的东西时才有意义：层次结构，列表等）
  • 两者共存/中断（在这种情况下，必须避免重复的ID）

以下是CKII游戏文件和文件夹的列表，以及相关的模组指南和加载行为。

对于加载行为，单元格颜色会突出显示行为是预期的行为、奇怪的行为还是需要注意的行为、是意外的，还是需要避免的行为。

文件夹/文件	该文件包含什么	如何模组	加载行为
.\common\ achievements.txt defines.lua defines.txt hints.txt region_colors.txt static_modifiers.txt technology.txt	大致信息 定义Steam成就 POP， 一般变量、外交变量、经济变量和军事变量 定义可游玩的开始日期和结束日期 定义显示的提示 定义每个区域的 RGB 代码 所有难度、等级和标准修饰符 科技数据	定义 修正 科技模组制作	不适用
.\common\alternate_start\		另类开局模组制作	[?] 合并。
.\common\artifact_spawns\		宝物模组制作	合并。
.\common\artifacts\	宝物的定义	宝物模组制作	合并。
.\common\bloodlines\		血脉模组制作
.\common\bookmarks\	Bookmarks are configured here (scenarios/start dates)	剧本模组制作	合并。剧本在游戏中按时间顺序列出，无论文件中的顺序如何。
.\common\buildings\	Buildings folder, all buildings are stored here.	建筑模组制作	[?] 合并。
.\common\cb_types\	Casus Belli folder, all Casus-belli are stored here.	宣战理由模组制作	合并，但通过重复使用相同的名称来覆盖宣战理由不起作用。（创建重复的宣战理由文件）
.\common\combat_tactics\	Combat tactics definitions.	单位模组制作	[?] 合并。
.\common\council_positions\	Conditions for an A.I. councillor to adopt a certain category of voting behavior.	内阁成员模组制作	[?]
.\common\council_voting\	A.I. rules for how councillors from a behavior category will vote	内阁成员模组制作	[?]
.\common\cultures\	Cultures folder, all cultures are stored here.	文化模组制作	合并。 Since patch 2.4 cultures are merged like religions, and a new culture may be added to a vanilla culture_group via a separate file.
.\common\death\	Death definitions	死亡模组制作
.\common\death_text\	Flavor text for succession screen	死亡模组制作
.\common\defines\	定义	定义	[?] 合并。Entries in files override common/defines.lua values.
.\common\disease\	Diseases definitions.	疾病模组制作	[?] 合并。
.\common\dynasties\	Dynasties folder, all dynasties are stored here.	家族模组制作	合并。Duplicate dynasties loaded before vanilla (i.e., 000_ prefix) will overwrite dynasty shields. Duplicates loaded after (i.e., z_ prefix) will overwrite dynasty names. To overwrite both, use duplicate files, one with a preceding prefix and one with a succeeding prefix.
.\common\event_modifiers\	Event_modifiers folder, all event modifiers are stored here	修正	合并。
.\common\execution_methods\	Execution methods	死亡模组制作	[?]
.\common\game_rules\	Game rules definitions	游戏规则模组制作	合并。The rules are displayed in UI based on order of files (alphanumerical on file name), then order of rules within the file.
.\common\government_flavor\	Government naming definitions	政体模组制作	[?]
.\common\governments\	Government definitions	政体模组制作	合并。It is possible to define governments of the same government group in different files.
.\common\graphicalculturetypes\	Graphicalculturetypes folder, all graphical culture types are stored here		[?] 合并。
.\common\heir_text\	Flavor text for succession screen	死亡模组制作
.\common\holding_types\	Conditions for being allowed to build each holding type.	政体模组制作	[?]. It is not possible to add new holding types.
.\common\job_actions\	Defines councillors actions	内阁成员模组制作	合并。
.\common\job_titles\	Defines councillors titles	内阁成员模组制作	[?]
.\common\landed_titles\	Landed_titles folder, all landed titles are stored here.	头衔模组制作	合并。 Merging behaviour is "complicated and might not have been designed that way intentionally"
.\common\laws\		法律模组制作	合并。 A law with the same name as an existing law will append conditions to the allow section, but not the potential section.
.\common\mercenaries\	Mercenaries folder, all mercenaries are stored here		[?] 合并。
.\common\minor_titles\	Minor titles, including honorary titles	荣誉头衔模组制作	Cannot be overridden, attempts to do so will result in multiple minor titles with the same tags, like traits
.\common\modifier_definitions\	Defines dynamically defined modifiers, in particular special units modifiers.	单位模组制作	[?] 合并。
.\common\nicknames\	Nicknames folder, all nicknames are stored here	称号模组制作	合并。
.\common\objectives\	Objectives folder, all objectives (i.e. ambitions, factions, and plots) are stored here.	目标模组制作	[?] 合并。
.\common\offmap_powers\ policies\ statuses\	Defines nations not represented on the map, but with a significant influence over it.	地图外政权模组制作	[?] 合并。Does NOT require Jade Dragon DLC.
.\common\on_actions\	On_actions folder, all on_actions are stored here	事件模组制作	合并。 Since patch 2.4 on_actions are merged, with new events being added to the previous list for a particular on_action, instead of replacing the list.
.\common\opinion_modifiers\	Opinion modifiers folder, all opinion modifiers are stored here	修正	[?] 合并。
.\common\province_setup\	patch 3.0后废弃
.\common\religion_features\		宗教模组制作	[?] 合并，but features with the same key get duplicated
.\common\religion_modifiers\	Religion_modifiers folder, all religion modifiers are stored here.	修正	[?] 合并。
.\common\religions\	Religions folder, all religions are stored here.	宗教模组制作	合并。 Vanilla religions can be overridden, without needing to duplicate the whole religion group. Restrictions: need to define reformed religion before the non-reformed.
.\common\religious_titles\	Religious_titles folder, all religious titles are stored here		[?] 合并。
.\common\retinue_subunits\	Retinue subunits folder, all retinue subunits are stored here		[?] 合并，but retinues with the same key get duplicated
.\common\save_conversion\		游戏存档兼容性	[?]
.\common\scripted_effects\		脚本	[?] 合并。
.\common\scripted_score_value\		脚本分数值	[?] 合并。
.\common\scripted_triggers\		脚本触发器	合并， but scripted triggers with same name append their conditions rather than replacing the original one.
.\common\societies\	Definition of societies	社团模组制作	Merge, but override of societies by re-using same name does not work (creates duplicate societies)
.\common\special_troops\	Special units definitions	单位模组制作	[?] 合并。
.\common\stories\	废弃的		不适用
.\common\succession_voting\	Succession voting rules and AI behavior	继承模组制作	[?] 合并。
.\common\trade_routes\	Trade route definitions.	贸易路线模组制作	[?]
.\common\traits\	Traits folder, all traits are stored here.	特质模组制作	合并， but traits with same name will co-exist, and generated characters may get both versions of the trait at the same time. The last definition gets assigned to a character when using commands.
.\common\tributary_types\	Tributary relationship definitions.	朝贡关系模组制作	[?]
.\common\triggered_modifiers\	Defines global modifiers that trigger under certain conditions	Triggered modifiers	[?] 合并。
.\connectui\	Appears to be leftover interface for the discontinued Paradox Connect service (used in older Clausewitz games CK2 is based on).	废弃的
.\decisions\	Decisions folder, all decisions are stored here	决议模组制作	合并， but override of decision by re-using same name does not work (breaks the decision effect, that does nothing)
.\dlc\	Contains DLC information and zipped content files	可下载内容	不适用
.\dlc_metadata\	?		?
.\eu4_converter\	Europa Universalis 4 Save Converter folder, all files related to the EUIV converter are stored here. Note: vanilla files were moved inside /dlc/dlc030.zip	EU4转档器模组制作	[?]
.\events\	Events folder, all events are stored here.	事件模组制作	合并，If redefining an event in a file loaded alphabetically after the original file, the event will be fully overridden. Developers have discouraged this practice, as that engine behavior is not guaranteed to remain in the future (source ?)
.\gfx\ ambitions\ characters\ coats_of_arms\ cursors\ eurfonts\ event_pictures\ flags\ fonts\ FX\ interface\ loadingscreens\ mapitems\ models\ polishfonts\ titles\ traits\	Graphics folder, all graphics are stored here.	图形模组制作 Graphics are mapped to a logical name (GFX_xxx) inside .\interface\*.gfx files Warning: a missing flag for a title in flags\ will cause wrong flags to appear for most titles, due to a shift.
.\history\	Historical data for characters, titles, provinces and wars for the possible start dates. This is a likely the text export of an internal database, which is sometime mentioned in the patch notes.	历史模组制作	不适用
.\history\characters\	Historical characters, optionally associated to a dynasty from \common\dynasties\ folder.	角色模组制作	[?] 合并。Duplicate character IDs break the character history and must be avoided.
.\history\diplomacy\	废弃的	不适用	不适用
.\history\offmap_powers\	History of offmap powers (holder, status, ...)	地图外政权模组制作	[?] 合并。
.\history\provinces\	History of provinces (holdings built, change of culture or religion)	省份模组制作	[?] 合并。
.\history\technology\	Initial technology of provinces, depending on the start date.	科技模组制作	[?]
.\history\titles\	History of titles (list of successive holders)	Note: titles that should be deactivated at game start (ex: reformed religion heads) must have an history file that disables the title.	[?] 合并。
.\history\wars\	Important on-going wars (attacker, defender, Casus Belli, war score, ...), usually for historical bookmarks.		[?] 合并。
.\interface\ generalstuff.gfx sound.sfx	Interface graphics	界面模组制作 声音模组制作	Loading of *.gfx files is in alphanumerical order. Last spriteType definition loaded overrides previous ones with same name, if any (i.e. use zz_ file prefix to override vanilla sprites). Only sound.sfx is taken into account, other .sfx files are ignored.
.\interface\coat_of_arms\		盾徽模组制作	Coat of arms definitions can be split across multiple files. No support for appending existing definitions from a different file.
.\interface\portrait_offsets\	.txt files with external offsets for portrait frames	肖像模组制作
.\interface\portrait_properties\	Dynamic rules to select portrait properties values	肖像模组制作	[?]
.\interface\portrait\	Definitions of spriteType and portraitType elements for portraits.	肖像模组制作	合并。
.\launcher\	Launcher graphics and configuration		不适用
.\localisation\	All text data for things like country names and event description, has options for other languages	本地化	Full override. If duplicates are in different files, first file loaded wins (i.e. use 00_ file prefix to override vanilla keys). If in same file, last duplicate in file wins. Warning: files must end with .csv extension, or they will not be taken into account.
.\localisation\customizable_localisation\	Custom localisation commands definitions	本地化	[?] Merge.
.\map\ adjacencies.csv default.map definition.csv geographical_region.txt positions.txt provinces.bmp rivers.bmp terrain.bmp topology.bmp trees.bmp world_normal_height.bmp	Map settings, province shapes, continents, regions etc.	地图模组制作	N/A
.\map\statics	Map external frame size, and positions of fixed 3D map elements (wonders, etc.)	地图模组制作
.\map\terrain		地图模组制作
.\mod\	Dummy mod folder, do not store mods here, use local mod folder	模组制作	Breaks mods, as configurations like replace_path are ignored.
.\music\	Music used by the game	音乐模组制作	[?] All .txt files song elements are loaded.
.\sound\	All sounds except music		[?]
.\tutorial\	Tutorial configuration		[?]

具体指南

仅包含上面或以其他方式“如何修改”列中尚未链接的指南。

• 故障排除 - 在你的mod中debug
• 编辑游戏存档 - 如何更改保存游戏

• Patch 2.4 mod compatibility guide - 如何从 patch 2.3.6 移植到 patch 2.4.X
• Patch 2.5 mod compatibility guide - 如何从 patch 2.4.5 移植到 patch 2.5.X
• Patch 2.6 mod compatibility guide - 如何从patch 2.5.2 移植到 patch 2.6.X
• Patch 2.7 mod compatibility guide - 如何从m patch 2.6.3 移植到 patch 2.7.X
• Patch 2.8 mod compatibility guide - 如何从 patch 2.7.2 移植到 patch 2.8.X
• Patch 3.0 mod compatibility guide - 如何从 patch 2.8.3.2 移植到 patch 3.0.X
• Patch 3.1 mod compatibility guide - 如何从 patch 3.0.X 移植到 patch 3.1.X
• 合并指南 - 如何将mod文件与新的原版补丁合并

• 彻底转换指南 - Creating a total conversion mod
• 模组安装程序创建指南 - Advanced guide for creating a Windows installer

工具与实用程序

这些是modder用的实用工具。 玩家使用的请看实用工具.

• Notepad++ - 修改文件用的编辑器，比notepad要好。
• Notepad++ language file for CKII - 对于阅读代码十分友好。
• The Validator - 文件查错。
• EU4:JoroDox mod making tool / Forum thread - 查看mod文件和创建3d模型。
• CK2 Cultures Parser
• Coat of Arms Builder
• Portrait Builder - 预览人物特征的工具。
• Scenario Editor
• Titular Title Generator
• Text Fixer - 按字母排序你的localisation 文件。（alphabetize your localisation file）
• Paradox Province Color Picker

高级技巧

• For the bigger mods using a source control management tool (Git, ...), it is handy to create a symbolic link between CKII mod folder and the working directory of the local repository, especially if the mod also has sub-mods. Note that you'll still need to copy the .mod file(s) manually, but they rarely change. Run the following command from the parent directory of main git folder, replacing:
  • <mod_path_name> by the value of path attribute from .mod file
  • <git_mod_folder> by the name of the sub-folder that contain mod data (folders common, decisions, events, etc...)

mklink /J "%HOMEDRIVE%%HOMEPATH%\Documents\Paradox Interactive\Crusader Kings II\mod\<mod_path_name>" ".\<git_mod_folder>"

MOD调试

毫无疑问，更多隐藏的控制台指令（在控制台输入help也不会显示的内容）对MOD测试会起到巨大的作用。

• observe - 让你进入观察者模式。此时你不再控制任何特定的角色——这会让游戏不受打断地自动运行。同时，所有隐藏特质、秘密信仰等对观察者都是可见的。
• run <filename.txt> - 直接运行特定脚本。脚本将从当前玩家控制角色的作用域开始执行。这个功能有助于测试复杂的脚本——你可以直接打开一个窗口编辑脚本，保存，重新载入，调整——省下重新打开游戏的时间。
• reloadevents - 重新载入和编译每一个事件（可能花费一会时间，取决于你的硬件）。对调试事件很有帮助，同样为你省下重新打开游戏的时间。
• reloadloc - 重新载入本地化文件，有助于确定文本是否显示在正确的位置上。

更多控制台指令可以在首页找到，用于实现杀掉某人之类的特定功能，这些对MOD测试同样必不可少。

外部链接

• Modding - Quick questions
• User mod Index/Guides/Utilities superthread

更多

• 模组
• Modding suggestions

引用

模组制作 

模组制作指南