pilots_population.ini
caution
This page is a work in progress!
There may be missing, incomplete or incorrect information on this page as it's still being built! Take information here with a pinch of salt, and feel free to contribute and correct things!
Overview
This file determines NPC pilot behavior in combat.
Syntax
Each block can be defined multiple times
[EvadeDodgeBlock]
[EvadeDodgeBlock]
nickname = STRING
evade_dodge_style_weight = STRING, INT ;Multiple
evade_dodge_cone_angle = INT
evade_dodge_interval_time = INT
evade_dodge_time = INT
evade_dodge_distance = INT
evade_activate_range = INT
evade_dodge_roll_angle = INT
evade_dodge_waggle_axis_cone_angle = INT
evade_dodge_slide_throttle = INT
evade_dodge_turn_throttle = INT
evade_dodge_corkscrew_turn_throttle = FLOAT
evade_dodge_corkscrew_roll_throttle = INT
evade_dodge_corkscrew_roll_flip_direction = BOOL
evade_dodge_interval_time_variance_percent = FLOAT
evade_dodge_cone_angle_variance_percent = FLOAT
evade_dodge_direction_weight = STRING, FLOAT ;multiple
| Parameter | Information |
|---|---|
| nickname | How this entry is referred to elsewhere. |
| evade_dodge_style_weight | Takes a dodge style (options are waggle, waggle_random, slide and corkscrew) and a weight that determines the behavior the NPC uses when they drop into the EVADE state.waggle: An inbetween of waggle_random and corkscrew.waggle_random: Random, jerky. Very strong and unpredictable defensive behavior, particularly against weaker pilots.slide: Engine kill, drift, and pray. Essentially an intentional screwup, to make the AI mortal.corkscrew:2 Long, smooth curves. Strong if defender is lighter than attacker. Weak at same weight because movement is predictable. |
| evade_dodge_cone_angle | Takes a radians value as a single float. Having an enemy in this cone and within evade_activate_range will switch the pilot into `EVADE`` behavior |
| evade_dodge_interval_time | Maybe minimum duration of an EVADE phase not interrupted by a switch to TRAIL/FACE/BUZZ. Setting this and evade_dodge_time to 100 makes them dodge forever, setting this to 100 and evade_dodge_time to 3 does NOT, which speaks in favor of the above theory. |
| evade_dodge_time | Appears to be the max time limit for a pilot to stay in one EVADE phase |
| evade_dodge_distance | Pilot will dodge until they have made the below value in distance from you. Once a dodge has processed it does not seem to run again until after crossing the below range. |
| evade_activate_range | Having an opponent in the cone and within this range will switch the pilot to EVADE behavior. Lower range can make an opponent more aggressive, higher range will force them to be defensive a lot of the time. |
| evade_dodge_roll_angle | |
| evade_dodge_waggle_axis_cone_angle | |
| evade_dodge_slide_throttle | Apparently does nothing if set to 1. |
| evade_dodge_turn_throttle | Putting this to 0 makes EVADE attempts of all kinds straight. Doesn't go above 1. |
| evade_dodge_corkscrew_turn_throttle | Putting this to 0 makes the corkscrew very straight and terrible. Doesnt go above 1. |
| evade_dodge_corkscrew_roll_throttle | Putting this to 0 makes the corkscrew very straight and terrible. Doesnt go above 1. |
| evade_dodge_corkscrew_roll_flip_direction | Probably makes the maneuver more spicy. Unclear effect. |
| evade_dodge_interval_time_variance_percent | |
| evade_dodge_cone_angle_variance_percent | |
| evade_dodge_direction_weight | Weights the direction in which dodges are attempted (presumably not relevant for random waggle?) Maybe chances are still slightly weighted. Due to UI being in the way, dodging down makes the AI dodge more fire against players, probably. Options are left, right, up and down. |
[EvadeBreakBlock]
[EvadeBreakBlock]
nickname = STRING
evade_break_roll_throttle = FLOAT
evade_break_time = INT
evade_break_interval_time = FLOAT
evade_break_afterburner_delay = INT
evade_break_afterburner_delay_variance_percent = INT
evade_break_attempt_reverse_time = INT
evade_break_reverse_distance = INT
evade_break_turn_throttle = INT
evade_break_direction_weight = STRING, INT
evade_break_direction_weight = STRING, INT
evade_break_style_weight = STRING, INT
evade_break_style_weight = STRING, INT
| Parameter | Information |
|---|---|
| nickname | How this entry is referred to elsewhere. |
| evade_break_roll_throttle | |
| evade_break_time | |
| evade_break_interval_time | |
| evade_break_afterburner_delay | |
| evade_break_afterburner_delay_variance_percent | |
| evade_break_attempt_reverse_time | |
| evade_break_reverse_distance | |
| evade_break_turn_throttle | |
| evade_break_direction_weight | |
| evade_break_style_weight |
[BuzzHeadTowardBlock]
[BuzzHeadTowardBlock]
nickname = STRING
buzz_min_distance_to_head_toward = INT
buzz_min_distance_to_head_toward_variance_percent = FLOAT
buzz_max_time_to_head_away = INT
buzz_head_toward_engine_throttle = FLOAT
buzz_head_toward_turn_throttle = INT
buzz_head_toward_roll_throttle = INT
buzz_slide_throttle = INT
buzz_slide_interval_time = INT
buzz_slide_interval_time_variance_percent = FLOAT
buzz_dodge_turn_throttle = INT
buzz_dodge_cone_angle = INT
buzz_dodge_cone_angle_variance_percent = FLOAT
buzz_dodge_waggle_axis_cone_angle = INT
buzz_dodge_roll_angle = INT
buzz_dodge_interval_time = INT
buzz_dodge_interval_time_variance_percent = FLOAT
buzz_dodge_direction_weight = STRING, FLOAT
buzz_dodge_direction_weight = STRING, FLOAT
buzz_head_toward_style_weight = STRING, INT
| Parameter | Information |
|---|---|
| nickname | How this entry is referred to elsewhere. |
| buzz_min_distance_to_head_toward | |
| buzz_min_distance_to_head_toward_variance_percent | |
| buzz_max_time_to_head_away | |
| buzz_head_toward_engine_throttle | |
| buzz_head_toward_turn_throttle | |
| buzz_head_toward_roll_throttle | |
| buzz_slide_throttle | |
| buzz_slide_interval_time | |
| buzz_slide_interval_time_variance_percent | |
| buzz_dodge_turn_throttle | |
| buzz_dodge_cone_angle | |
| buzz_dodge_cone_angle_variance_percent | |
| buzz_dodge_waggle_axis_cone_angle | |
| buzz_dodge_roll_angle | |
| buzz_dodge_interval_time | |
| buzz_dodge_interval_time_variance_percent | |
| buzz_dodge_direction_weight | |
| buzz_head_toward_style_weight |
[BuzzPassByBlock]
[BuzzPassByBlock]
nickname = STRING
buzz_distance_to_pass_by = INT
buzz_pass_by_time = INT
buzz_break_direction_cone_angle = INT
buzz_break_turn_throttle = FLOAT
buzz_pass_by_roll_throttle = INT
buzz_drop_bomb_on_pass_by = BOOL
buzz_break_direction_weight = STRING, INT
buzz_pass_by_style_weight = STRING, INT
| Parameter | Information |
|---|---|
| nickname | How this entry is referred to elsewhere. |
| buzz_distance_to_pass_by | |
| buzz_pass_by_time | |
| buzz_break_direction_cone_angle | |
| buzz_break_turn_throttle | |
| buzz_pass_by_roll_throttle | |
| buzz_drop_bomb_on_pass_by | |
| buzz_break_direction_weight | |
| buzz_pass_by_style_weight |
[TrailBlock]
[TrailBlock]
nickname = STRING
trail_lock_cone_angle = INT
trail_break_time = FLOAT
trail_min_no_lock_time = INT
trail_break_roll_throttle = INT
trail_break_afterburner = BOOL
trail_max_turn_throttle = FLOAT
trail_distance = INT
| Parameter | Information |
|---|---|
| nickname | How this entry is referred to elsewhere. |
| trail_lock_cone_angle | |
| trail_break_time | |
| trail_min_no_lock_time | |
| trail_break_roll_throttle | |
| trail_break_afterburner | |
| trail_max_turn_throttle | |
| trail_distance |
[StrafeBlock]
[StrafeBlock]
nickname = STRING
strafe_run_away_distance = INT
strafe_attack_throttle = INT
| Parameter | Information |
|---|---|
| nickname | How this entry is referred to elsewhere. |
| strafe_run_away_distance | |
| strafe_attack_throttle |
[EngineKillBlock]
[EngineKillBlock]
nickname = STRING
engine_kill_search_time = INT
engine_kill_face_time = INT
engine_kill_use_afterburner = BOOL
engine_kill_afterburner_time = INT
engine_kill_max_target_distance = INT
| Parameter | Information |
|---|---|
| nickname | How this entry is referred to elsewhere. |
| engine_kill_search_time | |
| engine_kill_face_time | |
| engine_kill_use_afterburner | |
| engine_kill_afterburner_time | |
| engine_kill_max_target_distance |
[RepairBlock]
[RepairBlock]
nickname = STRING
use_shield_repair_pre_delay = INT
use_shield_repair_post_delay = INT
use_shield_repair_at_damage_percent = INT
use_hull_repair_pre_delay = INT
use_hull_repair_post_delay = INT
use_hull_repair_at_damage_percent = INT
| Parameter | Information |
|---|---|
| nickname | How this entry is referred to elsewhere. |
| use_shield_repair_pre_delay | |
| use_shield_repair_post_delay | |
| use_shield_repair_at_damage_percent | |
| use_hull_repair_pre_delay | |
| use_hull_repair_post_delay | |
| use_hull_repair_at_damage_percent |
[GunBlock]
This defines the NPCs behavior firing with normal guns. Solars use only auto_turret-prefixed values and require auto_turret = true guns.
[GunBlock]
nickname = STRING
gun_fire_interval_time = FLOAT
gun_fire_interval_variance_percent = FLOAT
gun_fire_burst_interval_time = INT
gun_fire_burst_interval_variance_percent = FLOAT
gun_fire_no_burst_interval_time = INT
gun_fire_accuracy_cone_angle = INT
gun_fire_accuracy_power = INT
gun_fire_accuracy_power_npc = INT
gun_range_threshold = FLOAT
gun_target_point_switch_time = INT
gun_range_threshold_variance_percent = FLOAT
fire_style = STRING
auto_turret_interval_time = FLOAT
auto_turret_burst_interval_time = INT
auto_turret_no_burst_interval_time = INT
auto_turret_burst_interval_variance_percent = FLOAT
| Parameter | Information |
|---|---|
| nickname | How this entry is referred to elsewhere. |
| gun_fire_interval_time | |
| gun_fire_interval_variance_percent | |
| gun_fire_burst_interval_time | |
| gun_fire_burst_interval_variance_percent | |
| gun_fire_no_burst_interval_time | |
| gun_fire_accuracy_cone_angle | |
| gun_fire_accuracy_power | |
| gun_fire_accuracy_power_npc | |
| gun_range_threshold | |
| gun_target_point_switch_time | |
| gun_range_threshold_variance_percent | |
| fire_style | Options are single or multiple. single prevents NPCs from firing more than one weapon at a time. multiple is standard vanilla behavior where NPCs fire their weapons freely. |
| auto_turret_interval_time | |
| auto_turret_burst_interval_time | |
| auto_turret_no_burst_interval_time | |
| auto_turret_burst_interval_variance_percent |
[MissileBlock]
[MissileBlock]
nickname = STRING
missile_launch_interval_time = INT
missile_launch_interval_variance_percent = FLOAT
missile_launch_range = INT
missile_launch_cone_angle = INT
missile_launch_allow_out_of_range = BOOL
| Parameter | Information |
|---|---|
| nickname | How this entry is referred to elsewhere. |
| missile_launch_interval_time | |
| missile_launch_interval_variance_percent | |
| missile_launch_range | |
| missile_launch_cone_angle | |
| missile_launch_allow_out_of_range |
[DamageReactionBlock]
[DamageReactionBlock]
nickname = STRING
evade_break_damage_trigger_percent = FLOAT
evade_dodge_more_damage_trigger_percent = FLOAT
engine_kill_face_damage_trigger_percent = INT
engine_kill_face_damage_trigger_time = INT
roll_damage_trigger_percent = FLOAT
roll_damage_trigger_time = INT
afterburner_damage_trigger_percent = FLOAT
afterburner_damage_trigger_time = FLOAT
brake_reverse_damage_trigger_percent = INT
drop_mines_damage_trigger_percent = FLOAT
drop_mines_damage_trigger_time = FLOAT
fire_guns_damage_trigger_percent = INT
fire_guns_damage_trigger_time = INT
fire_missiles_damage_trigger_percent = INT
fire_missiles_damage_trigger_time = INT
| Parameter | Information |
|---|---|
| nickname | How this entry is referred to elsewhere. |
| evade_break_damage_trigger_percent | |
| evade_dodge_more_damage_trigger_percent | |
| engine_kill_face_damage_trigger_percent | |
| engine_kill_face_damage_trigger_time | |
| roll_damage_trigger_percent | |
| roll_damage_trigger_time | |
| afterburner_damage_trigger_percent | |
| afterburner_damage_trigger_time | |
| brake_reverse_damage_trigger_percent | |
| drop_mines_damage_trigger_percent | |
| drop_mines_damage_trigger_time | |
| fire_guns_damage_trigger_percent | |
| fire_guns_damage_trigger_time | |
| fire_missiles_damage_trigger_percent | |
| fire_missiles_damage_trigger_time |
[CountermeasureBlock]
[CountermeasureBlock]
nickname = STRING
countermeasure_active_time = INT
countermeasure_unactive_time = INT
| Parameter | Information |
|---|---|
| nickname | How this entry is referred to elsewhere. |
| countermeasure_active_time | |
| countermeasure_unactive_time |
[FormationBlock]
[FormationBlock]
nickname = formation_fighter_test
countermeasure_unactive_time = INT
force_attack_formation_unactive_time = INT
break_formation_damage_trigger_percent = FLOAT
break_formation_damage_trigger_time = INT
break_formation_missile_reaction_time = INT
break_apart_formation_missile_reaction_time = INT
break_apart_formation_on_evade_break = BOOL
break_formation_on_evade_break_time = INT
formation_exit_top_turn_break_away_throttle = INT
formation_exit_roll_outrun_throttle = INT
formation_exit_max_time = INT
| Parameter | Information |
|---|---|
| nickname | How this entry is referred to elsewhere. |
| countermeasure_unactive_time | |
| force_attack_formation_unactive_time | |
| break_formation_damage_trigger_percent | |
| break_formation_damage_trigger_time | |
| break_formation_missile_reaction_time | |
| break_apart_formation_missile_reaction_time | |
| break_apart_formation_on_evade_break | |
| break_formation_on_evade_break_time | |
| formation_exit_top_turn_break_away_throttle | |
| formation_exit_roll_outrun_throttle | |
| formation_exit_max_time |
[JobBlock]
[JobBlock]
nickname = STRING
wait_for_leader_target = BOOL
maximum_leader_target_distance = INT
flee_when_leader_flees_style = BOOL
scene_toughness_threshold = STRING
flee_scene_threat_style = STRING
flee_when_hull_damaged_percent = INT
flee_no_weapons_style = BOOL
loot_flee_threshold = STRING
attack_subtarget_order = STRING
field_targeting = STRING
loot_preference = STRING
force_attack_formation = BOOL
combat_drift_distance = INT
attack_preference = STRING, INT, BITFIELD
| Parameter | Information |
|---|---|
| nickname | How this entry is referred to elsewhere. |
| wait_for_leader_target | |
| maximum_leader_target_distance | |
| flee_when_leader_flees_style | |
| scene_toughness_threshold | |
| flee_scene_threat_style | |
| flee_when_hull_damaged_percent | |
| flee_no_weapons_style | |
| loot_flee_threshold | |
| attack_subtarget_order | |
| field_targeting | |
| loot_preference | |
| force_attack_formation | |
| combat_drift_distance | |
| attack_preference |
[Pilot]
[Pilot]
nickname = STRING
inherit = STRING
gun_id = STRING
missile_id = STRING
evade_dodge_id = STRING
evade_break_id = STRING
buzz_head_toward_id = STRING
buzz_pass_by_id = STRING
trail_id = STRING
strafe_id = STRING
engine_kill_id = STRING
mine_id = STRING
countermeasure_id = STRING
damage_reaction_id = STRING
missile_reaction_id = STRING
formation_id = STRING
repair_id = STRING
job_id = STRING
| Parameter | Information |
|---|---|
| nickname | How this entry is referred to elsewhere. |
| inherit | |
| gun_id | |
| missile_id | |
| evade_dodge_id | |
| evade_break_id | |
| buzz_head_toward_id | |
| buzz_pass_by_id | |
| trail_id | |
| strafe_id | |
| engine_kill_id | |
| mine_id | |
| countermeasure_id | |
| damage_reaction_id | |
| missile_reaction_id | |
| formation_id | |
| repair_id | |
| job_id |