Ok, thank you.
I've tested those options.
From memory, the last time I tried embedding rolls like this, the rolls were auto generated (well, I think they were), but the link that code generates requires pressing the roll the die button as well...
I suppose that's to prevent unintentional rolls...
I apologise for not checking the FAQ I
FAQ > General RPoL Information - RuBB Code Tips & Tricks - Put die roller links in posts and character sheets?>
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.
Example: [dice=1d20,2d4]
(roll one twenty-sided die added to two four-sided dice)
Example: [dice=1d20+2]
(roll one twenty-sided die and add two to the result)
Other Options
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, tat, hackp, hackap, dead, deck54, deck52, unisys, fmwerk, fengsh, tros, ricochet, 8ball, ars_sd, and 1ring.
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)
