GetPlayerAnnounceValue: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Created page with '__NOTOC__ {{Server function}} This function retrieves a players ASE announce value under a certain key. ==Syntax== <syntaxhighlight lang="lua">string getPlayerAnnounceValue ( element thePlayer…')
 
 
(12 intermediate revisions by 8 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Server function}}
{{Server function}}
This function retrieves a players ASE announce value under a certain key.
{{New feature/item|3.0104|1.0.4||This function retrieves a players ASE announce value under a certain key.|}}


==Syntax==
==Syntax==
<syntaxhighlight lang="lua">string getPlayerAnnounceValue ( element thePlayer, string key )</syntaxhighlight>
<syntaxhighlight lang="lua">string getPlayerAnnounceValue ( element thePlayer, string key )</syntaxhighlight>
 
{{OOP||[[player]]:getAnnounceValue||setPlayerAnnounceValue}}
===Required Arguments===
===Required Arguments===
*'''thePlayer:''' This is the [[Player]] whos value you want to retrieve.
*'''thePlayer:''' This is the [[Player]] whos value you want to retrieve.
Line 15: Line 15:
==Example==
==Example==
This example adds a command named "getscore" which outputs a players "score" value to his chatbox.
This example adds a command named "getscore" which outputs a players "score" value to his chatbox.
<section show="true" name="Server" class="server">
<syntaxhighlight lang="lua">function getScore ( playerSource, cmdName )
<syntaxhighlight lang="lua">function getScore ( playerSource, cmdName )
     local scoreValue = getPlayerAnnounceValue ( playerSource, "score" )
     local scoreValue = getPlayerAnnounceValue ( playerSource, "score" )
Line 25: Line 24:
addCommandHandler ( "getscore", getScore )
addCommandHandler ( "getscore", getScore )
</syntaxhighlight>
</syntaxhighlight>
</section>


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

Latest revision as of 22:40, 6 September 2024

This function retrieves a players ASE announce value under a certain key.

Syntax

string getPlayerAnnounceValue ( element thePlayer, string key )

OOP Syntax Help! I don't understand this!

Method: player:getAnnounceValue(...)
Counterpart: setPlayerAnnounceValue


Required Arguments

  • thePlayer: This is the Player whos value you want to retrieve.
  • key: The name of the key.

Returns

This function returns a string containing the requested value if a valid key was specified or false otherwise.

Example

This example adds a command named "getscore" which outputs a players "score" value to his chatbox.

function getScore ( playerSource, cmdName )
    local scoreValue = getPlayerAnnounceValue ( playerSource, "score" )
    if ( scoreValue ) then
        outputChatBox ( "Your score: "..scoreValue, playerSource )
    end
end

addCommandHandler ( "getscore", getScore )

See Also