Table of Contents

Performance Tips

Generalized performance tips for the Millennium Dawn modding team.

Focus Trees

The following section delineates a stylization guide for Millennium Dawn and coding best practices for the Hearts of Iron IV feature “Focus Trees”.

Link to Focus Tree Modding Wiki

Best Practices

Millennium Dawn Specific Code Styling Requirements

Focus trees can be standardized using the script in tools using standardize_focus_tree.py.

Example Focus Tree Structure

focus_tree = {
    id = greece_focus

    country = {
        factor = 0
        modifier = {
            tag = GRE
            add = 100
        }
    }

    shared_focus = USoE001
    shared_focus = POTEF001

    continuous_focus_position = { x = 2350 y = 1200 }
}

focus = {
	id = SER_free_market_capitalism
	icon = blr_market_economy

	x = 5
	y = 3
	relative_position_id = SER_free_elections

	cost = 5

	# allow_branch = { }
	prerequisite = { focus = SER_western_approach }
	# mutually_exclusive = { }
	search_filters = { FOCUS_FILTER_POLITICAL }

	available = {
		western_liberals_are_in_power = yes
	}
	# bypass = { }
	# cancel = { }

	# will_lead_to_war_with = TAG -- Only needed if you are giving a nation a war goal or preparing for conflict with another nation

	# complete_tooltip = { } -- This is not needed unless you want a specific thing always displayed
	# select_effect = { }
	completion_reward = {
		log = "[GetDateText]: [Root.GetName]: Focus SER_free_market_capitalism"
		add_ideas = SER_free_market_idea
	}
	# bypass_effect = { }

	ai_will_do = {
		base = 1
	}
}

Decisions

The following section delineates a stylization guide for the Millennium Dawn and coding best practices for the Hearts of Iron IV features Decisions/Missions.

Link to Decision/Modding Wiki

Best Practices

Example Decision Structure

URA_world_opr = {
    allowed = { original_tag = URA }
    icon = GFX_decision_sovfed_button

    cost = 50
    days_remove = 400

    visible = {
        country_exists = OPR
        OPR = {
            OR = {
                has_autonomy_state = autonomy_republic_rf
                has_autonomy_state = autonomy_kray_rf
                has_autonomy_state = autonomy_oblast_rf
                has_autonomy_state = autonomy_okrug_rf
            }
        }
    }

    complete_effect = {
        log = "[GetDateText]: [Root.GetName]: Decision URA_world_opr"
        OPR = { country_event = { id = subject_rus.121 days = 1 } }
    }

    ai_will_do = {
        factor = 10
    }
}

Events

Best Practices

Example Event Structure

country_event = {
    id = france_md.504
    title = france_md.504.t
    desc = france_md.504.d
    picture = GFX_france_mcdonalds_bombing
    is_triggered_only = yes

    option = {
        name = france_md.504.a
        log = "[GetDateText]: [This.GetName]: france_md.504.a executed"
        set_party_index_to_ruling_party = yes
        set_temp_variable = { party_popularity_increase = -0.01 }
        set_temp_variable = { temp_outlook_increase = -0.01 }
        add_relative_party_popularity = yes

        ai_chance = {
            base = 1
        }
    }

	option = {
		name = france_md.504.b

		ai_chance = {
			base = 0
		}
	}
}

Ideas

Best Practices

Example Country Idea Structure

BRA_idea_higher_minimun_wage_1 = {
    name = BRA_idea_higher_minimun_wage
    allowed_civil_war = { always = yes }

    picture = gold

    modifier = {
        political_power_factor = 0.1
        stability_factor = 0.05
        consumer_goods_factor = 0.075
        population_tax_income_multiplier_modifier = 0.05
    }
}

Code Formatting Rules

Indentation

Brackets

Subideology Localization Format

TAG.conservatism: "£PARTY_ICON (ABBRV) - NAME OF PARTY"
TAG.conservatism_icon: "£PARTY_ICON"
TAG.conservatism_desc: "(Dominant Ideology of the Party) - NAME OF PARTY (NAME OF LANGUAGES IN ALL NATIVE LANGUAGES FOR THE COUNTRY, ABBRV)\n\n(Description)"

Example:

MOR.conservatism: "£MOR_NRI (RNI) - National Rally of Independents"
MOR.conservatism_icon: "£MOR_NRI"
MOR.conservatism_desc: "(Classic Liberalism) - National Rally of Independents (Arabic: Altajamue Alwataniu Lil'ahrar, French: Rassemblement National des Indépendants, Standard Moroccan Tamazight: Agraw Anamur y Insimann, RNI)\n\nNominally a social-democratic party, the party often cooperates with other parties with liberal orientation and is heavily described as pro-business and liberal. Formed in 1978 by then-Prime Minister Ahmed Osman the party has consistently remained a major player in Moroccan politics. Furthermore, the party is a national observer of the Liberal International and is affiliated with the Africa Liberal Network and the European People's Party."

Military-Industrial Organisations (MIO)

Guidelines on Companies

Example MIO Company Structure

CHI_norinco_manufacturer = {
	allowed = { original_tag = CHI }
	icon = GFX_idea_Norinco_CHI

	task_capacity = 18

	equipment_type = {
		Inf_equipment
		artillery_equipment
		L_AT_Equipment
		H_AT_Equipment
		util_vehicle_equipment
		mio_cat_all_armor
		sam_missile_equipment
		guided_missile_equipment
	}

	research_categories = {
		CAT_infrastructure
		CAT_excavation_tech
		CAT_fuel_oil
		CAT_missile
		CAT_armor
		CAT_artillery
		CAT_inf
	}

	tree_header_text = {
		text = "Infantry Equipment & Mobility"
		x = 1
	}
	tree_header_text = {
		text = "Armored Vehicles & AFV Systems"
		x = 5
	}
	tree_header_text = {
		text = "Missiles, Air Defence & Drones"
		x = 8
	}

	initial_trait = {
		name = CHI_norinco_company_trait

		equipment_bonus = {
			reliability = 0.03
			build_cost_ic = -0.03
		}

		organization_modifier = {
			military_industrial_organization_research_bonus = 0.08
			military_industrial_organization_funds_gain = 0.02
		}
	}
}

Guidelines on Traits

Example MIO Trait Structure

trait = {
    token = CHI_norinco_trait_suppressed_pdw_systems
    name = CHI_norinco_trait_suppressed_pdw_systems
    icon = GFX_generic_mio_trait_icon_smallarms_attack

    relative_position_id = CHI_norinco_trait_field_proven_rifle_design
    position = { x = -1 y = 1 }
    all_parents = { CHI_norinco_trait_field_proven_rifle_design }

    limit_to_equipment_type = {
        Inf_equipment
    }

    equipment_bonus = {
        soft_attack = 0.06
        reliability = 0.02
    }

    on_complete = {
        if = {
            limit = {
                check_variable = { free_trait_picks > 0 }
            }
            add_to_variable = { free_trait_picks = -1 }
        }
        else = {
            FROM = {
                small_expenditure = yes
            }
        }
    }

    ai_will_do = {
        base = 10
        modifier = {
            factor = 0
            check_variable = { FROM.interest_rate > 8 }
        }
    }
}