ShowChat: Difference between revisions
Jump to navigation
Jump to search
(→Example: Added an example for MTA 1.4 and up, since 'isChatVisible' is now a function in MTA itself.) |
No edit summary |
||
(7 intermediate revisions by 3 users not shown) | |||
Line 6: | Line 6: | ||
<section name="Client" class="client" show="true"> | <section name="Client" class="client" show="true"> | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
bool showChat ( bool show ) | bool showChat ( bool show [, bool inputBlocked ] ) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Line 12: | Line 12: | ||
*'''show:''' A boolean value determining whether to show (''true'') or hide (''false'') the chat. | *'''show:''' A boolean value determining whether to show (''true'') or hide (''false'') the chat. | ||
===Optional Arguments=== | |||
{{Added feature/item|1.5.9|1.5.8|20898| | |||
*'''inputBlocked:''' A boolean value determining whether chat input is blocked/hidden, regardless of chat visibility. If unset, this will keep the default behaviour prior to r20898 (''true'' when chat is hidden, ''false'' when chat is visible). | |||
}} | |||
===Returns=== | ===Returns=== | ||
Returns ''true'' if the player's chat was shown or hidden successfully, ''false'' otherwise. | Returns ''true'' if the player's chat was shown or hidden successfully, ''false'' otherwise. | ||
Line 17: | Line 21: | ||
<section name="Server" class="server" show="true"> | <section name="Server" class="server" show="true"> | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
bool showChat ( player thePlayer, bool show ) | bool showChat ( player thePlayer, bool show [, bool inputBlocked ] ) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Line 23: | Line 27: | ||
*'''thePlayer:''' The [[player]] whose chat is to be hidden or shown. | *'''thePlayer:''' The [[player]] whose chat is to be hidden or shown. | ||
*'''show:''' A boolean value determining whether to show (''true'') or hide (''false'') the chat. | *'''show:''' A boolean value determining whether to show (''true'') or hide (''false'') the chat. | ||
===Optional Arguments=== | |||
{{Added feature/item|1.5.9|1.5.8|20898| | |||
*'''inputBlocked:''' A boolean value determining whether chat input is blocked/hidden, regardless of chat visibility. If unset, this will keep the default behaviour prior to r20898 (''true'' when chat is hidden, ''false'' when chat is visible). | |||
}} | |||
===Returns=== | ===Returns=== |
Latest revision as of 21:37, 23 September 2021
This function is used to show or hide the player's chat.
Syntax
Click to collapse [-]
Clientbool showChat ( bool show [, bool inputBlocked ] )
Required Arguments
- show: A boolean value determining whether to show (true) or hide (false) the chat.
Optional Arguments
- inputBlocked: A boolean value determining whether chat input is blocked/hidden, regardless of chat visibility. If unset, this will keep the default behaviour prior to r20898 (true when chat is hidden, false when chat is visible).
Returns
Returns true if the player's chat was shown or hidden successfully, false otherwise.
Click to collapse [-]
Serverbool showChat ( player thePlayer, bool show [, bool inputBlocked ] )
Required Arguments
- thePlayer: The player whose chat is to be hidden or shown.
- show: A boolean value determining whether to show (true) or hide (false) the chat.
Optional Arguments
- inputBlocked: A boolean value determining whether chat input is blocked/hidden, regardless of chat visibility. If unset, this will keep the default behaviour prior to r20898 (true when chat is hidden, false when chat is visible).
Returns
Returns true if the player's chat was shown or hidden successfully, false otherwise.
Example
Click to collapse [-]
ClientThis example toggle's the player's chat when they press the "i" key.
--This example below is for all versions until 1.4: local isChatVisible = true --Let's assume the chat is visible as soon as the resource starts. function chat(key, keyState) if isChatVisible then --Check or the chat is visible. showChat(false) --If it is, hide it. isChatVisible = false else showChat(true) --If it is not, show it. isChatVisible = true end end bindKey("i", "down", chat) --Make a bind key to start the function as soon as a player presses the key 'i' --This example below is for version 1.4 and up: function chat(key, keyState) if isChatVisible() then --Check or the chat is visible. showChat(false) --If it is, hide it. else showChat(true) --If it is not, show it. end end bindKey("i", "down", chat) --Make a bind key to start the function as soon as a player presses the key 'i'
See Also
- getMaxPlayers
- getServerConfigSetting
- getServerHttpPort
- getServerName
- getServerPassword
- getServerPort
- isGlitchEnabled
- setGlitchEnabled
- setMaxPlayers
- setServerConfigSetting
- setServerPassword
- shutdown