This function returns an array of item pointers for items that are found within the requested @radius of the @source. The @source may be the ID of a room or a pointer to a room, mobile, or item. Flags may be set to determine specific rules for room traversal. For instance, by default the room of origin is NOT included but this can be changed by setting the "includeOrigin" flag. Following is a list of currently supported flags:
includeOrigin - include the origin room in the results allowNoDirection - traverse exits flagged as noDirection allowSecret - traverse exits flagged as secret allowClosed - traverse closed doors allowDeathtrap - include deathtrap rooms
Example:
// // Create a cyclone of debris. //
@flags = %array( includeOrigin ) @items = %roomGetRadiusItems( @caster, 5, "includeOrigin" )
foreach( @items as @item ) { %move( @item, %where( @caster ) ) } endforeach
%echo( "A cyclone manifests and takes shape as it pulls in " \ "nearby debris." )
// // Smack the players around with the debris similar to what we do // with whirlwind. // |