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:
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.