查看“模组制作”的源代码

{{版本|1.0}}
模组可以更改游戏中的元素，也可以为游戏加入新特性。
相当多的东西被硬编码，不能被编辑，比如说新的地图模式和加入快捷键。

所有不使用到[[控制台指令]]的模组都可以使用成就

== 提示 ==

* 不要直接在游戏文件里修改文件，不仅会破坏游戏而且修改的内容也会在游戏更新中被覆盖。
* 使用可以高亮语法的编辑器可以让模组制作事半功倍，下面是拥有对维多利亚3语法支持插件的编辑器：
*# [https://code.visualstudio.com/ Visual Studio Code] 是一个完备但是稍慢的文本编辑器，使用[https://marketplace.visualstudio.com/items?itemName=tboby.cwtools-vscode CwTools]插件可以使其支持维多利亚3的语法
*# [https://www.sublimetext.com/ Sublime Text] 是非常快的编辑器，支持高亮语法，自动补全和文档查询，搭配维多利亚3插件[https://github.com/dementive/Victoria3Tools Victoria 3 Tools]使用
* 以 "-debug_mode" 和 "-filewatcher" 指令可以开启调试模式，调试模式可以使用控制台和开发工具，同时也能热更改一些文件而不需要重启。
* 查看error.log以捕获bug，这种精确的记录对于模组制作者来说是一种可以判断为什么一些东西不工作的利器。文件位于Documents/Paradox Interactive/Victoria 3/logs
* 请备份，所有东西都可能会变坏所以需要备份。你可以手动备份也可以使用诸如GIt的版本控制工具、可以考虑使用Github来团队协作，如果你是初学者建议使用以[https://desktop.github.com/ Github Desktop]i熟悉Git。
* 使用Use "script_docs" 和 "DumpDataTypes" 控制台指令可以在Documents/Paradox Interactive/Victoria 3/logs生成效果、条件、作用域和事件目标的记录。
* 如果你不清楚怎么做，可以在游戏文件搜索你需要搜索的单词，查找文件中的单词是写出没有错误的mod的一个快捷方法。
* 当你下载了你上传的Steam mod，在本地文件又有原本的Steam mod，Steam的mod不会运行。
* 括号要补全，这样才能使得代码都在一个层次内，正确的代码是可以让大括号在文本编辑器折起来的。漂亮的代码能够更好看清楚错误和增强可读性。
* 以#开头来进行注释，可以说明代码的用途，也可以注释掉暂时不需要用的代码。

==实用的工具==

* [https://github.com/crschnick/pdx_unlimiter Pdx-Unlimiter] 可以修改存档数据的实用工具
* [https://github.com/Linnest2020/Vic3-mapdata-editor Map data editor] 基于jomini.js制作的用chrome启动的省份数据编辑器，可以可视化编辑history/states的数据
* [https://github.com/runite-drill/music-mod-creation-tool Music Mod Creation Tool] 顾名思义，这是一个音乐mod制作工具


==模组指导==
[[自定义国家]]

[[自定义事件]]

[[自定义日志]]

[[自定义修正]]

== Game object reference ==

=== Dependency and Folder Structure ===

If you want to add a new game object, you will need to keep in mind which more fundamental objects it depends on, and how to organize the files so the game recognizes it.

All paths are relative to the 'game' folder inside your Victoria 3 install directory, as that is where all scriptable parts of the game are located.

Note: objects with no dependencies may still reference primitive objects (numbers, strings etc) or core game concepts, but no object type that mods can edit or define, only change the parameter value of. Nested references, especially within modifiers, are generally also not counted, since modifiers can have arbitrary dependency relations.

{| class="mildtable sortable mw-collapsible"
! Object type
! 路径
! Dependencies
|- 
! 人群职业
| common/pop_types
| {{图标|no}}
|-
! [[Goods_modding|商品]]
| common/goods
| {{图标|no}}
|-
! 人群需求
| common/pop_needs
|
: Trade goods, via 'default'
: Trade goods, via 'goods' inside 'entry'
|-
! 时代
| common/technology/eras
| {{图标|no}}
|-
! [[Technology_modding|科技]]
| game/common/technology/technologies
|
:Eras, via 'era'
:Technologies, via 'unlocking_technologies'
|-
! [[Institution_modding|析构]]
| common/institutions
| {{图标|no}}
|-
! 法律组
| common/law_groups
| {{图标|no}}
|-
! [[Laws_modding|法律]]
| common/laws
| 
:Institutions, via 'institution'
:Law groups, via group 
:Laws, via 'disallowing_laws'
:Laws, via 'possible_political_movements'
|-
! 意识形态
| common/ideologies
|
: Law groups, as parameters
: Laws, via law group parameter mappings
|-
! 利益集团特质
| game/common/interest_group_traits
| {{图标|no}}
|-
! [[Interest group modding|利益集团]]
| common/interest_groups
|
: Interest group traits, via 'traits'
: Ideologies, via 'ideologies'
|-
! 生产方式
| common/production_methods
|
: Technologies, via 'unlocking_technologies'
: Laws, via 'disallowing_laws'
: Production methods, via 'unlocking_production_methods'
|-
! 生产方式组
| common/production_method_groups
|
: Production methods, via 'production_methods'
|-
! 建筑组
| common/building_groups
|
: Building groups, via 'parent_group'
: Building, via 'default_building'
|-
! [[Building_modding|建筑]]
| common/buildings
|
: Building groups, via 'building_group'
: Technology, via 'unlocking_technologies'
: Production method groups, via 'production_method_groups'

|}

=== 参数 ===

When creating a game object, you generally need to follow a specific pattern. Here are the parameters for various game objects, what they mean, which are required, and what type of value to enter.

{| class="mildtable sortable mw-collapsible"
! Object type
! Parameter
! Parameter type
! Required
! Meaning
|-
!rowspan=7| Trade goods
| texture
| string
| {{图标|yes}}
| good icon filepath
|-
| cost
| integer
| {{图标|yes}}
| base good price
|-
| category
| keyword, one of:
: staple
: industrial
: luxury
: military
| {{图标|yes}}
| which goods category it belongs to
|-
| prestige_factor
| integer
| {{图标|yes}}
| base prestige for being lowest rank leading producer:
specifically, holding the MIN_PRESTIGE_AWARD spot.
|- 
| traded_quantity
| integer
| {{图标|no}}
| how many goods are traded for each level of a trade route
|-
| convoy_cost_multiplier
| floating point number
| {{图标|no}}
| how many times more convoys are needed to transport this good
|-
| consumption_tax_cost
| integer
| {{图标|no}}
| how much authority it costs to levy a consumption tax
note: absence of this parameter implies no consumption tax can be levied
|-
! Technology Era
| technology_cost
| integer
| {{图标|yes}}
| the base technology cost for techs in this era
|-
!rowspan=6| Technology
| era
| Technology Era
| {{图标|yes}}
| which era this technology belongs to
|-
| texture
| string
| {{图标|yes}}
| technology icon filepath
|-
| category
| keyword, one of:
: production
: military
: society
| {{图标|yes}}
| which category this technology belongs to
|-
| modifier
| country modifier
| {{图标|no}}
| which immediate effects this technology has on your country
Example: Cotton Gin provides 25% cotton plantation throughput.<br/>
Unlocked buildings, production methods, laws, etc are specified<br/>
from the unlocked object, not the unlocking technology.
|-
| unlocking_technologies
| list of technologies
| {{图标|no}}
| All prerequisite technologies. If empty, it has no prerequisites
|-
| can_research
| boolean
| {{图标|no}}
| if 'no', makes it unavailable for normal research.
Example: [[Production_technology#Sericulture|Sericulture]].
|}



==参见==
[[控制台指令]]

[[On actions]]

=== Modders Guides===
[[User:Gr3st3r|Grester's Compendium]]

{{Modding navbox}}
[[分类:模组]]
[[en:Modding]]