js:MapTool.chat: Difference between revisions
Jump to navigation
Jump to search
m (Corrected order of parameter definitions; added detail/link for more info) |
m (Changed parameter name to the same as the linked function (for clarity)) |
||
(One intermediate revision by the same user not shown) | |||
Line 25: | Line 25: | ||
|usage= | |usage= | ||
<syntaxhighlight lang="javascript" line> | <syntaxhighlight lang="javascript" line> | ||
MapTool.chat.broadcastTo( | MapTool.chat.broadcastTo(targets, msg); | ||
</syntaxhighlight> | </syntaxhighlight> | ||
'''Parameters''' | '''Parameters''' | ||
* {{code| | * {{code|targets}} An array containing the names of the players to send the message to. Can include the same list of values as the {{code|targets}} parameter to {{func|broadcast}}. | ||
* {{code|msg}} String to send to the list of users specified by {{code|lstOfPlayers}}. | * {{code|msg}} String to send to the list of users specified by {{code|lstOfPlayers}}. | ||
}} | }} |
Latest revision as of 23:59, 11 June 2023
This article describes a feature or macro function that is experimental and may be subject to change.
Within the javascript environment used by js.eval
, MapTool.chat
is the entry point for sending chat messages. This page details the attributes and functions available on the MapTool.chat
object.
chat.broadcast() Function
Note: This function can only be used in a Trusted Macro
• Introduced in version 1.10.0
Like the broadcast() macro.
Usage
MapTool.chat.broadcast(msg);
Parameters
msg
String to send to all players and GMs.
chat.broadcastTo() Function
Note: This function can only be used in a Trusted Macro
• Introduced in version 1.10.0
Like the broadcast() macro when used to send just to a particular list of connected machines.
Usage
MapTool.chat.broadcastTo(targets, msg);
Parameters
targets
An array containing the names of the players to send the message to. Can include the same list of values as thetargets
parameter to broadcast().msg
String to send to the list of users specified bylstOfPlayers
.
chat.broadcastToGM() Function
Note: This function can only be used in a Trusted Macro
• Introduced in version 1.10.0
Like the broadcast() macro, but only sends to GMs.
Usage
Maptool.chat.broadcastToGM(msg)
Parameters
msg
String to send to all GMs.