Skip to main content

UnitActionParam

Description:

  A record that defines the parameters for a "UnitAction".

priority

Type: Field.

Description:

  The priority level for the "UnitAction". UnitAction with higher priority (larger number) will replace the running lower priority UnitAction. If performing UnitAction having the same priority with the running UnitAction and the UnitAction to perform having the param 'queued' to be true, the running UnitAction won't be replaced.

Signature:

priority: integer

reaction

Type: Field.

Description:

  The length of the reaction time for the "UnitAction", in seconds. The reaction time will affect the AI check cycling time. Set to 0.0 to make AI check run in every update.

Signature:

reaction: number

recovery

Type: Field.

Description:

  The length of the recovery time for the "UnitAction", in seconds. The recovery time will mainly affect how long the Playable animation model will do transitions between animations played by different actions.

Signature:

recovery: number

queued

Type: Field.

Description:

  Whether the "UnitAction" is currently queued or not. The queued "UnitAction" won't replace the running "UnitAction" with a same priority. [optional]

Signature:

queued: boolean

available

Type: Function.

Description:

  A function that determines whether the "UnitAction" is currently available for the specified "Unit". [optional]

Signature:

available: function(owner: Unit, action: UnitAction): boolean

Parameters:

ParameterTypeDescription
ownerUnitThe "Unit" that owns the "UnitAction".
actionUnitActionThe "UnitAction" to check availability for.

Returns:

Return TypeDescription
booleanTrue if the "UnitAction" is available for the "Unit", false otherwise.

create

Type: Function.

Description:

  A function that creates a new function or "Routine.Job" that represents the processing of the "UnitAction".

Signature:

create: function(owner: Unit, action: UnitAction): (
function(owner: Unit, action: UnitAction, deltaTime: number): (boolean)
| Routine.Job
)

Parameters:

ParameterTypeDescription
ownerUnitThe "Unit" that will own the "UnitAction".
actionUnitActionThe "UnitAction" to create the processing function or "Routine.Job" for.

Returns:

Return TypeDescription
function or Routine.JobA function or a "Routine.Job" that returns or yields true if the "UnitAction" is complete.

stop

Type: Function.

Description:

  A function that gets invoked when the specified "Unit" stops performing the "UnitAction". [optional]

Signature:

stop: function(owner: Unit)

Parameters:

ParameterTypeDescription
ownerUnitThe "Unit" is stoping the "UnitAction".