There are 2 ways to detect objects near a location.
The first way is by using containerRayCast(), but it only finds objects it hits when casting a linear ray from a point.
The second way searches all the way around a location within a certain radius, and this is by using the initContainerRadiusSearch() method.
I'm gunna use the second way in this tutorial, as it's a bit more useful.
Let's say you wanted to make a local chat server command to message all players within a 15 unit radius of the speaker.
Start off by making your server command:
function serverCmdLocalChat(%client,%message)
{
%position=%client.player.position;
}
So we have the player's position... now let's search for nearby players.
We'll use this command:
InitContainerRadiusSearch(%position,15,$TypeMasks::PlayerObjectType);
As you can see, there are 3 arguments.
The first is the starting position, which we already defined.
The second is the radius in which we want to search, we're using 15.
The third is the object type we want to detect. Since we only want to message players (we don't want to message an interior object, etc.), we want to use the PlayerObjectType type mask.
Now let's loop through the objects we detect.
function serverCmdLocalChat(%client,%message)
{
%position=%client.player.position;
InitContainerRadiusSearch(%position,15,$TypeMasks::PlayerObjectType);
$LocalMsgString='%1 says, \c5\"%2\"';
while((%targetObject=containerSearchNext()) !$= 0)
{
%client=%targetObject.client;
messageClient(%client,'',$LocalMsgString,%client.name,%msg);
}
}
