AddPlayerClassEx

From SA-MP Wiki

Jump to: navigation, search


Description:

This function is exactly the same as the AddPlayerClass function, with the addition of a team parameter.


Parameters:
(teamid, modelid, Float:spawn_x, Float:spawn_y, Float:spawn_z, Float:z_angle, weapon1, weapon1_ammo, weapon2, weapon2_ammo, weapon3, weapon3_ammo)
teamidThe team you want the player to spawn in.
modelidThe skin which the player will spawn with.
Float:spawn_xThe X coordinate of the class' spawn position.
Float:spawn_yThe Y coordinate of the class' spawn position.
Float:spawn_zThe Z coordinate of the class' spawn position.
Float:z_angleThe direction in which the player will face after spawning.
weapon1The first spawn-weapon for the player.
weapon1_ammoThe amount of ammunition for the first spawn weapon.
weapon2The second spawn-weapon for the player.
weapon2_ammoThe amount of ammunition for the second spawn weapon.
weapon3The third spawn-weapon for the player.
weapon3_ammoThe amount of ammunition for the third spawn weapon.


Return Values:

  • The ID of the class which was just added.
  • 319 if the class limit (320) was reached. The highest possible class ID is 319.


Image:32px-Ambox_warning_orange.png

Note

The maximum class ID is 319 (starting from 0, so a total of 320 classes). When this limit is reached, any more classes that are added will replace ID 319.


public OnGameModeInit()
{
    // Players can spawn as either:
    // CJ Skin (ID 0) in team 1.
    // The Truth skin (ID 1) in team 2.
    AddPlayerClassEx(1, 0, 1958.33, 1343.12, 15.36, 269.15, 26, 36, 28, 150, 0, 0); // CJ
    AddPlayerClassEx(2, 1, 1958.33, 1343.12, 15.36, 269.15, 26, 36, 28, 150, 0, 0); // The Truth
    return 1;
}

Related Functions

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