From the NannyMUD documentation

LAST CHANGE

2001-01-04

NAME

        wield_hook - Wield hooks

LOCATION

    /obj/living_functions

AVAILABILITY

    Any object can use hooks.

FUNCTIONS

OTHER FUNCTIONS

    wield_hook
    block_wield_hook
    value_wield_hook

DESCRIPTION

    When the hooked living is going to wield an object the functions
    are called, first is block_wield_hook called. Then value_wield_hook,
    with this hook you can increase/decrease the weapon class the living
    gets, note that guild modifications are done AFTER this.
    Lastly wield_hook is called.

SEE ALSO

        wear_hook in hooks/wear_hook

FUNCTION

NAME
        wield_hook - Wield hook


SYNTAX
void wield_hook(mixed arr, object living)

DESCRIPTION
    The arguments to the hook are as follows:
      ({ The weapon class,
         The object being wielded,    
         The original weapon class of the weapon}),
      The living doing the wielding




FUNCTION

NAME
        block_wield_hook - Block wield hook


SYNTAX
int block_wield_hook(mixed arr, object living)

DESCRIPTION
    If block_wield_hook returns 1 the weapon won't get wielded.

    The arguments to the hook are as follows:
      ({ The weapon class,
         The object being wielded}) ,
      The living doing the wielding


RETURN VALUES
int, if 1 then the weapon won't get wielded




FUNCTION

NAME
        value_wield_hook - Value wield hook


SYNTAX
int value_wield_hook(mixed arr, object living)

DESCRIPTION
    With this hook you can increase/decrease the weapon class the living
    gets, note that guild modifications are done AFTER this.

    The arguments to the hook are as follows:
      ({ The weapon class,
         The object being wielded}),
      The living doing the wielding


RETURN VALUES
int, the increase/decrease of weapon class