getNewRolls: Difference between revisions
Jump to navigation
Jump to search
m (Conversion script moved page getNewRolls to GetNewRolls without leaving a redirect: Converting page title to first-letter uppercase) |
m (Text replacement - "<source" to "<syntaxhighlight") |
||
| (3 intermediate revisions by 2 users not shown) | |||
| Line 7: | Line 7: | ||
|usage= | |usage= | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
getNewRolls() | getNewRolls() | ||
</ | </syntaxhighlight> | ||
'''Parameters''' | '''Parameters''' | ||
{{param|none|Takes no parameters.}} | {{param|none|Takes no parameters.}} | ||
| Line 16: | Line 16: | ||
Make some dice rolls and show the individual rolls at each step. | Make some dice rolls and show the individual rolls at each step. | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
Roll 1d10: [e: 1D10+2]<br> | Roll 1d10: [e: 1D10+2]<br> | ||
Get New Rolls: [r: getNewRolls()]<br> | Get New Rolls: [r: getNewRolls()]<br> | ||
| Line 22: | Line 22: | ||
Roll 3d6 minimum 2: [e: 3D6L2]<br> | Roll 3d6 minimum 2: [e: 3D6L2]<br> | ||
Get New Rolls: [r: getNewRolls()]<br> | Get New Rolls: [r: getNewRolls()]<br> | ||
Get Rolled: [r: getRolled()]</ | Get Rolled: [r: getRolled()]</syntaxhighlight> | ||
'''Output:''' | '''Output:''' | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
Roll 1d10: « 1D10+2 = 3 + 2 = 5 » | Roll 1d10: « 1D10+2 = 3 + 2 = 5 » | ||
Get New Rolls: [3] | Get New Rolls: [3] | ||
| Line 32: | Line 32: | ||
Get New Rolls: [5,3,1] | Get New Rolls: [5,3,1] | ||
Get Rolled: [3,5,3,1] | Get Rolled: [3,5,3,1] | ||
</ | </syntaxhighlight> | ||
Remember that it returns all the new die rolls since the last time it was called. | Remember that it returns all the new die rolls since the last time it was called. | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
Roll 1: [e: 3d6]<br> | Roll 1: [e: 3d6]<br> | ||
[r: getNewRolls()]<br> | [r: getNewRolls()]<br> | ||
| Line 41: | Line 41: | ||
Roll 3: [e: 3d6]<br> | Roll 3: [e: 3d6]<br> | ||
[r: getNewRolls()] | [r: getNewRolls()] | ||
</ | </syntaxhighlight> | ||
'''Output''' | '''Output''' | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
Roll 1: « 3d6 = 16 » | Roll 1: « 3d6 = 16 » | ||
[5,6,5] | [5,6,5] | ||
| Line 49: | Line 49: | ||
Roll 3: « 3d6 = 6 » | Roll 3: « 3d6 = 6 » | ||
[5,6,6,3,2,1] | [5,6,6,3,2,1] | ||
</ | </syntaxhighlight> | ||
|also= | |also= | ||
Latest revision as of 23:59, 14 March 2023
getNewRolls() Function
• Introduced in version 1.5.2
Returns an array of all the raw, i.e. unmodified, dice rolls since the last call to getNewRolls().
Usage
getNewRolls()Parameters
none- Takes no parameters.
Example
Make some dice rolls and show the individual rolls at each step.
Roll 1d10: [e: 1D10+2]<br>
Get New Rolls: [r: getNewRolls()]<br>
Get Rolled: [r: getRolled()]<br>
Roll 3d6 minimum 2: [e: 3D6L2]<br>
Get New Rolls: [r: getNewRolls()]<br>
Get Rolled: [r: getRolled()]Output:
Roll 1d10: « 1D10+2 = 3 + 2 = 5 »
Get New Rolls: [3]
Get Rolled: [3]
Roll 3d6 minimum 2: « 3D6L2 = 10 »
Get New Rolls: [5,3,1]
Get Rolled: [3,5,3,1]Remember that it returns all the new die rolls since the last time it was called.
Roll 1: [e: 3d6]<br>
[r: getNewRolls()]<br>
Roll 2: [e: 3d6]<br>
Roll 3: [e: 3d6]<br>
[r: getNewRolls()]Output
Roll 1: « 3d6 = 16 »
[5,6,5]
Roll 2: « 3d6 = 17 »
Roll 3: « 3d6 = 6 »
[5,6,6,3,2,1]