From the NannyMUD documentation

LAST CHANGE

2001-01-02

NAME

        value_choose_target_hook - Value choose target hook

LOCATION

    /obj/living_functions

AVAILABILITY

    Any object can use hooks.

FUNCTIONS

OTHER FUNCTIONS

    value_choose_target_hook

DESCRIPTION

    Is called every attack round, if you return a monster then
    it will be set to the monster to attack, unless several people
    have defined this hook in the same object, and both returns an 
    object to attack then it is whoever is registered last that
    gets to set its query_attack().

SEE ALSO

        hit_player_hook in hooks/hit_player_hook

SEE ALSO

        die_hook in hooks/die_hook
        die_hook in std/line/line_control
        die_hook in std/misc/kill_logger
        die_hook in std/misc/logger

SEE ALSO

        kill_hook in hooks/kill_hook
        kill_hook in std/line/line_control
        kill_hook in std/misc/logger

FUNCTION

NAME
        value_choose_target_hook - Value choose target hook


SYNTAX
object value_choose_target_hook(mixed arr, object monster)

DESCRIPTION
    Is called every attack round, if you return a monster then
    it will be set to the monster to attack, unless several people
    have defined this hook in the same object, and both returns an 
    object to attack then it is whoever is registered last that
    gets to set its query_attack().

    The arguments to the hook are as follows:
       ({ All attackers (in an array) })
       The monster doing the attack.


RETURN VALUES
object, if set to a monster, that monster will be the attack
target further on