js:MapTool.chat: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
No edit summary
m (Changed parameter name to the same as the linked function (for clarity))
 
(7 intermediate revisions by 4 users not shown)
Line 5: Line 5:
|name=chat.broadcast
|name=chat.broadcast
|trusted=true
|trusted=true
|version=1.9.4
|version=1.10.0
|description=
|description=Like the {{func|broadcast}} macro.
Like the {{func|broadcast}} macro.


|usage=
|usage=
<source lang="javascript" line>
<syntaxhighlight lang="javascript" line>
MapTool.chat.broadcast(msg);
MapTool.chat.broadcast(msg);
MapTool.chat.broadcast(lstOfPlayers, msg);
</syntaxhighlight>
</source>


'''Parameters'''
'''Parameters'''
* {{code|msg}} String to send
* {{code|msg}} String to send to all players and GMs.
* {{code|lstOfPlayers}} An array containing the names of the players to include
}}
 
{{MacroFunction
|name=chat.broadcastTo
|trusted=true
|version=1.10.0
|description=Like the {{func|broadcast}} macro when used to send just to a particular list of connected machines.


|usage=
<syntaxhighlight lang="javascript" line>
MapTool.chat.broadcastTo(targets, msg);
</syntaxhighlight>


'''Parameters'''
* {{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}}.
}}
}}
{{MacroFunction
{{MacroFunction
|name=chat.broadcastToGM;
|name=chat.broadcastToGM
|trusted=true
|trusted=true
|version=1.9.4
|version=1.10.0
|description=
|description=Like the {{func|broadcast}} macro, but only sends to GMs.
Like chat.broadcast, but only includes GMs.


|usage=
|usage=
<source lang="javascript" line>
<syntaxhighlight lang="javascript" line>
Maptool.chat.broadcastToGM(msg)
Maptool.chat.broadcastToGM(msg)
</source>
</syntaxhighlight>


'''Parameters'''
'''Parameters'''
* {{code|msg}} String to send
* {{code|msg}} String to send to all GMs.
 
 
 
}}
}}


<h3>See Also</h3>
== See Also ==
 
{{func|js:MapTool}}
[[js:MapTool|JS: MapTool]]<br/>
[[Category:Javascript Function]]
[[Category:Javascript Function]]

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 the targets parameter to broadcast().
  • msg String to send to the list of users specified by lstOfPlayers.


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.


See Also

js:MapTool()