Effects

###############################
# Effects
###############################
save_event_target_as = name             # save an event target
save_global_event_target_as = name      # save a global event target
clear_global_event_target = name        # clear a global event target
clear_global_event_targets = yes        # clear all global event targets

custom_tooltip = example_tooltip        # Add custom localisation tooltip

set_global_flag = example_flag          # Set global flag
remove_global_flag = example_flag       # Remove global flag

set_timed_global_flag                   # Sets a timed global flag
= {
    flag = day_0
    days = 7
}

break                                   # break execution of effects
while                                   # repeats contained effects until limit fails or count is reached
= {
    limit = { }
}
switch                                  # Switches effect based on triggers
= {
    trigger = ?
    ? = { }
    ? = { }
}


create_cluster = { ? }                  # creates a cluster centered around the specified spatial object
load_parameters = { ? }                 # Clears current parameters and loads new parameters from target

###############################
# Events
###############################
is_advisor_event = yes
is_triggered_only = yes
hide_window = yes
location = FROM
diplomatic = yes                    # Sets the event to be a diplomatic event between player and another country
option = { is_dialog_only = yes }
auto_opens = yes
fire_only_once = yes

###############################
# Country
###############################
country_event = { id = example_event.1 days = 30 }  # fires a Country event
tooltip = "text"                                    # just a tooltip

abort_special_project = "name"              # Aborts a special research project for a country
add_physics_research = 100                  # Adds stored Physics research points to a county
add_society_research = 100                  # Adds stored Society research points to a county
add_engineering_research = 100              # Adds stored Engineering research points to a county
add_minerals = 500                          # Adds Minerals to a planet, tile or country
add_energy = -75                            # Adds a sum of energy to a country
add_influence = -100                        # Adds influence to a county
add_research_option = tech_fission_power    # Gives a specific tech to an empire and makes it always available for research.
add_ship_design = last_created_design       # Adds a ship design to a country!

create_fleet = { name = "Head-in-Sand" }    # Creates a new fleet
change_government = "divine_mandate"        # Change government in Empire.
country_add_ethic = "ethic_xenophobe"       # Adds an ethic to a country
country_remove_ethic = "ethic_xenophile"    # Removes an ethic from a country
create_sector = { ? }                       # Creates a sector
change_country_flag = "name"                # changes the flag of a country
change_dominant_species = "MAM"             # Changes the dominant species of the current Country

declare_war = ROOT                                      # Declare A War.
declare_white_peace_with = ROOT                         # Declare white peace with target country.

enable_faction_of_type = "faction"                      # orces a country to evaluate potential factions of a specific type right now. this would otherwise occur once a month
exile_leader_as = "name"                                # Exiles a leader and saves him associated to a custom name

establish_contact = ROOT                                # Country establishes contact with another country.
end_event_chain = "subterranean_civilization_chain"     # ends an event chain.
establish_communications_no_message = root.owner        # Establish communications between empires.
establish_communications = event_target:contact_empire  # Establish communications between empires.

give_technology = tech_terrestrial_sculpting            # Gives a specific tech to an empire.

leave_alliance = ROOT                                   # Leave any alliance/federation with country

set_country_flag = example_flag                         # Sets a flag on a country
set_tutorial_level = full                               # changes the tutorial level of a human of a country.
set_advisor_active = yes                                # activate or deactivate an advisor
set_faction_hostility = { set_hostile = yes }           # Sets hostility stance of a faction
set_primitive = yes                                     # Sets primitive status for a country
set_name = "name"                                       # Changes the name of a scope target
set_country_type = ROOT                                 # Changes country type
set_graphical_culture = "MAM"                           # Sets country graphical culture
set_heir = "name"                                       # Change the country heir.
set_aggro_range = 500                                   # Sets aggro range on a fleet or a country
set_leader = "name"                                     # Sets a leader from a previously exiled leader associated by a custom name
set_federation_leader = yes                             # Sets a country to lead a federation

remove_country_flag = example_flag                      # Removes a flag from a country
remove_relation_flag = example_flag                     # removes a relation flag.
remove_modifier = example_modifier
remove_point_of_interest = anomaly.4035.poi.1           # removed point of interest.
remove_opinion_modifier = "name"                        # Removes an opinion modifier to an empire.
remove_sector = ROOT                                    # Removes a sector.

add_threat                              # Adds threat
= {
    who = controller
    amount = 10 # scales to pops
}

add_modifier                                # Gives a specific modifier to a planet.
= {
    modifier = "example_modifier"
    days = -1
}

create_military_fleet                       # Creates a military fleet with the designs of a specified country.
= {
    owner = this
    scaled_size = {
        base = 3
    }
}

set_variable                                # Sets a variable value
= {
    which = var
    value = 1
}

set_relation_flag                           # sets a relation flag.
= {
    who = root
    flag = example_flag
}

set_timed_country_flag                      # Sets a timed flag on a country
= {
    flag = day_0
    days = 7
}

add_event_chain_counter                     # adds amount to event chain counter.
= {
    event_chain = "star_power_chain"
    counter = "systems_visited_poi"
    amount = 1
}

begin_event_chain                           # begins an event chain.
= {
    event_chain = "star_power_chain"
    target = root
}

add_tech_progress                           # Gives progress to a specific technology
= {
    tech = tech_fission_power
    progress = 0.80
}

add_monthly_resource_mult                   # Adds multiple amount of monthly income of resource to country
= {
    resource = physics_research / engineering_research / society_research
    value = 60
    min = 2
    max = 5
}

add_war_demand                              # Adds a war demand to a rebel country
= {
    type = cede_planet
    parameter:planet = prev
    target = prev.owner
    warscore_cost = 50
}

set_timed_relation_flag = {
    flag = no_coms who = event_target:MyCountry
    days = 90
}

add_opinion_modifier                        # Gives an opinion modifier to an empire.
= {
    who = event_target:MyCountry
    modifier = opinion_crew_saved
}

set_policy                                  # Sets a policy to a specific value
= {
    policy = slavery
    option = slavery_allowed_all
    cooldown = no
}

set_subject_of                              # sets the scope country's overlord to target
= {
    who = root
    subject_type = vassal / protectorate
}

add_threat = {
    who = root
    amount = 4 # scales to pops
}


create_military_fleet = {
    owner = this
    scaled_size = {
        base = 3
    }
}

create_point_of_interest                    # Creates point of interest
= {
    id = anomaly.4035.poi.1
    name = "anomaly.4035.poi_1"
    desc = "anomaly.4035.poi.desc"
    event_chain = star_power_chain
    location = event_target:some_system_1
}

modify_species                              # Creates a new modified species
= {
    species = ROOT
    add_trait = trait_rapid_breeders
    remove_trait = trait_weak
}

kill_leader                             # Kills leaders of specified types. kill_leader = { type = general type = scientist etc. }
= {
    type = scientist
    show_notification = no
}

###############################
# System (Star)
###############################
set_star_flag = example_flag        # Sets a flag on a star
remove_star_flag = example_flag     # Removes a flag from a star

create_wormhole_station             # Creates a wormhole station
= {
    owner = last_created_country
    angle = random
}

clear_uncharted_space               # Clears US for country
= {
    from = prevprev
    radius = 5
}

# Creates a new star system with planets
spawn_system = { initializer = "special_init_03" }
spawn_system = {
    min_distance = 20
    max_distance = 50
    system = "sol_system"
}

set_variable                # Sets a variable value
= {
    which = var
    value = 1
}

change_variable             # Changes a variable value
= {
    which = var
    value = 1
}

set_timed_star_flag         # Sets a timed flag on a star
= {
    flag = day_0
    days = 7
}
###############################
# Planet
###############################
tooltip = "text"
planet_event = { id = "id" days = 1 random = 1 }    # fires a Planet event

assign_leader = last_created_leader         # Assigns a leader to either a fleet, army, or pop faction

add_anomaly = TUTORIAL_CAT                          # Adds a specified anomaly to planet
add_minerals = 500                                  # Adds Minerals to a planet, tile or country
add_physics = 10                                    # Adds Physics resources to a planet
add_society = 10                                    # Adds Society resources to a planet
add_engineering = 10                                # Adds Engineering resources to a planet
add_colony_progress = 10                            # Add progress to a colony

cancel_terraformation = yes                         # Cancels terraformation on the planet
change_pc = pc_continental                          # Change planet class of planet.
change_planet_size = 5                              # Adds/Removes onto the size of the planet.
create_mining_station = { owner = ROOT }            # Creates a mining station
create_research_station = { owner = ROOT }          # Creates a research station

destroy_colony = yes                    # Destroys the colony on the planet
destroy_ambient_object = this           # Destroys an ambient object
destroy_country = yes                   # Removes a flag from a country
purge = no                              # Starts/stops purging pops
prevent_anomaly = no                    # Sets if this planet will generate new anomalies.

set_controller = ROOT                   # Sets the controller of a planet
set_ring = yes                          # Adds or removes the ring around a planet
set_owner = ROOT                        # Sets the owner of a planet or fleet.
set_planet_flag = example_flag          # Sets a flag on a planet
set_primitive_age = industrial_age      # Sets a primitive age on a country
set_capital = ROOT                      # Sets planet to capital of a country
set_name = "name"                       # Changes the name of a scope target
set_planet_max_health = 1000            # Sets the maximum health of a planet
set_planet_health = 1000                # Sets the current health of a planet
set_spaceport_level = 6                 # Sets the level of the spaceport

start_colony = ROOT                     # Starts a colony

remove_planet_flag = example_flag       # Removes a flag from a planet
remove_modifier = example_modifier
remove_spaceport_module = "Name" or 1   # Removes a spaceport module from a spaceport. Argument is either a spaceport module slot number or a spaceport module tag

unassign_leader = this                  # Unassigns a leader from scope

add_threat                              # Adds threat
= {
    who = controller
    amount = 10 # scales to pops
}

add_modifier                            # Gives a specific modifier to a planet.
= {
    modifier = "example_modifier"
    days = -1
}

set_timed_planet_flag                   # Sets a timed flag on a planet
= {
    flag = day_0
    days = 7
}

create_spaceport                        # creates a spaceport around planet
= {
    owner = last_created_country
    initial_module = "fallen_empire_weapon"
}

create_colony                           # Creates a colony
= {
    owner = last_created_country
    #species = ROBOT_POP_SPECIES_3
    species = owner_main_species
    ethos = owner
}

create_rebels                           # Creates a new rebel country
= {
    name = random
    government = random
    species = prev
    ethos = {
        ethic = "ethic_militarist"
    }
    flag = random
}

create_pop                              # Creates a new pop
= {
    species = event_target:RefugeeAliens / last_created
    ethos = {
        ethic = "ethic_xenophile"
        ethic = "ethic_fanatic_individualist"
    }
    ethos = owner
}

create_army                             # Creates a new army
= {
    name = "Invading Horde"
    owner = event_target:subterranean_nation
    species = event_target:subterranean_species
    type = "industrial_army"
    leader = last_created_leader
}

create_species                          # Creates a new species
= {
    name = "AI" / random
    class = AI / ART / etc
    portrait = random
    traits = random
    homeworld = event_target:WarriorHomePlanet # optional
}

modify_species                              # Creates a new modified species
= {
    species = ROOT
    add_trait = trait_rapid_breeders
    remove_trait = trait_weak
}

surveyed                                    # Sets a planet as surveyed by a specific country
= {
    set_surveyed = yes
    surveyor = event_target:ship_owner
}

enable_special_project                      # Enables a special research project for a country
= {
    name = "DERELICT_SHIP_PROJECT"
    owner = root
    location = this
}

create_ambient_object = {
    type = "derelict_ship_object"
    location = from
}

create_country                              # Creates a new country
= {  # Each part is optional aside from type
    name = "Refugees" / random
    type = faction
    name_list = "PRT2"
    government = random
    auto_delete = yes
    ethos = {
        ethic = "ethic_xenophile"
        ethic = "ethic_militarist"
    }
    day_zero_contact = no
    flag = random
    flag = {
        icon = {
            category = "pirate"
                file = "flag_pirate_7.dds"
            }
            background = {
                category = "backgrounds"
                file = "00_solid.dds"
            }
            colors = {
                "red"
                "red"
                "null"
                "null"
            }
        }
}

create_pop_faction                      # creates a pop faction
= {
    type = slave
    pop = root
}

set_spaceport_module                    # Sets a spaceport module at specified slot
= {
    slot = 1
    module = "destroyer_assembly_yards"
}

set_variable                        # Sets a variable value
= {
    which = var
    value = 1
}

change_variable                             # Changes a variable value
= {
    which = var
    value = 1
}

create_point_of_interest                    # Creates point of interest
= {
    id = anomaly.4035.poi.1
    name = "anomaly.4035.poi_1"
    desc = "anomaly.4035.poi.desc"
    event_chain = star_power_chain
    location = event_target:some_system_1
}

create_ambient_object                       # Creates a new ambient object of type <type> at location <location>
= {
    type = "derelict_ship_object"
    location = solar_system
}

# Creates a new star system with planets
spawn_system = { initializer = "special_init_03" }
spawn_system = {
    min_distance = 20
    max_distance = 50
    system = "sol_system"
}

kill_leader                             # Kills leaders of specified types. kill_leader = { type = general type = scientist etc. }
= {
    type = scientist
    show_notification = no
}

###############################
# Army
###############################
assign_leader = last_created_leader     # Assigns a leader to either a fleet, army, or pop faction

remove_army = yes                       # Removes scope army.

unassign_leader = this                  # Unassigns a leader from scope

kill_leader                             # Kills leaders of specified types. kill_leader = { type = general type = scientist etc. }
= {
    type = scientist
    show_notification = no
}

###############################
# Ship
###############################
tooltip = "text"
ship_event = { id = example_event.1 }   # fires a Ship event

assign_leader = last_created_leader         # Assigns a leader to either a fleet, army, or pop faction

set_ship_flag = "name"              # Sets a flag on a ship
set_name = "name"                   # Changes the name of a scope target
set_disable_at_health = 100         # Set the amount of health that a ship disables at
set_disabled = no                   # Used to enable or disable a ship

repair_ship = yes                   # Restores a damaged ship to its full HP
reduce_hp_percent = 10              # Reduces the hitpoints of a ship by the percentage given
reduce_hp = 100                     # Reduces the hitpoints of a ship by the points given
remove_ship_flag = "name"           # Removes a flag from a ship
remove_modifier = example_modifier

unassign_leader = this                  # Unassigns a leader from scope

add_modifier                        # Gives a specific modifier to a ship.
= {
    modifier = "example_modifier"
    days = -1
}

set_timed_ship_flag                 # Sets a timed flag on a ship
= {
    flag = day_0
    days = 7
}

enable_special_project              # Enables a special research project for a country
= {
    name = "DERELICT_SHIP_PROJECT"
    owner = root
    location = this
}

# Creates a new star system with planets
spawn_system = { initializer = "special_init_03" }
spawn_system = {
    min_distance = 20
    max_distance = 50
    system = "sol_system"
}

modify_species                              # Creates a new modified species
= {
    species = ROOT
    add_trait = trait_rapid_breeders
    remove_trait = trait_weak
}

create_point_of_interest                    # Creates point of interest
= {
    id = anomaly.4035.poi.1
    name = "anomaly.4035.poi_1"
    desc = "anomaly.4035.poi.desc"
    event_chain = star_power_chain
    location = event_target:some_system_1
}

kill_leader                             # Kills leaders of specified types. kill_leader = { type = general type = scientist etc. }
= {
    type = scientist
    show_notification = no
}

###############################
# Fleet
###############################
fleet_event = { id = example_event.1 }  # fires a Fleet event

add_mission_progress = -0.2             # Adds progress to a mission
assign_leader = last_created_leader     # Assigns a leader to either a fleet, army, or pop faction

clear_fleet_actions = ROOT              # Clears all fleet actions for fleet on the right side of =
clear_orders = yes                      # Removes all orders from a fleet.
create_army_transport = ROOT            # Creates a new army in space

dismantle = yes                         # Dismantles a station
destroy_fleet = ROOT                    # Destroys fleet on the right side of =

order_forced_return = yes               # Orders a fleet to move back into safe territory.

set_controller = ROOT                   # Sets the controller of a planet
set_fleet_flag = example_flag           # Sets a flag on a fleet
set_fleet_stance = aggressive           # Sets the stance of scope fleet. valid stances are aggressive, passive and evasive
set_aggro_range_measure_from = self     # Sets where aggro range is measured from on a fleet or a country. valid targets: self, return_point
set_aggro_range = 500                   # Sets aggro range on a fleet or a country
set_owner = ROOT                        # Sets the owner of a planet or fleet.
set_name = "name"                       # Changes the name of a scope target
set_event_locked = yes                  # Locks a fleet actively disabling it to do anything. Remember to unlock.
set_spaceport_level = 6                 # Sets the level of the spaceport
set_formation_scale = 2                 # set formation scale on a fleet
set_leader = "name"                     # Sets a leader from a previously exiled leader associated by a custom name
set_mission = "name"                    # Sets the current mission of an observation station

remove_fleet_flag = example_flag        # Removes a flag from a fleet
remove_modifier = example_modifier
remove_spaceport_module = "Name" or 1   # Removes a spaceport module from a spaceport. Argument is either a spaceport module slot number or a spaceport module tag

unassign_leader = this                  # Unassigns a leader from scope

add_modifier                            # Gives a specific modifier to a fleet.
= {
    modifier = "example_modifier"
    days = -1
}

set_timed_fleet_flag                    # Sets a timed flag on a fleet
= {
    flag = day_0
    days = 7
}

create_ship                             # Creates a new ship
= {
    graphical_culture = "pirate_01"
    name = "Life Tree Protector"
    design = "Large Space Organism"
}

create_ship_design                      # Creates a new ship design
= {
    design = "Reaver"
    ftl = event_target:owner_country
}

set_location                            # Sets the location of a fleet.
= {
    target = PREVPREV
    distance = 35
    angle = random
}

set_spaceport_module                    # Sets a spaceport module at specified slot
= {
    slot = 1
    module = "destroyer_assembly_yards"
}

queue_actions                           # Add actions to fleet's action queue
= {
    wait = {
        duration = 10
        random = 3
    }

    orbit_planet = ROOT

    move_to = FROM

    effect = {
        id = "blah"
    }

    repeat	= {
        max_iterations = 10                 #limits how many times stuff can be repeated
        while = { 			                #AND-trigger. If this trigger fails the repetition will be stopped
            id = "something_unique"	        #this trigger needs a unique ID for save/load to work
        }

        move_to = PREV #actions to repeat
    }

    find_closest_planet = { #finds the closest planet in the system which fulfills the trigger
    trigger = {
        id = "something_unique"
    }
    found_planet = {	#sets current scope to a planet scope with the found planet
        <fleet actions for when a planet was found>
    }
    failed = { #no scope changes
        <fleet action for when no planet was found>
    }

    find_random_system = {
        trigger = {
        }
        found_system = {
            move_to = this
        }
    }
}

set_variable                        # Sets a variable value
= {
    which = var
    value = 1
}

change_variable                             # Changes a variable value
= {
    which = var
    value = 1
}

kill_leader                             # Kills leaders of specified types. kill_leader = { type = general type = scientist etc. }
= {
    type = scientist
    show_notification = no
}

###############################
# Leader
###############################
add_skill = 5                           # Adds amount of skill levels to scope leader
add_trait = leader_trait_maniacal       # Adds a trait to a leader
add_experience = 100                    # Adds specified amount of experience to specified skill on scope leader

set_age = 1                             # Changes the age of the leader
set_leader_flag = example_flag          # Sets a flag on a leader
set_name = "name"                       # Changes the name of a scope target
set_skill = 5                           # Sets skill levels to scope leader

recruitable = yes                       # Sets recruitable tag on leader.
remove_leader_flag = example_flag       # Removes a flag from a leader
remove_trait = "traitname"              # Removes a trait from a leader

unassign_leader = this                  # Unassigns a leader from scope

create_leader                           # Creates a new leader
= {
    type = admiral
    species = last_created
    name = "0101010111"
    skill = 400
    traits = {
        trait = leader_trait_aggressive
        trait = leader_trait_fleet_logistician
    }
}

kill_leader                             # Kills leaders of specified types. kill_leader = { type = general type = scientist etc. }
= {
    type = scientist
    show_notification = no
}

set_variable                            # Sets a variable value
= {
    which = var
    value = 1
}

change_variable                             # Changes a variable value
= {
    which = var
    value = 1
}

###############################
# Tile
###############################
add_minerals = 500                      # Adds Minerals to a planet, tile or country
add_deposit = d_vast_society_deposit    # Adds a deposit to a tile
add_building_construction = "building"  # Adds a construction of specified building on tile.

set_building = "building"               # Adds a construction of specified building on tile.
set_ruined = yes                        # Sets the ruined status of a building
set_blocker = tb_noxious_swamp          # Sets a specified blocker on tile.

remove_building = "building"            # Removes building on tile.
remove_blocker = yes                    # Removes blocker from tile. (bool)
clear_deposits = yes                    # Removes all deposits from a tile

create_pop                              # Creates a new pop
= {
    species = event_target:RefugeeAliens / last_created
    ethos = {
        ethic = "ethic_xenophile"
        ethic = "ethic_fanatic_individualist"
    }
    ethos = owner
}

add_resource                            # Adds a resource to a planet or tile
= {
    resource = energy
    amount = 2
    replace = yes
}

###############################
# Pops
###############################
tooltip = "text"
pop_event = { id = henrik.138 }             # fires a Pop event

assign_leader = last_created_leader         # Assigns a leader to either a fleet, army, or pop faction

change_pop_species = PREV                   # Changes the species of a pop.

enslave_pop = yes                           # Enslave/Emancipate pop
kill_pop = yes                              # Kills pop
kill_pop_faction = yes

force_faction_evaluation = this             # forces a pop to evaluate factions

pop_migration = 1                           # Sets the migration speed of a pop.
pop_add_ethic = ethic_fanatic_pacifist      # Adds an ethic to a pop
pop_remove_ethic = ethic_fanatic_militarist # Removes an ethic to a pop
purge = no                                  # Starts/stops purging pops

set_pop_flag = "SUPER_DUPER_FLAG"           # Sets a flag on a pop
set_pop_faction_flag = mandated_release

remove_pop_flag = "SUPER_DUPER_FLAG"        # Removes a flag from a pop
remove_pop_faction_flag = mandated_release
remove_modifier = example_modifier

unassign_leader = this                  # Unassigns a leader from scope

add_modifier                                # Gives a specific modifier to a pop.
= {
    modifier = "example_modifier"
    days = -1
}

modify_species                              # Creates a new modified species
= {
    species = ROOT
    add_trait = trait_rapid_breeders
    remove_trait = trait_weak
}

create_point_of_interest                    # Creates point of interest
= {
    id = anomaly.4035.poi.1
    name = "anomaly.4035.poi_1"
    desc = "anomaly.4035.poi.desc"
    event_chain = star_power_chain
    location = event_target:some_system_1
}

set_timed_pop_flag                          # Sets a timed flag on a pop
= {
    flag = day_0
    days = 7
}

###############################
# Pop Faction
###############################
pop_faction_event = { id = pop.1 }          # fires a Pop faction event
add_support = 20                            # Adds to a pop factions Support level
set_pop_faction = "faction"                 # Makes a pop join a faction
set_support = 20                            # Sets a pop factions Support level
set_pop_faction_flag = "flag"               # Sets a flag on a pop
remove_pop_faction_flag = "flag"            # Removes a flag from a pop
kill_pop_faction = yes                      # Deletes a pop faction

set_timed_pop_faction_flag                  # Sets a timed flag on a pop faction
= {
    flag = day_0
    days = 7
}
###############################
# Ambient Object
###############################
set_ambient_object_flag = "flag"        # Sets a flag on a AmbientObject
remove_ambient_object_flag = "flag"     # Removes a flag from a AmbientObject
set_timed_ambient_object_flag           # Sets a timed flag on a ambient object
= {
    flag = day_0
    days = 7
}

enable_special_project                  # Enables a special research project for a country
= {
    name = "DERELICT_SHIP_PROJECT"
    owner = root
    location = this
}