RPTools

Personal tools
From MapToolDoc
Revision as of 15:24, 19 July 2011 by JML (Talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Macros:Roll:types

Languages: English  • 日本語

Contents

[]/{} Roll Types and Options

Text that you type into MapTool or execute from a macro button is scanned for [ ] and { } blocks. The text within these blocks is evaluated and the output from this evaluation is placed into the string in its place.

{ } Rolls

When the text is contained within { } then the text is evaluated and the output copied in its place without any special formatting. For example {2 + 2} produces Brace2Plus2.png

[ ] Rolls

Text that is within [ ] is evaluated, the output from [ ] is inserted with a tool tip that displays the details of the evaluation -- the tool tip can be displayed by leaving the mouse pointer over the result. For example [2 + 2] produces

2Plus2ToolTip.png

There are also several options that can be used within [ ] to change the formatting. Options are specified after the [ and the option string is terminated with a ':'. If you have more than one option then need to separate them with a ',' eg [opt1, opt2: ...], if there are any arguments for an option they are enclosed within (). All options are case insensitive, so [opt: ...] is the same [OPT: ...].

[ ] Hidden Rolls

[h: ], [hide: ], [hidden: ] evaluates the text after the ':' but completely discards the output. This is useful for setting variables or other similar tasks where you want to change something but not display any output.

If a chat message would appear empty because everything in it is hidden from the player, the message is not displayed.

[ ] Expanded Rolls

[e: ], [expanded: ] evaluates the text after the ':' and displays the detailed output of the evaluation. [e: 2 + 2 ] would display.


2Plus2Expanded.png


[ ] Result Rolls

[r: ], [result: ] evaluates the text after the ':' and displays the plain output without any formatting or tool tips, the result is the same as using { }. [r: 2 + 2] would display.

2Plus2Result.png


[ ] Unformatted Rolls

[u: ], [unformatted: ] evaluates the text after the ':' and displays the detailed output without coloring or tool tips. [u: 2 + 2 ] would display.

2Plus2Unformatted.png


[ ] Tool Tip Rolls

[t: ], [tooltip: ] evaluates the text after the ':' and displays the result with a tool tip that displays the details of the evaluation -- the tool tip can be displayed by leaving the mouse pointer over the result. For example [t: 2 + 2] produces.

2Plus2T.png

You can also specify an argument for the tooltip option. If you specify an argument then this argument is evaluated and displayed, the text after the ':' is evaluated and used as the tool tip. [t("four"): 2 + 2] produces.

2Plus2T-Four.png

Related Pages

Languages: English  • 日本語