Spawnarg Explanation
This is a short explanation what the respective spawnarg does. The information is taken from the explanations in the def-files. For clarity the spawargs were divided into three subgroups: Combat related spawnargs that include spawnargs influencing the fighting capabilities; Interactions that cover interactions between the player and the AI as well as the AI and the world; AI perception that include spawnargs that influence how the AI perceive their surroundings; and finally other that in my understanding do not fit the other categories.
Combat related
armor
|
Type of armor the AI is wearing (may vary depending on hit zone). The damage multipliers are: leather 0.75, chain 0.5, plate 0.
|
attack_accuracy
|
Maximum angular offset to randomly offset the monster's aim when firing missiles
|
attack_cone
|
Monster can only throw projectile within this cone relative to his direction.
|
bleed
|
If set to true, this entity will bleed, e.g. spawn blood particles and decals when hurt.
|
damage
|
Damage definition if it damages things it collides with.
|
health
|
Amount of damage to receive before dying.
|
health_critical
|
When the health drops below this value, the AI will flee. Set this to 0 for AI that don't wet their pants.
|
melee_damage
|
Damage dealt with a melee weapon.
|
melee_damage_mod
|
When the AI hits with a melee weapon, this multiplies the default damage done by the weapon. Is depending on difficulty and is replaced by melee_sets. Ranges from 0.8 to 1.4.
|
melee_predicts_proximity
|
If true, AI takes the current velocity of itself and its enemy into account to predict whether it will hit the enemy in the future if it starts a melee attack now. All but the stupidest AI should do this.
|
melee_predicted_attack_time
|
The amount of time in milliseconds that the AI uses to predict whether it will hit its enemy if it starts its attack now. Should roughly correspond to the time it takes before the attack animation is threatening to an enemy in front of them. This baseline can be set on an AI for empty-hand attacks, then may be overwritten by individual weapons if their attack animations are slower/faster than this baseline.
|
melee_range
|
do melee attack when within 3x this range
|
melee_rep_attack_time
|
Time it takes for a melee attack to be repeated.
|
outofreach_projectile_delay_max
|
Maximum period to wait between throwing player-out-of-reach projectiles
|
outofreach_projectile_delay_min
|
Minimum period to wait between throwing player-out-of-reach projectiles
|
outofreach_projectile_enabled
|
Ability to throw player-out-of-reach projectiles at the player.
|
pain_threshold
|
How much damage monster has to receive in one blow for it to play a pain animation.
|
unarmed_melee
|
Set this to 1 when this type of AI doesn't need melee weapons to fight. This is usually true for spiders, undead and such. Humans are wimps and need weapons.
|
unarmed_ranged
|
Set this to 1 when this type of AI doesn't need weapons for ranged combat. This is usually true for belchers.
|
Interactions
blind_time
|
The time span in seconds the AI is staying in 'blinded' state when hit by a flashbomb or -mine.
|
blind_time_fuzziness
|
his is the random portion of 'blind_time'. A value in [blind_time-fuzziness ... blind_time+fuzziness] is chosen.
|
can_be_flatfooted
|
If set to true, the AI becomes flat-footed in certain combat situations. This means they're unable to run at the player, but can still turn to face the player.
|
can_drown
|
If true, the AI will drown if it gets under water, either by walking in or by being dropped in unconsciously. Set to '0' to make them breathe under water.
|
canlighttorches
|
AI ability to switch on torches
|
canoperatedoors
|
AI ability to handle doors
|
canoperateelevators
|
AI ability to handle elevators
|
canoperateswitchlights
|
AI ability to operate light switches
|
cansearch
|
Whether the AI can conduct a search or not
|
cansearchcooperatively
|
ability to participate in a coordinated search
|
gas_immune
|
0 = not immune, 1 = immune to gas
|
ko_alert_immune
|
If true, the AI is immune to knockouts when alerted at or above the alert state defined in 'ko_alert_state'.
|
ko_alert_immune_state
|
Alert state number at which immunity behavior changes.
|
ko_alert_state
|
Alert state number at which knockout behavior changes.
|
ko_angle_alert_horiz
|
Horizontal knockout cone angle when the AI is alerted at or above 'ko_alert_state'.
|
ko_angle_alert_vert
|
Vertical knockout cone angle when the AI is alerted at or above 'ko_alert_state'.
|
ko_angle_horiz
|
Defines a horizontal cone angle extending backwards from the direction AI is looking. Anywhere within this cone and the vertical cone is a valid KO.
|
ko_angle_vert
|
Defines a vertical cone angle extending backwards from the direction AI is looking. Anywhere within this cone and the horizontal cone is a valid KO.
|
ko_immune
|
0 = not immune, 1 = immune to blackjack
|
ko_rotation
|
A vector of 3 space-delimited angles applied to rotate the AI's blackjack acceptance cone relative to their head joint. For most heads, the angles are: yaw pitch roll.
|
ko_spot_offset
|
Defines the center of the head for knockout testing purposes. Vector offset from the head attachment joint to the desired head center point. The possible knockout cone extends back from this point.
|
ko_zone
|
Name of the damage zone that must be hit for a possible knockout. Set this blank (i.e. : 'ko_zone' ) to make the AI immune to KOs from the blackjack.
|
pickpocket_alert
|
Incremental alert value to be added to an AI's current alert level
|
pickpocket_delay_max
|
Maximum delay before reacting to a picked pocket
|
picpocket_delay_min
|
Minimum delay before reacting to a picked pocket
|
push_player
|
Set this to 1 to let this entity push the player (default is 0).
|
sneak_attack_alert_state
|
Alert state number at which the AI can no longer be sneak attacked.
|
sneak_attack_mult
|
Damage multiplier applied to ALL damage when AI is damaged at an alert level below that defined in 'sneak_attack_alert_state'.
|
AI perception
acuity_aud
|
AI aural acuity (in percent)
|
acuity_env
|
AI environmental acuity. How sensitive the AI is to things that have changed in its environment.
|
acuity_other
|
AI generic acuity for scripted events. You can call this alert type on an entity with entity.Alert( <char *type>, <float amount>). This will alert the entity by amount * acuity_other in your script.
|
acuity_tact
|
AI tactile acuity (in percent)
|
acuity_vis
|
AI visual acuity (in percent)
|
alert_aud_thresh
|
Threshold of audibility for the AI. This is in dB of sound pressure level (SPL). The real life value for humans is around 20 (a barely heard whisper). Changing this by even 0.1 has a large effect on sound propagation behavior, because propagated sounds below this volume are not heard at all. NOTE if this is not set, it gets the value from soundprop global settings.
|
chancenoticeblood
|
Chance to notice the visual stim of blood
|
chancenoticebrokenitem
|
Chance to notice the visual stim of a broken item
|
chancenoticedoor
|
Chance to notice the visual stim of an open door that should be closed
|
chancenoticelight
|
Chance to notice the visual stim of a light that should be on
|
chancenoticemissingitem
|
Chance to notice the visual stim of a missing item
|
chancenoticemonster
|
Chance to notice the visual stim of a monster
|
chancenoticeperson
|
Chance to notice the visual stim of other persons
|
chancenoticepickedpocket
|
Chance to notice that an object bound to the AI has been stolen
|
chancenoticerope
|
Chance to notice the visual stim of a rope created by a rope arrow
|
chancenoticesuspiciousitem
|
Chance to notice the visual stim of suspicious items
|
chancenoticeundead
|
Chance to notice the visual stim on an undead
|
chancenoticeweapon
|
Chance to notice the visual stim of suspicious weapons
|
drunk_acuity_factor
|
If the AI is drunk, their acuities (visual, hearing, tactile) will be reduced by this factor.
|
fov
|
Full field of view in degrees. Will be used for both horizontal and vertical fov unless vertical is explicitly specified.
|
fov_rotation
|
A vector of 3 space-delimited angles applied to rotate the AI's field of view relative to their head joint. For most heads, the angles are: yaw pitch roll.
|
fov_vert
|
Full vertical field of view in degrees. Leave blank or set to -1 to use the same value as the horizontal fov.
|
headturn_chance_idle
|
The chance for random head turning while idle (0.0-1.0)
|
headturn_factor_alerted
|
The headturning chance gets multiplied by this amount when the AI is alerted
|
Other
ignore_alerts
|
ignores alerts; melee trainer only
|
is_civilian
|
If true, the AI is a civilian. Defaults to 0.
|
is_mantleable
|
If set to 1, this entity is not mantleable by the player. Defaults to 0.
|
move_speed
|
The movement speed of AIs is dependent on their animations and animation rate.
|
stamina
|
Determines how long the player can run. I have found this only for the player, not for AI.
|
team
|
Monsters do not actively attack players or monsters with the same team number. For common team numbers see AI Relations (Editing).
|