开发日志#164－疯狂模组星期一

Victoria3官方

2025年11月10日 23:00

收录于文集

共42篇

维多利亚3

【译者按：本开发日志仅描述游戏中的机制与内容，请勿过度解读。】

大家好，周一快乐！系统设计师Tunay在这里报告，我已被允许离开矿洞，为大家带来本次更新中与模组制作相关的重点。我们有不少重要的内容，所以话不多说，直接开始。

数据库接入模式

让我以一个坏消息开始本篇日志吧，本次更新将使模组损坏。我想强调这句话，所以让我重复一遍：

本次更新将使模组损坏

等等，先别提刀！我需要先解释一下原因。你们可能曾读过Tinto Talks#85－模组制作h或是已经开始尝试制作EU5的模组了！

EU5中，我们的脚本语言得到了一次重大更新，开发了数据库接入模式。这个功能允许你决定一段脚本要如何与已存在的（游戏中的或是其他模组中的）脚本共同作用，通过一系列新的关键字。

这一功能将加入Victoria 3。也因此，新版本更新后，你将需要根据强制要求的新语法调整你的模组。

如果各位没有了解过这个功能，让我举例说明这一个系统：

首先，假设我现在想调整征召农兵这一法律，以体现乡村民众利益集团的精神与力量。我可以在该法律的键值前使用INJECT关键字，该关键字可以将脚本内容插入现有的法律中，而非取代它。

脚本写法

游戏内效果

你可能发现了，将修正插入现有的内容会计算为加法。加入原有内容中有+25%威望的修正，你又inject了一个+50%威望的修正，那么最终结果会是+75%威望。

新的关键字一共有六种，为了方便，我将它们全部列于此处：

# code

INJECT:key #此模式下，代码将尝试添加进已有内容。若不存在对应key，则报错。

REPLACE:key #此模式下，代码会替换掉已有内容。若不存在对应key，则报错。

TRY_INJECT:key #此模式等同于INJECT，但若不存在对应key，不会报错。

TRY_REPLACE:key #此模式等同于REPLACE，但若不存在对应key，不会报错。

INJECT_OR_CREATE:key #此模式等同于INJECT，但若不存在对应key，会创建新的内容。

REPLACE_OR_CREATE:key #此模式等同于REPLACE，但若不存在对应key，会创建新的内容。

# code end

使用正确的关键字能够避免许多兼容性问题，也能更容易与现有的模组进行兼容性适配——如果你和同行们热烈的交流的话。

请注意，您必须明确调用这些关键字。代码不允许隐式替换，所以如果您有时间，记得更新一下代码！

以下是这个新系统生效的数据库：

# spoiler

acceptance_statuses

ai_strategies

amendments

battle_conditions

building_groups

buildings

buy_packages

character_interactions

character_templates

character_traits

cohesion_levels

combat_unit_groups

combat_unit_types

combat_unit_experience_levels

commander_orders

company_charter_types

company_types

country_creation

country_definitions

country_formation

country_ranks

country_types

culture_graphics

cultures

decisions

decrees

diplomatic_actions

diplomatic_catalyst_categories

diplomatic_catalysts

diplomatic_plays

discrimination_trait_groups

discrimination_traits

dna_data

dynamic_company_names

dynamic_country_names

dynamic_country_map_colors

dynamic_treaty_names

technology

flag_definitions

game_concepts

geographic_regions

goods

government_types

harvest_condition_types

ideologies

institutions

interest_group_traits

interest_groups

journal_entry_groups

journal_entries

law_groups

laws

legitimacy_levels

liberty_desire_levels

military_formation_flags

mobilization_option_groups

mobilization_options

objective_subgoal_categories

objective_subgoals

objectives

parties

political_lobby_appeasement (factor)

political_lobby_appeasement (reason)

political_lobbies

political_movement_categories

political_movement_pop_support

political_movements

pop_needs

pop_types

power_bloc_coa_pieces

power_bloc_identities

power_bloc_map_textures

power_bloc_names

power_bloc_principle_groups

power_bloc_principles

prestige_goods

production_method_groups

production_methods

proposal_types

religions

social_classes

social_hierarchies

map_data/state_regions

state_traits

strategic_regions

subject_types

terrain_manipulators

terrain

themes

tutorial_lessons

tutorial_lesson_chains

labels

war_goal_types

alert_groups

alert_types

commander_ranks

scripted_buttons

scripted_progress_bars

treaty_articles

gfx/map/city_data/city_building_vfx

gfx/map/fleet_dioramas

gfx/map/fleet_entities

gfx/map/army_dioramas

gfx/map/front_entities

state_regions

sound/persistent_objects

music

notifications

modifier_type_definitions

ethnicities

script_values

scripted_guis

scripted_lists

scripted_modifiers

gui_animations

achievements

modifier_icons

gfx/portraits/accessories

gfx/portraits/portrait_modifiers

# spoiler end

建筑组清理

说到会导致模组损坏的事情：

首先是，我们重命名了一系列建筑，在版本更新后你应该可以很快确认这些变化，并通过大规模替换解决问题。此前，有一些建筑键值明明不规范，我们决定让一切更一致。

其次是，地区资源现在按照建筑类型操作，而非建筑组。让我们举例说明，在map_data/state_regions中，定义发生了以下变化：

新写法：

# code

arable_resources = { "building_wheat_farm" }

capped_resources = {

building_fishing_wharf = 4

}

resource = {

type = "building_oil_rig"

undiscovered_amount = 40

}

# code end

旧写法：

# code

arable_resources = { "bg_wheat_farms" }

capped_resources = {

bg_fishing = 4

}

resource = {

type = "bg_oil_extraction"

undiscovered_amount = 40

}

# code end

此改动意图消灭那些仅在资源定义中被用到的建筑组。现在，每种农场不再属于各自的建筑组，而是属于一个bg_staple_crops建筑组。被移除的建筑组仍被记录在数据库中，但已不再被使用，并将在1.13版本被彻底移除。我们也增加了临时方案，当你输入建筑组时，代码会尝试读取建筑组的默认建筑类型。该临时方案也将在1.13版本删除，所以我们依然推荐更新你的模组。

可模组化战争目标

无论如何，我们要进行下一个主题了：脚本化战争目标类型！

我们清楚这是你们中的许多人很久以来一直期待的东西。我十分高兴的宣布，实现了。我们新建了一个数据库，存放在common/war_goal_types文件夹中。

当更新上线后，我们此前的战争目标都将被放在这个文件夹中。不过需要说明的是，很多原版的行为都是由代码编写的的，所以在进行修改时一定要加倍小心。

# code

some_war_goal = {

icon = "gfx/interface/icons/war_goals/icon.dds"

### List of Kinds

# annex_country

# ban_slavery

# Will convert to law commitment treaty article for slavery banned

# colonization_rights

# conquer_state

# contain_threat

# enforce_treaty_article

# force_nationalization

# foreign_investment_rights

# Will convert to investment rights treaty article

# humiliation

# increase_autonomy

# independence

# join_power_bloc

# leave_power_bloc

# liberate_country

# liberate_subject

# make_dominion

# make_protectorate

# make_tributary

# open_market

# reduce_autonomy

# regime_change

# return_state

# revoke_all_claims

# revoke_claim

# secession

# take_treaty_port

# Will convert to treaty port treaty article

# transfer_subject

# unification

# unification_leadership

# custom

# No predefined effect. In case you only want to execute the on_enforced effect, but nothing else.

kind = war_goal_kind # The Kind of the war goal defines the code-side predefined package of behavior that war goal will have, primarily defining what effect the war goal has when executed.

### List of settings

# require_target_be_part_of_war

# Target country has to be in the war, can't target neutral countries

# can_add_for_other_country

# Allows adding the goal for other participating countries

# annexes_entire_state

# Flag for if the goal is expected to always annex the entire target state. This is used to calculate conflicts with other goals

# annexes_entire_country

# Flag for if the goal is expected to always annex the entire target state. This is used to calculate conflicts with other goals

# country_creation

# Flag for if the goal creates a new country

# overlord_is_stakeholder

# Flag for if the stakeholder of the war goal should be the overlord rather than the target country itself

# can_target_decentralized

# If the war goal can target decentralized countries

# has_other_stakeholder

# If the war goal has a different stakeholder than the target itself

# turns_into_subject

# If the war goal turns the target country into a subject. For conflict resolution purposes

# skip_build_list

# If the war goal should be available to be picked in the diplomatic play or not

# targets_enemy_subject

# If the war goal should target an enemy subject specifically rather than all enemies in the war goal

# targets_enemy_claims

# If the war goal should target the claims of a country, rather than the country itself

# requires_interest

# If the war goal requires you to have an interest in the relevant strategic zone

# debug

# No effect, used for code debug purposes.

# validate_subject_relation

# Validation behavior that checks if the resulting subject relation of this war goal is valid

# validate_formation_candidate_self

# Validation check to make sure the goal holder is a formation candidate

# validate_formation_candidate_target

# Validation check to make sure the goal target is a formation candidate

# validate_sole_formation_candidate

# Validation check to make sure the goal holder is the only formation candidate

# validate_target_not_treaty_port

# Validation check to make sure the target state is not a treaty port

# validate_join_power_bloc

# Special validation for join power bloc war goal kind

# validate_colonization_rights

# Special validation for colonization rights war goal kind

# validate_force_nationalization

# Special validation for force nationalization war goal kind

# validate_foreign_investment_rights

# Special validation for investment rights war goal kind

# validate_regime_change

# Special validation for regime change war goal kind

# validate_contain_threat

# Special validation for contain threat war goal kind

# validate_revoke_claims

# Special validation for revoke claims war goal kind

# validate_increase_autonomy

# Special validation for increase autonomy war goal kind

# validate_take_treaty_port

# Special validation for take treaty port war goal kind

# validate_independence

# Special validation for independence war goal kind

# validate_conflicts_war_goals_holder

# Validate conflicts with war goals of the same type from holder

# validate_conflicts_war_goals_all

# Validate conflicts with war goals of the same type from all participating countries

# validate_conflicts_conquer_state

# Validate conflicts with war goals that conquer states (i.e. that have the conflicts_with_annex_state)

# validate_conflicts_annex_country

# Validate conflicts with war goals that annex countries (i.e. that have the conflicts_with_annex_country)

# validate_conflicts_make_subject

# Validate conflicts with war goals that make new subjects (i.e. that have the conflicts_with_make_subject)

# validate_conflicts_existing_subject

# Validate conflicts with war goals that make new subjects (i.e. that have the conflicts_with_make_subject)

# conflicts_with_make_subject

# Marks the war goal as potentially conflicting with make subject war goals

# conflicts_with_country_creation

# Marks the war goal as potentially conflicting with country creation war goals

# conflicts_with_annex_country

# Marks the war goal as potentially conflicting with annex country war goals

# conflicts_with_annex_state

# Marks the war goal as potentially conflicting with annex state war goals

# conflicts_with_existing_subject

# Marks the war goal as potentially conflicting with existing subject war goals

settings = { # Settings further customize how the war goal is treated in different checks. A war goal can only have one kind, but multiple settings.

setting_1

setting_2

}

execution_priority = 80

### List of Contestion Types

# control_target_state

# control_target_country_capital

# control_any_target_country_state

# control_any_target_incorporated_state

# control_own_state

# control_own_capital

# control_all_own_states

# control_all_target_country_claims

# control_any_releasable_state

contestion_type = control_type

## Target Type

#What kind of entity the war goal primarily "targets". This primarily defines how the game generates potential alternatives for each war goal type when selecting one from the diplomatic play panel. Most war goal kinds will require a specific target type to work well and can't be changed (i.e. Conquer State can't have a Treaty Article target type). This field primarily allows you to have custom war goals target different entities.

### List of Target Types

# Country

# Loops over enemy countries to generate war goal alternatives

# State

# Loops over states belonging to enemy countries

# Treaty Article

# Loops over article types and then enemy countries

target_type = target_type

possible = {

# trigger to determine if a goal with its target data is listed when selecting a war goal in the diplo play panel