Miscellaneous
Name | Description | Examples | Notes | Version Added |
---|---|---|---|---|
on_startup | Trigger the following commands at the first day of a new game (doesn't work with save loading). | on_startup = { effect = { ... } }
|
1.0 | |
on_daily | Triggers each day for every country separately (performance heavy, use carefully) | on_daily = { effect = { ... } }
|
Useful for scripted guis and mods adding new mechanics (can increment a variable daily e.g.). | 1.5.2 |
on_weekly | Triggers each week for every country separately | on_weekly = { effect = { ... } }
|
Useful for ai scripting. | 1.9 |
on_weekly_TAG | Triggers TAG country weekly | on_weekly_TAG = { effect = { ... } }
|
1.9 | |
on_monthly | Triggers each month for every country separately | on_monthly = { effect = { ... } }
|
1.9 | |
on_monthly_TAG | Triggers TAG country monthly | on_monthly_TAG = { effect = { ... } }
|
1.9 | |
on_nuke_drop | Trigger the following commands whenever a country drops a nuke. | on_nuke_drop = { effect = { set_global_flag = first_nuke_dropped } }
|
FROM is the nuked state. | 1.0 |
on_pride_of_the_fleet_sunk | Triggers when a country's pride of the fleet is sunk | on_pride_of_the_fleet_sunk = { effect = { ... } }
|
FROM is the killer country, ROOT is the country of that lost its pride of the fleet. | 1.6 |
on_naval_invasion | Triggers the following commands whenever a sea invasion is made. | on_naval_invasion = { effect = { ... } }
|
THIS state that is invaded, ROOT country that invades, FROM state that the invasion started | 1.9 |
on_paradrop | Triggers the following commands whenever a landing occurs. | on_paradrop = { effect = { ... } }
|
THIS state that is invaded, ROOT country that invades, FROM state that the invasion started | 1.9 |
Politics
Name | Description | Examples | Notes | Version Added |
---|---|---|---|---|
on_coup_succeeded | Trigger the following commands whenever a coup succeeds. | on_coup_succeeded = { effect = { random_other_country = { limit = { has_government = democratic original_tag = ROOT } set_politics = { elections_allowed = yes } } } }
|
1.0 | |
on_government_change | Trigger the following commands whenever a country switch government. | on_government_change = { effect = { ... } }
|
1.0 | |
on_ruling_party_change | Trigger the following commands whenever a country switch ideology. | on_ruling_party_change = { effect = { ... } }
|
1.9 | |
on_new_term_election | Trigger the following commands whenever an election happen or is called by the hold_election command. | on_new_term_election = { random_events = { 100 = usa.6 } }
|
1.0 | |
on_peaceconference_ended | Trigger the following commands whenever a peace conference ends. | on_peaceconference_ended = { effect = {...} }
|
ROOT is the winner, FROM is the loser. | 1.0 |
Diplomacy/War
Name | Description | Examples | Notes | Version Added |
---|---|---|---|---|
on_send_volunteers | Trigger the following commands whenever a country send volunteers to another. | on_send_volunteers = { effect = {...} }
|
ROOT is sender, FROM is receiver. | 1.9 |
on_border_war_lost | Trigger the following commands whenever a country lose a border war. | on_border_war_lost = { effect = { owner = { country_event = { id = china.14 } } } }
|
1.0 | |
on_declare_war | Trigger the following commands whenever a country declares war. | on_declare_war = { effect = { if = { limit = { ROOT = { tag = SOV } FROM = { has_idea = anti_soviet_pact } } } } }
|
FROM is war target. | 1.0 |
on_war | Trigger the following commands whenever a country has just entered a war. | on_war = { effect = { = {...} }
|
#THIS is country that has just gotten into a war. | 1.9 |
on_capitulation | Trigger the following commands whenever a country capitulates. | on_capitulation = { effect = {...} }
|
ROOT is capitulated country, FROM is winner. | 1.0 |
on_uncapitulation | Trigger the following commands whenever a country that was previously capitulated changes its status to no longer having capitulated. | on_uncapitulation = { effect = {...} }
|
ROOT is the country affected. | 1.6 |
on_annex | Trigger the following commands whenever a country is annexed. | on_annex = { effect = { = {...} }
|
ROOT is winner, FROM gets annexed. For civil wars on_civil_war_end is also fired. | 1.0 |
on_civil_war_end_before_annexation | Trigger the following commands just before FROM gets annexed, meaning the country and everything it owns still exists. | on_civil_war_end_before_annexation = { effect = { = {...} }
|
ROOT is winner, FROM gets annexed. It will also fire on_annex and on_civil_war_end. | 1.6 |
on_civil_war_end | Trigger the following commands whenever a civil war ends. | on_civil_war_end = { effect = { = {...} }
|
ROOT is civil war winner, FROM gets annexed. This will also fire on_annex. | 1.0 |
on_puppet | Trigger the following commands whenever a country is puppeted in a peace conference only. | on_puppet = { effect = { = {...} }
|
ROOT is the nation being puppeted, FROM is the overlord. | 1.0 |
on_liberate | Trigger the following commands whenever a country is liberated in a peace conference only. | on_liberate = { effect = { = {...} }
|
ROOT is the nation being liberated, FROM is the leader of the liberators. | 1.0 |
on_release_as_free | Trigger the following commands whenever a country is released. | on_release_as_free = { effect = { = {...} }
|
#ROOT is free nation FROM is releaser. | 1.0 |
on_release_as_puppet | Trigger the following commands whenever puppeting through the occupied territories menu during peace time (or when releasing from non-core but owned territory). | on_release_as_puppet = { effect = { = {...} }
|
ROOT is the nation being released, FROM is the overlord. | 1.0 |
on_war_relation_added | fired when two countries end up at war with each other (on_war is fired when a country goes to war against anyone and is not fired again when it enters war against another country unless it went to peace first) | on_war_relation_added = { effect = { = {...} }
|
ROOT is attacker, FROM is defender | 1.9.3 |
Faction
Name | Description | Examples | Notes | Version Added |
---|---|---|---|---|
on_create_faction | Trigger the following commands whenever a country create a faction. | on_create_faction = { effect = {...} }
|
FROM is the one that joins the faction. | 1.0 |
on_faction_formed | Trigger the following commands when a faction is formed. | on_faction_formed = { effect = { news_event = { id = news.159 } } }
|
1.0 | |
on_offer_join_faction | Trigger the following commands whenever a country is invited in a faction. | on_offer_join_faction = { effect = {...} }
|
FROM is the country invited. | 1.0 |
on_join_faction | Trigger the following commands for a faction leader whenever a country is invited in his faction. | on_join_faction = { effect = {...} }
|
FROM is faction leader on join faction requests. | 1.0 |
on_assume_faction_leadership | Trigger the following commands whenever a country assumes leadership of a faction. | on_assume_faction_leadership = { effect = {...} }
|
FROM is the former faction leader. | 1.6 |
on_leave_faction | Trigger the following commands whenever a country leave a faction. | on_leave_faction = { effect = { if = { limit = { AND = { tag = CAN NOT = { has_dlc = "Together for Victory" } } } drop_cosmetic_tag = yes } }
|
1.0 |
Autonomy
Name | Description | Examples | Notes | Version Added |
---|---|---|---|---|
on_subject_annexed | Trigger the following commands when a country annex a subject. | on_subject_annexed = { effect = { ... } }
|
ROOT is the subject, FROM is the overlord. | 1.0 |
on_subject_free | Trigger the following commands when a country grants freedom to a puppet. | on_subject_free = { effect = { ... } }
|
ROOT is the subject, FROM is the previous overlord. | 1.0 |
on_subject_autonomy_level_change | Trigger the following commands when the autonomy level of a puppet changes. | on_subject_autonomy_level_change = { effect = { ... } }
|
ROOT is the subject, FROM is the overlord. | 1.0 |
Governments in Exile
Name | Description | Examples | Notes | Version Added |
---|---|---|---|---|
on_government_exiled | Trigger the following commands whenever a country becomes a government in exile. | on_government_exiled = { effect = { = {...} }
|
ROOT is the government in exile, FROM is the country that is hosting the government in exile. | 1.6 |
on_host_changed_from_capitulation | Trigger the following commands whenever a country that is hosting a government in exile has capitulated. | on_host_changed_from_capitulation= { effect = { = {...} }
|
ROOT is the government in exile, FROM is the new country hosting the government in exile, FROM:FROM is the old country that was hosting the government in exile. | 1.6 |
on_exile_government_reinstated | Trigger the following commands whenever a country has returned from governing in exile. | on_exile_government_reinstated = { effect = { = {...} }
|
ROOT is the government in exile, FROM is the country that was hosting the government in exile. | 1.6 |
States
Name | Description | Examples | Notes | Version Added |
---|---|---|---|---|
on_state_control_changed | Trigger the following commands when a state's controller changes. | on_state_control_changed = { effect = { ... } }
|
ROOT is new controller, FROM is old controller, FROM.FROM is state ID. | 1.0 |
Wargoals
Name | Description | Examples | Notes | Version Added |
---|---|---|---|---|
on_justifying_wargoal_pulse | Trigger the following commands whenever the country is targeted by a wargoal under justification. | on_justifying_wargoal_pulse = { random_events = { 100 = war_justification.1 } }
|
FROM = target nation. Checked every day. | 1.0 |
on_wargoal_expire | Trigger the following commands whenever a wargoal expire. | on_wargoal_expire = { random_events = { 100 = war_justification.301 } }
|
FROM is the wargoal owner. | 1.0 |
Unit Leader
Name | Description | Examples | Notes | Version Added |
---|---|---|---|---|
on_unit_leader_created | Trigger the following commands when an army leader is created. | on_unit_leader_created= { effect = {...} }
|
FROM is owner country, ROOT is the unit leader | 1.5 |
on_army_leader_daily | Trigger the following commands on an army leader each day. | on_army_leader_daily = { effect = {...} }
|
FROM is owner country. | 1.0 |
on_army_leader_won_combat | Trigger the following commands whenever an army leader won a combat. | on_army_leader_won_combat = { effect = {...} }
|
FROM is owner country. | 1.0 |
on_army_leader_lost_combat | Trigger the following commands whenever an army leader lost a combat. | on_army_leader_lost_combat = { effect = {...} }
|
FROM is owner country. | 1.0 |
on_unit_leader_level_up | Trigger the following commands when a leader gain a level. | on_unit_leader_level_up = { effect = {...} }
|
1.0 | |
on_army_leader_promoted | Trigger the following commands whenever an army leader is promoted. | on_army_leader_lost_combat = { effect = { add_timed_unit_leader_trait = { trait = recently_promoted days = 100 } } }
|
1.0 |
Aces
Name | Description | Examples | Notes | Version Added |
---|---|---|---|---|
on_ace_promoted | Trigger the following commands whenever an ace is created. | on_ace_promoted = { random_events = { 100 = ace_promoted.1 } }
|
FROM = ace. | 1.0 |
on_ace_killed | Trigger the following commands whenever an aces is killed. | on_ace_killed = { random_events = { 100 = ace_died.1 } }
|
FROM = ace. | 1.0 |
on_ace_killed_on_accident | Trigger the following commands whenever our aces died on accident. | on_ace_killed_on_accident = { random_events = { 100 = ace_died.1 } }
|
FROM = our ace died in accident. | 1.9 |
on_non_ace_killed_other_ace | Trigger the following commands whenever non ace killed enemy ace. | on_non_ace_killed_other_ace = { FROM = { random_events = { 100 = ace_died.1 } } }
|
FROM = enemy ace. | 1.9 |
on_ace_killed_by_ace | Trigger the following commands whenever an aces is killed by another ace. | on_ace_killed_by_ace = { random_events = { 100 = ace_killed_by_ace.1 } }
|
FROM = our ace, PREV = enemy ace, has killed FROM. | 1.0 |
on_ace_killed_other_ace | Trigger the following commands whenever an aces is killed by another ace (surviving ace side). | on_ace_killed_other_ace = { random_events = { 100 = ace_killed_other_ace.1 } }
|
FROM = our ace, PREV = enemy ace, killed by FROM. | 1.0 |
on_aces_killed_each_other | Trigger the following commands whenever two aces kill each other in air duel. | on_aces_killed_each_other = { random_events = { 100 = aces_killed_each_other.1 } }
|
FROM = ace, PREV = enemy ace. | 1.0 |
La Résistance
Name | Description | Examples | Notes | Version Added |
---|---|---|---|---|
on_operation_completed | Trigger the following commands whenever an operative completed. | on_operation_completed = { effect = {...} }
|
THIS - the operative, ROOT - the initiating country, FROM - the target country. | 1.9 |
on_operative_detected_during_operation | Trigger the following commands whenever an operative dies. | on_operative_death = { effect = {...} }
|
THIS - the operative, ROOT - the killer country (optional), FROM - the country the operative is operating for, FROM.FROM - operation state (will only be set if the operation has a specific selection_target). | 1.9 |
on_operative_on_mission_spotted | Trigger the following commands whenever an operative performing an offensive mission in a country. | on_operative_on_mission_spotted = { effect = {...} }
|
THIS - the operative, FROM - the country the operative was performing its mission in, ROOT - the country the operative is operating for. | 1.9 |
on_operative_captured | Trigger the following commands whenever an operative is captured. | on_operative_captured = { effect = {...} }
|
THIS - the operative, ROOT - the country the operative was performing its mission in, FROM - the country the operative is operating for. | 1.9 |
on_operative_death | Trigger the following commands whenever an operative dies. | on_operative_death = { effect = {...} }
|
THIS - the operative, ROOT - the killer country (optional), FROM - the country the operative is operating for. | 1.9 |
on_fully_decrypted_cipher | Trigger the following commands whenever a country fully decrypts cipher of a target country. | on_fully_decrypted_cipher = { effect = {...} }
|
THIS - the target country that its cipher is decrypted, FROM - the decrypter country. | 1.9 |
on_activated_active_decryption_bonuses | Trigger the following commands whenever a country activates its active cipher bonuses against a target. | on_activated_active_decryption_bonuses = { effect = {...} }
|
THIS - the target country, FROM - the country that activates its bonuses. | 1.9 |
模组制作
文件 | 效果 • 条件 • 定义 • 修正 • 修正列表 • 作用域 • 本地化 • on action • 数据结构 (标记, 临时标记, 国家别名, 变量, 数组) |
脚本 | 成就修改 • AI修改 • AI focuses • 自治领修改 • 权力平衡修改 • 剧本/标签 (游戏规则)• 建筑修改 • 人物修改 • 修饰性TAG修改 • 国家创建 • 军队修改 • 决议制作 • 装备修改 • 事件修改 • Idea修改 • 意识形态修改 • 军工商修改 • 国策制作 • 资源修改 • Scripted GUI • 科技制作 • 单位修改 |
地图 | 地图 • 省份 • 补给区域 • 战略区域 |
图形图像 | 界面 • 图形资产 • 实体模型 • 后期特效 • 离子效果 • 字体 |
装饰性 | 肖像 • 命名列表 • 音乐 • 音效 |
其他 | 控制台指令 • 故障排除 • 模组结构 • 成就代码分析 • Mod相关 • Nudger修改 |