RemoveBuildingForPlayer

RemoveBuildingForPlayer

Description:

Function RemoveBuildingForPlayer removes a standard San Andreas model for a single player within a specified range.

Function RemoveBuildingForPlayer was added in 0.3d and will not work in earlier versions!

This function also removes OCCL zones irrespective of the specified model.

There appears to be a limit of around 1000 lines/objects. There is no workaround. When removing the same object for a player, they will crash. Commonly, players crash when reconnecting to the server because the server removes buildings on OnPlayerConnect.

In SA-MP 0.3.7 you can use -1 for the modelid to remove all objects within the specified radius.

Parameters:

(playerid, modelid, Float:fX, Float:fY, Float:fZ, Float:fRadius)

int

playerid

The ID of the player to remove the objects for.

int

modelid

The model to remove.

float

fX

The X coordinate around which the objects will be removed.

float

fY

The Y coordinate around which the objects will be removed.

float

fZ

The Z coordinate around which the objects will be removed.

float

fRadius

The radius around the specified point to remove objects with the specified model.

Examples:

Example 1Example 2

public OnPlayerConnect(playerid)
{
    // When the player connects, objects with model 615 will be removed within a
    // range of 200.0 from the point 0.0, 0.0, 0.0, which is the center of San Andreas.
    RemoveBuildingForPlayer(playerid, 615, 0.0, 0.0, 0.0, 200.0);
    return 1;
}

public OnPlayerConnect(playerid)
{
    // When the player connects, all map objects will be removed.
    RemoveBuildingForPlayer(playerid, -1, 0.0, 0.0, 0.0, 6000.0);
    return 1;
}

Related Functions

The following functions may be useful, as they are related to this function in one way or another.

• DestroyObject: Destroy an object.
• DestroyPlayerObject: Destroy a player object.