%spellRoutineMobTargets()

Aliases%spellRoutineMobTargets( )
Parameters@targetType, @emptyMeansSelf

    This function has specific usefulness within a BlobbieScript used to
implement a spell. The function makes particular use of variables
pre-defined for spell BlobbieScripts and is provided to mimic behaviour
present in the MUD's C source code as provided via #defined MACROS.

This function is used to generate a list of @targets for a spell. If
@targets is already defined then it will not try to retrieve them using
standard methods (pre-defined @targets serves as an override). When
generating a list of targets the function will take into consideration
the source of the spell (cast, staff, potion, etc), the area effect of
the spell (single target, area), and the invoker of the spell (mobile,
object, room). The function will then retrieve the appropriate list of
mobiles in the room as perceivable by the invoker. If no targets are
found then the spell will output the standard "Who will be your
target?" and either terminate the script or jump execution to a defined
"spellComplete" jump label. The specific mobiles are determined via the
following targetting range as might be used for the
%getTargets() function: "r[m]". Finally, this function accepts two
%parameters to further determine what targets to generate. The @targetType
%may be one of the following:

group
notGroup
self

Anything else will default to the mobiles in the room. Finally, if
@emptyMeansSelf is set to true then if no targets are given then the spell
will default to the caster.


Example:

%spellRoutineMobTargets( group, 1 );

Wrong Example:

@targets = %spellRoutineMobTargets();