AddPlayerClass

From SA-MP Wiki

Jump to: navigation, search


Description:

Adds a class to class selection. Classes are used so players may spawn with a skin of their choice.


Parameters:
(modelid, Float:spawn_x, Float:spawn_y, Float:spawn_z, Float:z_angle, weapon1, weapon1_ammo, weapon2, weapon2_ammo, weapon3, weapon3_ammo)
modelidThe skin which the player will spawn with.
Float:spawn_xThe X coordinate of the spawnpoint of this class.
Float:spawn_yThe Y coordinate of the spawnpoint of this class.
Float:spawn_zThe Z coordinate of the spawnpoint of this class.
Float:z_angleThe direction in which the player should face after spawning.
weapon1The first spawn-weapon for the player.
weapon1_ammoThe amount of ammunition for the primary 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.


Example Usage:

public OnGameModeInit()
{
    // Players can spawn with either the CJ skin (0) or The Truth skin (1).
    AddPlayerClass(0, 1958.33, 1343.12, 15.36, 269.15, 26, 36, 28, 150, 0, 0); // CJ
    AddPlayerClass(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.