# Method Creature:GetAITarget [-] [+]

Returns a target from the Creature's threat list based on the supplied arguments.

    enum SelectAggroTarget
    {
        SELECT_TARGET_RANDOM = 0,  //Just selects a random target
        SELECT_TARGET_TOPAGGRO,    //Selects targets from top aggro to bottom
        SELECT_TARGET_BOTTOMAGGRO, //Selects targets from bottom aggro to top
        SELECT_TARGET_NEAREST,
        SELECT_TARGET_FARTHEST
    };

For example, if you wanted to select the third-farthest Player within 50 yards that has the Aura "Corrupted Blood" (ID 24328), you could use this function like so:

    target = creature:GetAITarget(4, true, 3, 50, 24328)

## Synopsis

`target = Creature:GetAITarget( targetType )`

`target = Creature:GetAITarget( targetType, playerOnly )`

`target = Creature:GetAITarget( targetType, playerOnly, position )`

`target = Creature:GetAITarget( targetType, playerOnly, position, distance )`

`target = Creature:GetAITarget( targetType, playerOnly, position, distance, aura )`

## Arguments

`SelectAggroTarget targetType`

  How the threat list should be sorted.

`boolean playerOnly (false)`

  If `true`, skips targets that aren't Players.

`number position (0)`

  Used as an offset into the threat list. If `targetType` is random, used as the number of players from top of aggro to choose from.

  Valid numbers: integers from 0 to 4,294,967,295.

`number distance (0)`

  Valid numbers: all decimal numbers.

`number aura (0)`

  If positive, the target must have this Aura. If negative, the the target must not have this Aura.

  Valid numbers: integers from -2,147,483,647 to 2,147,483,647.

## Returns

`Unit target`

  The target, or `nil`.

# Keyboard shortcuts

?
  Show this help dialog
S
  Focus the search field
⇤
  Move up in search results
⇥
  Move down in search results
⏎
  Go to active search result

# Search tricks

Prefix searches with a type followed by a colon (e.g. `fn:`) to restrict the search to a given type.

Accepted types are: `fn`, `mod`, `struct` (or `str`), `enum`, `trait`, `typedef` (or `tdef`).

Generated on
© 2010 - 2024 Eluna Lua Engine