Community Imperial: EU IV Dev Diary — 13 февраля 2017 - Europa Universalis IV - Paradox Interactive - Library - Community Imperial

# Intro
Since there was a lot of interest expressed in the last dev diary I thought I'd write a small guide to help you get started modding the new missions system. Hopefully this will make it easier for you to start working on creating and updating mods for it. As we are still working on the immersion pack minor things might change, be added or removed. I will do my best to update you in this thread as we are going forward.
For an overview on how the new missions work from a players perspective have a look at last weeks dev diary: https://imtw.online/...J3bm9yL6MHc0RHa
Let's start with explaining a few terms I am going to use in this guide.

# Glossary
Slot - A column in the missions grid (1 based indexing)
Tier - A row in the missions grid (1 based indexing)
Series - One or more missions in one slot (Can span tiers)
Potential - Trigger that must be fulfilled for a series to be visible
Priority (AI) - Determines what missions the AI picks to work towards
Weight (AI) - Determines the worth of a mission to the AI

# Overview & Series
Missions for a country are composed of one or more acyclic graphs laid out in a grid view. This means missions can have any amount of other missions as a prerequisite and missions can branch out into any amount of other distinct missions. The grid can be as wide and tall as you like, it will automatically expand to fit all missions.

All missions are part of a series. A series is used to set various parameters that determine layout, visibility, appearance and AI behavior:
slot (Integer): Used to set the slot for the series
generic (Boolean): Provides a way to control series precedence
ai (Boolean): Turns AI for this series on or off
potential (Trigger): Determines visibility for the player
has_country_shield (Boolean): If set, the player country flag will be shown for all missions in this series

As you can see series are basically used to conveniently set parameters for any number of missions. Of course you are not required to use it that way, you can use one series per mission as well.
The layout of the mission nodes is determined by the tier set for the missions and the slots set for the series, there is no automatic layout. If no tier is set for a mission, missions in a series will be laid out top to bottom, starting in the first free tier in the slot.

# Missions
Let's have a look at a simple mission:
conquer_franken = {
icon = mission_conqueror_icon
required_missions = { conquer_ansbach }
trigger = {
franconia_area = {
type = all
country_or_non_sovereign_subject_holds = ROOT
}
}
effect = {
add_adm_power = 100
add_country_modifier = {
name = "bavarian_ambition"
duration = 7300
}
}
provinces_to_highlight = {
area = franconia_area
NOT = {
country_or_non_sovereign_subject_holds = ROOT
}
}
}

We start with the mission key, which also doubles as part of the key for the localization (name + _title for the title and name + _desc for the description). The icon references a sprite in a .gfx file. Required missions can be left out or left empty, and can also contain multiple missions (Comma separated). The trigger describes the conditions you need to fulfill to be able to complete the mission, the effect what you get when you complete it. These work just like triggers and effects anywhere else. There are a few more fields you can set for a mission:
has_country_shield, ai (Booleans): Same as in series, setting this will overwrite what was set in the series
completed_by (Date): If set, this mission will be marked completed when starting the game later than the given date
position (Integer): The tier for this mission
ai_priority (MTTH): Priority for this mission for the AI (See notes on AI below)
ai_weight (MTTH): Weight/Worth of this mission for the AI (See notes on AI below)
provinces_to_highlight: Will highlight provinces that match this trigger when you hover over the missions requirements and center highlighted provinces when you click on the icon

# Series precedence & Potential
You can have any amount of series of any size in a slot, and as long as they don't overlap and their potential is fulfilled they will be visible and available to the player. If series do overlap, precedence is given to the series with "generic" set to false. If two or more series with the same precedence (Either generic or not) compete for the same spot, you will get an error (Check error.log) and the first series read from disk will get precedence.
The potential is only evaluated at the start of the game and when executing the effect swap_non_generic_missions.

# Arrows
The arrows showing the dependencies will be laid out automatically. However, there are a few limitations you should be aware of.
Arrows can be laid out horizontally and vertically but not diagonally, that means that required missions can be at any tier above in the same slot and in any slot in the tier directly above. Same goes for follow-up missions, they can be in any tier below in the same slot and in any slot in the tier directly below.
Note that, regardless of the arrows being able to show the dependency, the dependencies you define will work no matter where you put the missions, so if you'd want to, you could just manually add arrows and hide the automatically added ones.

# Some notes on the AI
The AI will pick missions based on their priority and adjust it's strategy according to their weight to try and fulfill missions. The AI understands many triggers you would usually use for missions, but not all of them, so your results may vary. Have a look at our missions to see what the AI can understand.

I'm excited to see how you use this new system to create and/or enhance your mods. If you have any questions at all please do not hesitate to contact me. Suggestions for improvements or additional features are of course also very welcome.

ENG_ideas = {
start = {
infantry_power = 0.10 # agincourt
global_unrest = -1 # magna carta, parliament
bonus = {
free_leader_pool = 1
royal_navy = {
navy_tradition = 0.25
heavy_ship_power = 0.10
eltham_ordinance = {
production_efficiency = 0.1
secretaries_of_state = {
diplomatic_upkeep = 1
navigation_acts = {
trade_efficiency = 0.1
city_upon_a_hill = {
global_colonial_growth = 20
eng_red_coats = {
fire_damage = 0.1
british_bill_of_rights = {
years_of_nationalism = -5
GBR_ideas = {
start = {
naval_morale = 0.20
heavy_ship_power = 0.15
bonus = {
navy_tradition = 1
gbr_acts_of_union = {
diplomatic_annexation_cost = -0.15
max_states = 3
british_merchant_navy = {
global_tariffs = 0.15
gbr_the_royal_society = {
technology_cost = -0.05
sick_and_hurt_board = {
sailors_recovery_speed = 0.10
sailor_maintenance_modifer = -0.1
reform_of_comission_buying = {
discipline = 0.05
british_industrialization = {
global_trade_goods_size_modifier = 0.2
britanna_rules_the_waves = {
leader_naval_manuever = 1
blockade_efficiency = 0.33

# Manx ideas

KOI_ideas = {

start = {
global_sailors_modifier = 0.2
global_ship_cost = -0.1
}
bonus = {
discipline = 0.05
mann_stanleys = {
diplomats = 1
"The Stanley dynasty has ushered in an era of peace and prosperity for the Manx people. Their skill at diplomacy ensures the safety of the island from both political and military threats to our sovereignty."
}
mann_kings = {
core_creation = -0.10
"Despite its size, Mann is recognized as a de jure Kingdom. But what is a Kingdom without land? We must acquire more."
}
mann_tynwald = {
advisor_pool = 1
"The Tynwald is the Manx high court. The House of Keys, led by the most powerful families of Mann, act as a national jury that give advice on legal matters. As the state expands however, its administrative needs multiply. The Tynwald must become a permanent institution, akin to a parliament with the power to write new laws."
}
mann_and_the_isles = {
naval_morale = 0.15
"In centuries past Mann was the heart of a great realm that spanned across the Irish Sea. It is time to revive the tradition of shipbuilding so that we can restore this empire."
}
mann_act_of_settlement = {
global_unrest = -1
"It is time to finally settle the status of peasant landholding on Mann. The Act will guarantee the basic rights of citizens and become a basis for the future development of our constitution."
}
mann_burn_the_heretic = {
global_heretic_missionary_strength = 0.02
"Witchcraft and heresy are ever-present dangers to the faithful. Suffer not the witch and the heretic to live."
}
mann_act_of_revestment = {
diplomatic_annexation_cost = -0.15
“There are too many petty nobles holding minor titles and withholding rents from their land. The Act Of Revestment will revoke these titles so that the monarch can rule more directly."
}

CRN_ideas = {
start = {
global_regiment_recruit_speed = -0.10
production_efficiency = 0.1
}
bonus = {
land_morale = 0.10
crn_stannary_parliaments = {
global_unrest = -2
"The tin miners of Cornwall have long upheld their special legal rights. These include tax exemption and exclusive prospecting rights, but most importantly the right to be tried only before a Stannary Court with a jury composed of their fellow miners. A Stannary Parliament oversees and revises these rights, keeping the mining population productive and content."
}
crn_cornish_rebels = {
hostile_attrition = 1
"The Cornish people are quick to rise up against oppression and misrule. Hostile armies entering their lands receive an unfriendly welcome."
}
crn_prayer_book_traditionaliism = {
tolerance_own = 2
"Farmers, miners, and landlords alike are extremely reluctant to accept changes to religious prayer books. Many complain that prayer books written in English exclude a significant part of the population who speak only Cornish, though others point out they could not read the old Latin prayers either. Regardless, a traditionalist attitude to religion pervades Cornish society and binds it together."
}
crn_pirates_of_penzance = {
capture_ship_chance = 0.1
privateer_efficiency = 0.2
"Oh, better far to live and die. Under the brave black flag I fly, Than play a sanctimonious part,With a pirate head and a pirate heart."
}
crn_royalist_army = {
land_forcelimit_modifier = 0.2
"Ever staunch monarchists, the Cornish people are quick to rally to the defence of the crown against republican revolutionaries. Despite Cornwall’s relatively low population, it can raise a surprisingly large levy of determined soldiers willing to fight for King and country."
}
crn_gear_rout = {
movement_speed = 0.15
"Even should we lose the war, enough of us will likely flee the field that they will live to fight again another day."
}
crn_arthurian_romanticism = {
prestige_decay = -0.01
"A recent revival of interest in Celtic culture has created an interest in Arthurian legend. Tintagel Castle is said to be the place of King Arthur's conception, and acts as a focal point of a renewed Celtic identity in Cornwall."
}

highland_scottish_ideas = {
start = {
garrison_size = 0.25
heir_chance = 0.5
}
bonus = {
manpower_recovery_speed = 0.1
hsc_the_wallace = {
land_morale = 0.15
"We reide of ane rycht famous of renowne,\nOf worthi blude that ryngis in this regioune,\nAnd hensfurth I will my proces hald,\nOf Wilyham Wallas yhe haf hard beyne tald."
}
hsc_highland_clans = {
hostile_attrition = 1
"The Highland clans are a contentious people. As much as they resent one another, they resent even more the prospect of foreign invaders ruling their ancestral lands. Of course, when the threat of foreign invasion is over, the clans will resume their infighting. There can only be one."
}
hsc_storm_the_castle = {
siege_ability = 0.10
"Whatever problems arise in the Highlands, few can be resolved without at some point storming a castle. Our experience in these matters goes back generations and is a highly transferable skill."
}
hsc_episcopalianism = {
religious_unity = 0.1
stability_cost_modifier = -0.1
"There are many competing ideas about how the Church in the Highlands should be structured and what doctrines should be adopted following the advent of the Reformation. We have opted to retain the hierarchical Bishopric model, which allows for both a clear structure for Church proceedings and a degree of doctrinal independence for clergymen."
}
hsc_highland_charge = {
shock_damage = 0.15
"Gunpowder weapons have revolutionized the battlefield, and the warriors of the Highlands must adapt. An aggressive new shock tactic has been developed by our generals. Our soldiers will run, preferably downhill, straight into the first enemy volley, firing as they go. After shooting, they will draw more traditional weapons and enter the melee. The speed required for this tactic necessitates that our warriors wear very little in the way of clothing however."
}
hsc_arming_act = {
global_manpower_modifier = 0.1
"Our oppressors would confiscate our weapons to rob us of the ability to resist. The Arming Act requires all Highlanders to own and train with a firearm."
}
hsc_ossian = {
prestige = 1
"The Romantic revival of Gaelic culture is exemplified in a collection of poems written under the pseudonym 'Ossian'. They tell ancient folkloric tales that remind the Highlanders of their storied past."