The Dice Roller
The dice roller allows the player to roll their own dice for things like stats, saving throws, attacks, and so on. All rolls are logged and publicly viewable by default, however a "secret" tick box is available for private rolls that only the player and the GM will be able to see.
Some options are available to GMs of the game only.
Here choose number and size of the dice to roll, plus any modifier
(the modifier is on the total, not per die).
This is a freeform entry. Use the format,
include 1d3 which would roll a three-sided die once, or
2d30-4, which would roll two thirty-sided die dice, then subtract
four from the result. Here, multiple dice may be included in the roll by
separating them with a comma: 1d4,1d6 would roll one four-sided
and one six-sided die and display the results individually. Again, any
modifiers are added to the end result and not per die.
Then you can select one or more of the following options:
This will cause the results to drop (or ignore) the lowest die
rolled. Note that Keep Lowest, Drop Highest, and Keep Highest work
similarly. If a number is entered into the right of this, it will
drop/keep that number of dice. (6d6 Keep Highest 3 will roll
six six-sided dice, but only count the three highest results.)
If "Reroll Max" is chosen, and the maximum number possible for a
die is rolled, that die will be thrown again and the result added
to the max number.
If this is chosen and a 1 is rolled on a die, that die is re-rolled.
|Record each die
This option will display the individual die rolls in the Dice Log, up
to a maximum of twenty dice.
This setting ensures that the same number is not rolled twice in the
same set of dice rolls.
|Game System/Special Dice
If a game is selected here, the roll will conform to that system. Brief
notes are provided when a game type is selected.
Finally, it's possible to select any of these:
If you've got more than one character you can change who you're rolling
|On Behalf of
GMs may choose to roll on behalf of a player's character here.
|Fudge (rig) the rolls
(GMs only) This option allows the GM to rig the outcome of a roll. To
use this function, enter the desired results (per die, without modifiers)
here. For example, if the GM is rolling 1d20+2, and wants the result to
be 16, they would enter "14" here. If they were rolling 3d8 and wanted
a result of at least 8, they could enter a "6" here (the results would
indicate one die had rolled a 6, and the other two dice would be rolled
normally and added to this). While GMs will be able to tell the roll was
fudged, players will not see the "Fudged" indicator in the log.
|Reason for roll
Here a note can be indicated as to the purpose of the roll. This note
will be displayed in the Dice Log.
This option makes the roll a private roll, visible only to the GM and
the player it was made for.
Creating Links to the Dice Roller
RuBB code uses a basic structure with attributes that can be set for the various dice roller options. The links will lead to the die roller, with it set up for the user according to the link's specifications, but the user will still need click the "Roll the Dice" button once they're there.
The basic format is: [dice=<dice>]
In this case, the dice are referred to in standard RPG format -- number of dice, then d, then the sides on the die. So, 1d10 rolls one ten-sided die. Multiple kinds of dice can be thrown by separating them with a comma, and penalties and bonuses can be indicated with the plus and minus signs.
(roll one twenty-sided die added to two four-sided dice)
(roll one twenty-sided die and add two to the result)
Several other options are available to help flesh out the dice roller link. Each goes within the square brackets, separated from the other options by a space. (Below, replace the angle brackets and anything between them with the appropriate information.)
- memo="<reason>" inserts a "reason for roll".
Use this option to pre-fill the "reason for roll" area of the die roller for the player.
Example: [dice=1d20+2 memo="To hit with long sword +2"]
- text="<reason>" changes the link text from the standard "Roll xdy" to whatever yo input.
Use this option to provide greater information about what the roll is for.
Example: [dice=1d20+2 text="Roll longsword attack"]
- system=<system> choses a system for the roll.
Supported system designations are (in no particular order): advant, artesia, coda, wod1e, wod2e, wod2es, wod3e, wod3es, nwod, nwoda, nwodcd, nwodcw, ex, sh, sho, sh4e, spooky, d6c, dcl, rm, fudge, rifts, 1roll, sorc, hero, earth, earth3, tat, hackp, hackap, dead, deck54, deck52, unisys, fmwerk, fengsh, tros, ricochet, 8ball, ars_sd, 1ring and swee.
Example: [dice=1d52 system=deck52]
(choose from a 52-card deck)
Example: [dice=1d20 system=8ball]
(get an answer from the Magic 8-ball)
Note that the "dice" set-up is is still necessary and the die roller may complain if it is abnormal for the chosen system (e.g., trying to roll 1d20+4 on the Magic 8-Ball). Using something simple, such as dice=d6, will work, however.
- target=<target> sets any important number for the system.
The target is always a number, and is only for use with the system option, above. It allows the setting of the target number, the fumble range, the step number, number of cards to be drawn, and so on.
Example: [dice=1d52 system=deck52 target=5]
(draw five cards from a deck of 52)
- dok=<d|k><l|h> drop=number to drop or keep sets drop/keep and lowest/highest options for the roll.
This allows you to discard, or only keep, the number of selected dice.
Example: [dice=4d6 dok=dl drop=1] or [dice=4d6 dok=kh drop=3] (still use the 'drop' keyword, even when keeping rolls)
(both keep the 3 highest rolls)
- maxes=yes re-rolls maxes.
This is the option to use to re-roll any maximums.
Example: [dice=8d10 maxes=yes]
(roll eight ten-sided dice and re-roll any tens)
- ones=yes re-rolls any ones.
This is the option to use when ones are not acceptable results for die rolls.
Example: [dice=1d20 ones=yes]
(roll one twenty-sided die and re-roll it if the result is one)
- record=yes records the outcome of each die in the roll.
If you would like a record in the dice log of each number rolled, turn on record with this option.
Example: [dice=3d7 record=yes]
(roll three seven-sided dice and record each outcome)
- unique=yes ensures that results are not duplicated.
If you need a number of results, and want to ensure no result is given twice, use the option for unique rolls. This is useful, for example, if you need to randomly sequence a series of of things.
Example: [dice=5d5 unique=yes]
(return a random sequence for the numbers from one to five)
- rc=<#> rolls as a character, and bo=<#> rolls on behalf of a character.
Generally these options are not required. Character sheets are aware of which character you are viewing and so will set the link to automatically roll for that character.
You must use the character ID assigned by RPoL for these options -- the easiest way is to view a character profile (or sheet) and look in your browser's address bar for a series of characters such as, "&ci=1558". In this case, the ID for the character being viewed is 1558.
"On behalf of" is a GM-only option. Be aware that as a GM, hidden PCs you own will have all their links set to "rc=" (because you own them) meaning that "on behalf of rolls" won't happen from the character sheet (unlike for regular PCs) unless you configure this option.
Example: [dice=1d20 rc=1558]
(roll one twenty-sided die as character 1558)
Example: [dice=2d4 bo=1558]
(roll two four-sided dice on behalf of character 1558)
Last updated: 07:49, Sat 23 Nov 2013.
Direct link: http://rpol.net/help/?t=help&page=diceroller