code (roll option): Difference between revisions
Verisimilar (talk | contribs) mNo edit summary |
No edit summary |
||
(2 intermediate revisions by one other user not shown) | |||
Line 7: | Line 7: | ||
====Usage==== | ====Usage==== | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[CODE: { code_block }] | [CODE: { code_block }] | ||
</ | </syntaxhighlight> | ||
The ''code_block'' is a collection of text and macro code, enclosed in a single {} pair. Everything within the {} is treated as a single block for the purposes of any looping or branching options. | The ''code_block'' is a collection of text and macro code, enclosed in a single {} pair. Everything within the {} is treated as a single block for the purposes of any looping or branching options. | ||
Line 15: | Line 15: | ||
====Example==== | ====Example==== | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[h:num=5] | [h:num=5] | ||
[WHILE(num > 0), CODE: | [WHILE(num > 0), CODE: | ||
Line 23: | Line 23: | ||
[num=num-1] | [num=num-1] | ||
}] | }] | ||
</ | </syntaxhighlight> | ||
Outputs | Outputs | ||
Line 40: | Line 40: | ||
To nest CODE:{} blocks, use a second CODE:{ } option, like so: | To nest CODE:{} blocks, use a second CODE:{ } option, like so: | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[h:d20roll=1d20] | [h:d20roll=1d20] | ||
[h:attackRoll=d20roll+AttackBonus] | [h:attackRoll=d20roll+AttackBonus] | ||
Line 58: | Line 58: | ||
The attack misses! | The attack misses! | ||
};] | };] | ||
</ | </syntaxhighlight> | ||
MapTool can only handle two levels of nested code. | MapTool can only handle two levels of nested code. |
Latest revision as of 18:28, 14 March 2023
This article is a stub, you can help the RPTools Wiki project by contributing content to expand this article.
CODE
Introduced: Version 1.3.b46
The CODE option is used in conjunction with looping / branching options to execute multiple statements within a single "block" of a loop or branch, allowing the creation of more complex loops and branches.
Usage
[CODE: { code_block }]
The code_block is a collection of text and macro code, enclosed in a single {} pair. Everything within the {} is treated as a single block for the purposes of any looping or branching options.
Example
[h:num=5]
[WHILE(num > 0), CODE:
{
This is iteration [r:num] <br>
There are [r:num-1] iterations left<br>
[num=num-1]
}]
Outputs
This is iteration 5 There are 4 iterations left 4, This is iteration 4 There are 3 iterations left 3, This is iteration 3 There are 2 iterations left 2, This is iteration 2 There are 1 iterations left 1, This is iteration 1 There are 0 iterations left 0
NOTE: the digit output at the beginning of each line is an artifact of the WHILE loop's evaluation of num - since this roll does not have the h option active, the result of that evaluation is displayed.
Nested CODE Blocks
To nest CODE:{} blocks, use a second CODE:{ } option, like so:
[h:d20roll=1d20]
[h:attackRoll=d20roll+AttackBonus]
[h,IF(attackRoll >= 16),CODE:
{
[IF(d20roll == 20),CODE:
{
The attack is a critical hit!
[h:damage=critDamage]
};
{
The attack is a hit!
[h:damage=regDamage]
};]
};
{
The attack misses!
};]
MapTool can only handle two levels of nested code.