Reference

Instinct Arguments

With regard to unit clarification, 1 JKU is the equivalent of 1 meter, a time value of 3000.0 msec is the equivalent of 3 seconds and boolean values within are assigned by either a 0 (false) or 1 (true) value. Interestingly, both integer and floating-point numbers seem to be legal values for boolean arguments (but must be of the form 0.0 or 1.0).

Each instinct has a set number of arguments which must be set, in order for the AI character to use that instinct. The following details show examples, as well as listing each argument effect and type.

    PrimaryFire    2000.0, 0.8, 5.0, 0.20, 0.0, 300.0, 0.20, 0.00, 2.0, 500.0
Argument 1: Time interval between shots (msec)
Argument 2: Minimum fire dot (1.0=must be facing exactly / 0.0=180° arc / -1.0=360° arc)
Argument 3: Maximum Distance for AI to not attempt firing at target (JKUs - if the target is too far away, then don't shoot)
Argument 4: Error in AI's aim (%: ranges from 0=perfect aim to 1=random shot)
Argument 5: Minimum distance away from target not to fire (JKUs: usually 0.0, because the player can never occupy the same "space" as the AI character)
Argument 6: "Ready Time" - time before AI becomes aware of a target and fires it's first shot (msec)
Argument 7: Chance of trying to lead a moving target with AI fire (%: ranges from 0=never to 1=always)
Argument 8: Chance of using secondary fire mode (%: ranges from 0=never to 1=always)
Argument 9: Burst count; the number is "+1" than the number specified (0=no burst shooting)
Argument 10: Burst interval - the time between single bursts (msec)

Expanded Information

This instinct defines the AI's firing abilities of the character's primary weapon fire ("weapon" attribute in the AI character's template file).

Instinct Trigger Studies

This section details how the instinct is initiated. In some cases, a charactor's AI are dependent upon certain actions/events occurring before the instinct is triggered.

• Instinct Dependency - LookForTarget
• Triggered by - LookForTarget
• Upon Immediate Initialisation - Sets the default behaviour for firing the AI's primary weapon

Testing Notes

The main cause for interest with this instinct is argument 4, concerning the error in the AI's firing aim. It would appear that the "accuracy" value in the AI setup line takes precedence over the error in the AI's aim.