SetPlayerAnnounceValue: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(→‎Syntax: OOP syntax added)
 
(3 intermediate revisions by 3 users not shown)
Line 2: Line 2:
__NOTOC__  
__NOTOC__  
This function allows you to change ASE announce values for any player using a specified key.
This function allows you to change ASE announce values for any player using a specified key.
As an example this can be used to change the "score" value which will be shown at [http://www.game-monitor.com game-monitor.com]'s server list.
As an example this can be used to change the "score" value which will be shown at [https://www.game-state.com/ game-state.com]'s server list.
 
For server-wide changes you can use [[setRuleValue]]!


==Syntax==  
==Syntax==  
Line 9: Line 11:
bool setPlayerAnnounceValue ( element thePlayer, string key, string value )
bool setPlayerAnnounceValue ( element thePlayer, string key, string value )
</syntaxhighlight>  
</syntaxhighlight>  
{{OOP||[[player]]:setAnnounceValue||}}
{{OOP||[[player]]:setAnnounceValue||getPlayerAnnounceValue}}
===Required Arguments===  
===Required Arguments===  
*'''thePlayer:''' The [[player]] whos announce value you wish to change.
*'''thePlayer:''' The [[player]] whos announce value you wish to change.
Line 32: Line 34:


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

Latest revision as of 22:43, 6 September 2024

This function allows you to change ASE announce values for any player using a specified key. As an example this can be used to change the "score" value which will be shown at game-state.com's server list.

For server-wide changes you can use setRuleValue!

Syntax

bool setPlayerAnnounceValue ( element thePlayer, string key, string value )

OOP Syntax Help! I don't understand this!

Method: player:setAnnounceValue(...)
Counterpart: getPlayerAnnounceValue


Required Arguments

  • thePlayer: The player whos announce value you wish to change.
  • key: The key which the value will be stored at.
  • value: The value you wish to store.

Returns

Returns true if the value was set succesfully, false otherwise.

Example

Click to collapse [-]
Server

This small example adds a command that allows you to set your own "score" value.

function setScore ( playerSource, cmdName, scoreValue )
    if ( scoreValue ) then
        setPlayerAnnounceValue ( playerSource, "score", scoreValue )
    end
end

addCommandHandler ( "score", setScore )

See Also