GetPlayerVersion

GetPlayerVersion

Description:

Function GetPlayerVersion returns the SA-MP client version, as reported by the player.

Function GetPlayerVersion was added in 0.3e and will not work in earlier versions!

A client's version can be up to 24 characters long, otherwise the connection will be rejected due to "Invalid client connection". However, normal players can only join with a version length between 5 (0.3.7) and 9 (0.3.DL-R1) characters.

The string the version gets stored in will be empty if playerid is an NPC.

Parameters:

(playerid, version[], len)

int

playerid

The ID of the player to get the client version of.

string

version

The string to store the player's version in, passed by reference.

int

len

The maximum length of the version.

Return Values:

The length of the player's client version. 0 if player specified doesn't exist.

• The client version is stored in the specified array.

Examples:

Example 1

public OnPlayerConnect(playerid)
{
    new string[24];
    GetPlayerVersion(playerid, string, sizeof(string));
    format(string, sizeof(string), "Your version of SA-MP: %s", string);
    SendClientMessage(playerid, 0xFFFFFFFF, string);
    // possible text: "Your version of SA-MP: 0.3.7"
    return 1;
}

Related Functions

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

• GetPlayerName: Get a player's name.
• GetPlayerPing: Get the ping of a player.
• GetPlayerIp: Get a player's IP.