Update v2.0.5:

New Defines

BATTLE_COMMANDER_ESCAPE_CAPTURE

If the loser army was not overrun, a random integer will do a module check against this value

If the rolled value is less than the charisma of the army leader, they will charm their way out of the situation and avoid capture

 

 

BATTLE_COMMANDER_CAPTURE_MARTIAL_CHECK

This check is done if no charming out of the situation has happened before, and is only done if the winning army has a valid leader. If there are no leaders on the winning side this check is not done

Mercenaries cannot be captured this way and are excluded from this check

If the loser army was overrun OR if a random rolled integer with a modulo against this define is smaller than half the martial value of the highest martial winning commander, the loser commander gets captured

 

 

BATTLE_MIN_CASUALTIES_IMPACT

Casualties impact is always the difference of tactics between the armies of the countries involved

This defines a minimum amount of casualties that will always happen regardless of the difference

 

 

BATTLE_NO_POPULARITY_LOSS_IF_RATIO_AS_ATTACKER

If the attacker has this many times more units than the defender and loses, there is no popularity loss

 

 

BATTLE_NO_POPULARITY_LOSS_IF_RATIO_AS_DEFENDER

If the defender has this many times more units than the attacker and loses, there is no popularity loss

 

 

END_OF_COMBAT_STRENGTH_RATIO_MODIFIER

This amplifies the strength ratio by the given define, so it increases or decreases the impact that the ratio has for end of combat morale boost

 

 

END_OF_COMBAT_MORALE_BOOST_MAX

This defines up to how much of the total morale a unit can regain at the end of combat

 

 

MINIMUM_LOSS_RATIO_THRESHOLD_FOR_BATTLE_RESULT

The battle result is only stored if this number is surpassed for losses in combat

 

 

OVERRUN_FACTOR_FOR_INITIAL_CHECK

This is checked once at the start of combat, if the difference is equal to or bigger than this the enemy army is instantly overrun

 

 

TAG_LIMIT

This controls how many countries can be created at maximum during a session. It allows each mod to customize the amount based on their needs. This does impact performance

 

 

These defines were previously hardcoded and inaccessible to be changed. They have now been exposed for you to play around with. The explanations for this are also present as comments in 00_defines.txt

 

New Effects

Scope: Character

 

set_can_inherit = bool

The game plays as usual when this is set to true for a character. However when set to false the character cannot inherit anything anymore unless it is set to true again. This includes worldly possessions as well as leadership of a country. When this is set to false successors for the country are instantly recalculated.

 

 

set_can_marry = bool

The game plays as usual when this is set to true for a character. However this allows modders to play around with marriage, as setting this to false means the character can never marry, unless it is set to true again.

 

 

Scope: Country

allow_trade_goods = goods

disallow_trade_goods = goods

These two allow/disallow the AI from trading away the goods specified. This allows modders to add more interesting gameplay elements around trade.

 

Trade goods can be found in common/trade_goods. A valid example is grain

 

call_omen = deity_category

This instantly calls an omen for the given deity category. The same way a player would do it from the UI, but there is no cost associated with it.

 

Deity categories can be found in common/deity_categories. A valid example is economy

 

end_truce = country

This instantly ends the truce that the scope country has with the target country. Truces are unilateral in nature, so both countries may have a truce with one another or it is possible for only one if the countries involved to have a truce with the other.

 

 

start_character_interaction = { type = character_interaction, character = character }

This allows you to start an interaction with the target character, as a player usually would via the UI. This allows mods to further customize the experience without necessarily having to touch the UI, or by making actions available that were previously only available through UI or with cumbersome scripts.

 

Character interactions can be found in common/character_interactions. A valid example is adopt_to_family

 

Scope: CountryCulture

 

set_levy_template = template

This allows you to change the levy template for a culture in a specific country without touching the same culture in other countries, allowing you to reward players for specific behavior. It is important to note here that there are various tooltips in the game that show a culture´s composition that will not properly reflect changes from this, as they have no context for which country the composition is being displayed. The Raise Levy tooltip will always reflect the proper value.

 

Levy templates can be found in common/levy_templates. A valid example is levy_anatolian

 

Scope: Province

 

start_building_construction = building

cancel_building_construction = building

These two start/cancel the construction of a building in the given province.

 

Buildings can be found in common\buildings. A valid example is fortress_building

 

change_climate = climate

You can change the climate of the province to one of the following: mild_winter, normal_winter, severe_winter, arid and none

 

 

Scope: War

 

war_score_value = { target = country, local_var = name }

This will save the war score of the target country that is a participant in the war scope that you are in to the local variable with the name provided. The variable does not have to exist yet. So if you are ROM, fighting against TRE, and you fetch the war score value of TRE, it will save their war score against the enemy war leader (ROM in this case if you are the war leader). So it will be the inverse of what you see as a player of ROM.

 

 

New Triggers

Scope: Character

 

can_inherit = bool

Simple trigger that returns the value previously set by can_inherit. It returns true by default.

 

 

can_marry = bool

This checks against the value that has previously been set by set_can_marry, but it also checks the default marriage conditions. This has allowed us to improve some of the script for the game, to simplify the marriage checks and unify them. To make it easier for modders to adopt the changes, here is a document that has all of the relevant script changes from the base game:

https://docs.google.com/document/d/1Ft_BPHm-dWB-IuJ9o8UG4cAutb79tP7jzsVffxvsCXA

 

 

 

Scope: Country

 

has_claim = province

Checks if the country has a claim on the given province.

 

 

is_trade_goods_allowed = goods

Checks if the given trade goods are allowed to be traded away by the scope country. This can be modified with the effects listed above.

 

Trade goods can be found in common/trade_goods. A valid example is grain

 

 

Scope: Province

 

is_holy_site_of_deity = deity

Checks if the given province is a holy site for the given deity.

 

Deities can be found in common/deities. A valid example is deity_alilat

 

is_holy_site_of_religion = religion

Checks if the given province is a holy site for the given religion.

 

Religions can be found in common/religions. A valid example is roman_pantheon

 

General Modding

 

Added modifier script access, on the scopes that have modifiers: country, character & province. Accessible via modifier:modifier_name

Added MakeScopeBool, MakeScopeFlag, MakeScopeValue

Added SetVariableIf, SetOrToggle, ClearVariableIf, ClearMultipleVariables to the VariableSystem

Added support for optional exists equality operator ?=

Added support for save_scope_value_as and save_temporary_scope_value_as

Added script list region_governorship

The automatic legacy character setup conversion has been moved to a console command: legacy_character_setup_conversion

The setup editor no longer automatically saves every time a province is selected. It now uses the console command only.

Made religion_category customizable, so mods can add new categories. Also made it localizable: religion_category_X and religion_pantheon_X where X is the category name

Religions can now also be customized with is_monotheistic

Added error logs to the set_party_leader effect

Fixed every_province, random_province and any_province: they now work properly

Updated script_docs to report the proper modifier categories, and this also supports showing multiple categories now that they are used for

Omen and construction costs have been removed when called from script, so that custom costs may be assigned

Added GetLevyTemplate to CountryCulture promote

 

 

 

GUI

SetHighlightGovernorship = governorship and SetHighlightState = state have been added

PdxGuiWidget.CountVisibleChildren and PdxGuiWidget.GetChildrenCount have been added

GetGlobalVariable and GetGlobalList have been added

AddList has been added

Added GetLevyTemplate to CountryCulture, as unlike the one from a country, this takes into account the one set via set_levy_template

Other

has_culture_group and set_country_religion now support more than just hardcoded values, they now have scope support

Added Log.ClearAll & Log.ClearErrorLog console commands

Overlords can now construct buildings in certain subject types, set with can_build in the subject type

 

 

 

The Rest

 

AI

The AI now disbands units created via create_unit effect and will no longer keep them around forever and unnecessarily hurt its own economy

 

 

Multiplayer

Moving pops too quickly, like mass moving slaves would previously cause you to pay for the move but not actually move any pops. This has been fixed, it will now always move the pop if it can, and if it cannot, like if the player clicked more often than pops are available to move, then no cost will be deducted

 

 

Combat Simulator

Fixed up combat simulator crashes. Also enhanced functionality:

location = province has moved to being defined once per simulation instead of per unit.

is_player_attacker = bool has been added so choosing a battle side is now possible that way.

enemy = country has been added. This means you can simulate combat against other nations. If those are non-barbarian nations and no war exists, a war will be declared automatically.

 

 

GUI

The Find dialog will now also return governorships and states in addition to the previous result types

Added climate map mode

 

 

Other

Overlords can now construct buildings in certain subject types

Holdings are now removed properly when characters move countries or the province changes owners. This fixes an issue where third party country provinces are dragged into an unrelated war. Also only owner-controlled provinces join civil wars now.

Fixed location of Sparta so that it does not visually disappear when a road is built through the province

Various script fixes related to marriage checks, and adjusted to the new can_marry trigger

Arrange marriage now available in countries with custom ruler setups, it is now allowed for the ruler family instead of just close relatives

Mercenaries can no longer be marriage targets

Fixed a crash that would occur for players using mods that do not have certain gfx assets available, for example from the free DLC

Revolt countries now instantly recalculate their cached data, this fixes various issues like integrated cultures and levies now being correct instead of only being at the right value at the next monthly tick

Fixed tooltip that stated achievements would only work with no mods enabled. The tooltips now represent the correct state, which was changed with 2.0.4, as they can be gained with mods

Fixed 3D map objects like forts and ports not being removed when a province is decolonized. Also now instantly recalculates province dominant culture, religion and modifiers when pops are removed

Fixed governor policies script bug with country cultures

Fixed befriending script bug not being removed properly on ruler change

Fixed DECLWAROTHER_MAP being displayed unlocalized on the map, this only worked correctly in the French language before

When switching from a government with a co-ruler to a government without one. The existing co-ruler is now removed properly, and will no longer stick around forever causing issues

Fixed crash on peace offer, when the country to receive a state was not the same as the one making the offer, and the offering country had no province in the area

Secondary war participants now also see peace deals as popups

Prevented the game from crashing when exceeding tag limit

Fixed most issues with the formable Crete tag because the tag started with an invalid character