GetPlayerUserName: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
mNo edit summary
m (Better see also template)
 
(8 intermediate revisions by 7 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Server function}}
{{Server client function}}
This function returns the community.mtasa.com (or mtabeta.com)-Account of the specified user.
{{MessageBox|
  bordercolorhex = FF0000 |
  bgcolorhex = FFBFBF |
  image = File:Emblem-important.png |
  message = This function is deprecated. This means that its use is discouraged. |
  subtext = MTA Community accounts were dropped in favor of [[serial|serials]] for identifying players. |
}}
 
This function returns the community.mtasa.com (or mtabeta.com) account of the specified user.


==Syntax==
==Syntax==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
string getPlayerUserName ( player thePlayer )
string getPlayerUserName ( player thePlayer )
</syntaxhighlight>
</syntaxhighlight>  
===Required Arguments===
*'''thePlayer:''' The [[player]] whose MTA account username you want to retrieve.


===Returns===
A ''string'' value containing the MTA account username or ''false'' if no account exists for the player.
</section>


===Required Arguments===
<section name="Client" class="client" show="true">
*'''thePlayer:''' The Player which's MTA-Account you want to retrieve
<syntaxhighlight lang="lua">
 
string getPlayerUserName ()
</syntaxhighlight>
===Returns===
===Returns===
A ''string'' value containing the MTA-Account-Name or ''false'' if there is no account with that serial existing.
A ''string'' value containing local player's MTA account username or ''false'' if no account exists for the local player.
</section>


==Example==
==Example==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function outputMTAAccount ( sourcePlayer )
function outputMTAAccount ( sourcePlayer )
Line 21: Line 38:
         if ( sourcePlayer ) then
         if ( sourcePlayer ) then
                 local mtaaccount = getPlayerUserName( sourcePlayer )
                 local mtaaccount = getPlayerUserName( sourcePlayer )
                 if( mtaaccount ) then
                 if ( mtaaccount ) then
                         outputChatBox("Your community.mtasa.com-Account is " .. mtaaccount, sourcePlayer )
                         outputChatBox("Your community.mtasa.com account is " .. mtaaccount, sourcePlayer )
                 else
                 else
                         outputChatBox("Can't find an account for you.", sourcePlayer )
                         outputChatBox("Can't find an account for you.", sourcePlayer )
Line 31: Line 48:


-- register outputMTAAccount as a handler for the mta-account command
-- register outputMTAAccount as a handler for the mta-account command
addCommandHandler ( "mta-account", outputMTAAccount )
addCommandHandler ( "mtaaccount", outputMTAAccount )
</syntaxhighlight>
</syntaxhighlight>  
</section>
 
==See Also==
{{Player functions}}

Latest revision as of 17:04, 21 April 2016

Emblem-important.png This function is deprecated. This means that its use is discouraged.

MTA Community accounts were dropped in favor of serials for identifying players.

This function returns the community.mtasa.com (or mtabeta.com) account of the specified user.

Syntax

Click to collapse [-]
Server
string getPlayerUserName ( player thePlayer )

Required Arguments

  • thePlayer: The player whose MTA account username you want to retrieve.

Returns

A string value containing the MTA account username or false if no account exists for the player.

Click to collapse [-]
Client
string getPlayerUserName ()

Returns

A string value containing local player's MTA account username or false if no account exists for the local player.

Example

Click to collapse [-]
Server
function outputMTAAccount ( sourcePlayer )
        -- if the command was triggered by an ingame player
        if ( sourcePlayer ) then
                local mtaaccount = getPlayerUserName( sourcePlayer )
                if ( mtaaccount ) then
                        outputChatBox("Your community.mtasa.com account is " .. mtaaccount, sourcePlayer )
                else
                        outputChatBox("Can't find an account for you.", sourcePlayer )
                end
        end
end


-- register outputMTAAccount as a handler for the mta-account command
addCommandHandler ( "mtaaccount", outputMTAAccount )

See Also

Shared