SetSpawnInfo

SetSpawnInfo

Description:

Function SetSpawnInfo can be used to change the spawn information of a specific player. It allows you to automatically set someone's spawn weapons, their team, skin and spawn position, normally used in case of minigames or automatic-spawn systems. This function is more crash-safe then using SetPlayerSkin in OnPlayerSpawn and/or OnPlayerRequestClass, even though this has been fixed in 0.2.

Parameters:

(playerid, team, skin, Float:x, Float:y, Float:z, Float:rotation, weapon1, weapon1_ammo, weapon2, weapon2_ammo, weapon3, weapon3_ammo)

int

playerid

The PlayerID of who you want to set the spawn information.

int

team

The Team-ID of the chosen player.

int

skin

The skin which the player will spawn with.

float

X

The X-coordinate of the player's spawn position.

float

Y

The Y-coordinate of the player's spawn position.

float

Z

The Z-coordinate of the player's spawn position.

float

rotation

The direction in which the player needs to be facing after spawning.

int

weapon1

The first spawn-weapon for the player.

int

weapon1_ammo

The amount of ammunition for the primary spawnweapon.

int

weapon2

The second spawn-weapon for the player.

int

weapon2_ammo

The amount of ammunition for the second spawnweapon.

int

weapon3

The third spawn-weapon for the player.

int

weapon3_ammo

The amount of ammunition for the third spawnweapon.

Return Values:

• 1: The function was executed successfully.
• 0: The function failed to execute. This means the player specified does not exist.

Examples:

Example 1

public OnPlayerRequestClass(playerid, classid)
{
    // This simple example demonstrates how to spawn every player automatically with
    // CJ's skin, which is number 0. The player will spawn in Las Venturas, with
    // 36 Sawnoff-Shotgun rounds and 150 Tec9 rounds.
    SetSpawnInfo( playerid, 0, 0, 1958.33, 1343.12, 15.36, 269.15, 26, 36, 28, 150, 0, 0 );
}

Related Functions

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

• SetPlayerSkin: Set a player's skin.
• SetPlayerTeam: Set a player's team.
• SpawnPlayer: Force a player to spawn.