GetPlayerVersion: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
__NOTOC__
{{Server function}}
{{Server function}}
__NOTOC__
{{Note|You can also compare if a version is higher than another using the ''<'' or ''>'' operators.}}
 
This function gets the client version of the specified [[player]] as a sortable string. The string is always 15 characters long and is formatted as follows:
This function gets the client version of the specified [[player]] as a sortable string. The string is always 15 characters long and is formatted as follows:


Line 20: Line 22:
The fourth number is 9, which means it's a release build, (Development and beta builds have lower numbers here)<br>
The fourth number is 9, which means it's a release build, (Development and beta builds have lower numbers here)<br>
And the fifth and sixth numbers represent the build number.
And the fifth and sixth numbers represent the build number.
{{New feature/item|3.0104|1.0.4}}


==Syntax==  
==Syntax==  
Line 27: Line 28:
string getPlayerVersion ( player thePlayer )
string getPlayerVersion ( player thePlayer )
</syntaxhighlight>  
</syntaxhighlight>  
 
{{OOP||[[player]]:getVersion|version|}}
===Required Arguments===  
===Required Arguments===  
*'''thePlayer:''' The [[player]] whose client version you wish to get.
*'''thePlayer:''' The [[player]] whose client version you wish to get.
Line 47: Line 48:


==See Also==
==See Also==
{{Player_functions}}
{{Player functions|server}}

Latest revision as of 22:42, 6 September 2024

[[{{{image}}}|link=|]] Note: You can also compare if a version is higher than another using the < or > operators.

This function gets the client version of the specified player as a sortable string. The string is always 15 characters long and is formatted as follows:

  • 1 character representing the major version
  • 1 dot character
  • 1 character representing the minor version
  • 1 dot character
  • 1 character representing the maintenance version
  • 1 dash character
  • 1 character representing the build type
  • 1 dot character
  • 5 characters representing the build number
  • 1 dot character
  • 1 character representing the build revision

An example of a version string would be: 1.0.4-9.01746.0

Where the first three numbers represent the major/minor/maintenance version, i.e. 1.0.4
The fourth number is 9, which means it's a release build, (Development and beta builds have lower numbers here)
And the fifth and sixth numbers represent the build number.

Syntax

string getPlayerVersion ( player thePlayer )

OOP Syntax Help! I don't understand this!

Method: player:getVersion(...)
Variable: .version


Required Arguments

  • thePlayer: The player whose client version you wish to get.

Returns

Returns a string containing the client version, or false if the player is invalid.

Example

Click to collapse [-]
Server

This example adds a command that allows players to see their own client version.

function showMeMyVersion( playerSource )
    local version = getPlayerVersion ( playerSource )
    outputChatBox ( "Your client version is: " .. version, playerSource )
end

addCommandHandler ( "myversion", showMeMyVersion )

See Also