Data/Target Finds

From SC2Mapster Wiki
Jump to: navigation, search

Target Finds[edit | edit source]

Description[edit | edit source]

Target Finds are used by Tactical AI objects to find good targets for abilities that need them. Using an Order type Tactical AI object, an Ability and an Ability Command Index can be specified, along with a Target Find object. When valid targets are found, the Ability Command specified in the Tactical AI object will be executed.

Hints[edit | edit source]

Categories[edit | edit source]

Inherited fields[edit | edit source]

Caster Validator[edit | edit source]

A validator that checks the caster, and permits the Target Find to continue if passed.

Flags[edit | edit source]

  • Evaluate Command Flag: Tells the unit to execute the ability command (in a Tactical AI object that called the Target Find) if the Target Find is successful. Use in the last Target Find in a Set Sequential.

Target Filters[edit | edit source]

  • Filters for possible targets.

Target Validator[edit | edit source]

  • A validator that checks possible targets.

Best Point[edit | edit source]

  • Checks for the best location to cast an ability based on the data from an Effect.

Bonus Attribute[edit | edit source]

  • (Unknown) - an attribute which receives extra damage from the Effect?

Damage Base[edit | edit source]

  • (Unknown)

Effect[edit | edit source]

  • The Effect that represents the ability to be cast. This can be a damage effect from a summoned unit's weapon (as in Auto Turret Best Point), or it can be a search area effect (EMP Best Point).

Minimum Count[edit | edit source]

  • The minimum number of units that will be damaged by the Effect.

Minimum Score[edit | edit source]

  • (Uncertain)

Effect[edit | edit source]

Determines whether an ability is worth casting based on an Effect.

Effect[edit | edit source]

  • The effect which is being tested to determine whether to cast the ability.

Extend Radius[edit | edit source]

  • The radius to be added to whatever radius the Effect might have (e.g. if it is a search area effect) to determine the viability of using the ability.

Target Sorts - Request Count[edit | edit source]

  • The number of units found which are to be ranked by the Target Sorts.

Target Sorts - Request Percentage[edit | edit source]

  • The fraction of units found which are to be ranked by the Target Sorts.

Target Sorts - Sorts[edit | edit source]

  • Target Sorts to be checked to determine which units are the highest priority targets, to be hit first.

Enumerate Area[edit | edit source]

  • Tests an area around the Impact Location for units and casts an Ability on them if found.

Ability[edit | edit source]

  • The Ability which is cast on valid units found.

Areas - Arc[edit | edit source]

  • The angle in front of the Impact Location which is being checked.

Areas - Maximum Count[edit | edit source]

  • The maximum number of units to find.

Areas - Radius[edit | edit source]

  • The distance out from the Impact Location which is being checked. If left blank, the Radius will be determined based on the Ability's range.

Areas - Radius Bonus[edit | edit source]

  • Amount the distance is increased on subsequent sequential checks.

Areas - Validator[edit | edit source]

  • Validator run on possible targets to determine whether they are valid.

Exclude - Effect[edit | edit source]

  • The effect (per the same tree only) which the Exclude Value field is in relation to. If left blank, it will check according to the current Target Find.

Exclude - Value[edit | edit source]

  • The unit to be excluded from the search, relative to the Exclude - Effect.

Extend Radius[edit | edit source]

  • The distance to check in addition to the Ability's range (if the Area - Radius is left blank). Valid targets found outside of the range will cause the unit to move close enough to cast the ability.

Impact Location - Effect[edit | edit source]

  • The effect (per the same tree only) which the Impact Location - Value field is in relation to. If left blank, it will check according to the current Target Find.

Impact Location - Value[edit | edit source]

  • The unit or location where the search is centered, relative to the Impact Location - Effect.

Include - Effect[edit | edit source]

  • The effect (per the same tree only) which the Include - Value field is in relation to. If left blank, it will check according to the current Target Find.

Include - Value[edit | edit source]

  • The unit to be included in the search, even if it fails the Search Filters check. Relative to the Include - Effect.

Launch Location - Effect[edit | edit source]

  • The effect (per the same tree only) which the Launch Location - Value field is in relation to. If left blank, it will check according to the current Target Find.

Launch Location - Value[edit | edit source]

  • The unit or location which is considered to have launched the search, relative to the Launch Location - Effect. In a Target Find, this probably only determines who the Search Filters and the Same Cliff Level flag are relative to.

Maximum Count[edit | edit source]

  • The maximum number of units to be found in all of the areas combined, at which point it gives up.

Minimum Count[edit | edit source]

  • The minimum number of units to be found in all of the areas combined, or else an Error is reported.

Minimum Count Error[edit | edit source]

  • The error given when the minimum count is not met.

Recycle Count[edit | edit source]

  • The number of times to repeat the search?

Search Filters[edit | edit source]

  • Filters to check for valid targets. The Include - Value unit(s) will be excepted from this check.

Search Flags +[edit | edit source]

  • Call For Help: (Uncertain) Notifies the Impact Location unit to call for help if it is an enemy to the caster.
  • Extend By Unit Radius: Add the Impact Location unit's radius to the search radius, finding units within the unit's radius as well.
  • Offset By Unit Radius: Begin the radius outside the Impact Location unit's radius. Units within the radius will not be found.

Offset Area By Angle - (Unknown)[edit | edit source]

  • Same Cliff Level - only find units on the same cliff level as the Launch Location.

Target Sorts - Request Count[edit | edit source]

  • The number of units found which are to be ranked by the Target Sorts.

Target Sorts - Request Percentage[edit | edit source]

  • The fraction of units found which are to be ranked by the Target Sorts.

Target Sorts - Sorts[edit | edit source]

  • Target Sorts to be checked to determine which units are the highest priority targets, to be hit first.

Last Attacker[edit | edit source]

Runs the Target - Validator on whichever unit attacked the caster last in order to determine whether to use an ability. Use in conjunction with a Set Sequential so that if the validator passes, the next Target Find in the set will be executed.

Offset[edit | edit source]

Finds a point at the specified angle between the minimum and maximum distances at which to target the ability. Use with the Execute Command Flag flag to execute the ability.

Angle[edit | edit source]

  • The angle relative to the caster's facing at which to find the point. 0 is for in front of the caster, 180 is behind the caster.

Distance - Min[edit | edit source]

  • The minimum random distance to place the point.

Distance - Max[edit | edit source]

  • The maximum random distance to place the point.

Order[edit | edit source]

Checks the target of the caster's Ability command against the Target Validator.

Ability[edit | edit source]

  • The ability whose target is being checked, usually Attack to get the caster's current attack target.

Ability Command Index[edit | edit source]

  • The ability's command index whose target is being checked.

Rally Point[edit | edit source]

Finds a rally point for units.

Command Index[edit | edit source]

  • (Unknown)

Rally Point (Worker)[edit | edit source]

Finds a rally point for workers (e.g. on a nearby resource)

Command Index[edit | edit source]

  • (Unknown)

Set[edit | edit source]

Links multiple Target Finds together.

Array+[edit | edit source]

  • The list of Target Finds to be evaluated in the Set.

Type[edit | edit source]

  • Set Combined: Performs all of the Target Finds listed in the Array+.
  • Set Sequential: Performs each of the Target Finds listed in the Array+ in order. Use the flag Evaluate Command Flag on the last Target Find in the set to execute the ability.

Set Successful (Uncertain) Performs whichever one Target Find is found to be valid.