GetPlayerVersion: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(9 intermediate revisions by 7 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:
{{Note|Current MTA version: {{CurrentVersion}}}}
{{Note|Alternatively, you can use [[getVersion]] on the server or client to obtain more information.}}
 
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 character representing the major version
Line 11: Line 15:
* 1 character representing the build type
* 1 character representing the build type
* 1 dot character
* 1 dot character
* 5 characters representing the build
* 5 characters representing the build number
* 1 dot character
* 1 dot character
* 1 character representing the build revision
* 1 character representing the build revision
Line 24: Line 28:


<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
string getPlayerVersion ( element 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 46: Line 50:


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

Latest revision as of 13:47, 19 November 2024

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

mta -> 1.6
netcode -> 474
number -> 352
sortable -> 1.6.0-9.22279.0
tag -> 1.6-release-22279
type -> Release

[[{{{image}}}|link=|]] Note: Alternatively, you can use getVersion on the server or client to obtain more information.

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