getNewRolls: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 26: Line 26:
'''Output:'''
'''Output:'''
<source lang="mtmacro" line>
<source 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 33: 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]
</source>
Remember that it returns all the new die rolls since the last time it was called.
<source lang="mtmacro" line>
Roll 1: [e: 3d6]<br>
[r: getNewRolls()]<br>
Roll 2: [e: 3d6]<br>
Roll 3: [e: 3d6]<br>
[r: getNewRolls()]
</source>
'''Output'''
<source lang="mtmacro" line>
Roll 1: « 3d6 = 16 »
[5,6,5]
Roll 2: « 3d6 = 17 »
Roll 3: « 3d6 = 6 »
[5,6,6,3,2,1]
</source>
</source>



Revision as of 13:20, 21 April 2019

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]

See Also