Difference between revisions of "Complete Guide to Macros & Rolls"
From Roll20 Wiki
Andreas J. (Talk | contribs) m (→Initiative) |
Andreas J. (Talk | contribs) m (→Related Pages) |
||
Line 77: | Line 77: | ||
==Related Pages== | ==Related Pages== | ||
− | * {{Text Chat}} | + | * '''[[Complete Guide to Macros & Rolls]]''' |
− | * [[Macros]] | + | ** {{Text Chat}} - where the roll results appear, & info on the common chat commands |
− | * [[ | + | ** [[Dice Reference]] - Comprehensive list of how the Roll20 dice-rolling syntax works, and list the features available |
− | * [[Roll Templates]] | + | ** [[Macros]] - How to create macros, and other info on how the Roll20 <span style="font-family:Pictos;">q</span>Text Chat works, like referencing stats on character sheets, roll queries, nesting macros & initiative |
+ | *** [[Reusing Rolls]] | ||
+ | ** [[Roll Templates]] - a method of formatting roll results in the chat, with some extra functions | ||
+ | ** [[API]]''(Pro Only)'' - API commands can be used in the <span style="font-family:Pictos;">q</span>Text Chat | ||
<br> | <br> | ||
<br> | <br> |
Revision as of 21:44, 21 September 2020
Guide is a WIP Andreas J. (talk) 14:29, 21 September 2020 (UTC) |
This is mean to serve as a comprehensive guide & starting point for figuring out how the q Text Chat, Dice Rolling, Macros and related things work and interact with each-other, and to list everything you can write/make appear in the q Text Chat.
This is both for Players/Gamemasters who are just writing their own custom rolls or macros to be used in their game, as well as those who build Character Sheets and are creating/editing Roll Buttons for their sheets.
Contents |
Basics
The q Text Chat page shows the basic commands that can be used in the chat, such as /roll
(or /r
) for making simple rolls, /em
for emoting text, /w
for whispering to someone, and /gmroll
(or /gr
) for sending simple rolls to the GM.
You can write in the q Text Chat normal text without using any commands like /r
.
Chat Commands
Dice Syntax
The Dice Reference page shows how the syntax for the Roll20 dice rolling works, and all the advanced alternatives you can use, such as rolling Fate Dice, or counting successes rather than the sum of the rolls.
Macros
The Macros page lists all the the other kind of options for modifying rolls that isn't covered by the Dice Reference-page.
Features include
- selected/target
- roll queries
- nested queries
- suppress error message
- Reusing Rolls
Initiative
To send a roll result directly to the Turn Tracker, first, select the Token you wish to roll initiative for, and then make a roll that includes the
&{tracker}
option.
Examples:
-
/roll 1d20 + 5 &{tracker}
-
&{template:default} {{name=Initiative}} {{Roll=[[1d20+5]]}} &{tracker}
See also: Cards#Using_Cards_for_Initiative_Order
Roll Table
If you have Roll Tables on your l Collections-tab, they can be used in rolls & macros.
Example1:
Let's assume there exist a roll table with the name fumble
.
You can roll a table directly in the chat input, or in a macro, simply as 1t[fumble]
.
Example 2:
To roll your "crit-failure" table two time, you would enter /roll 2t[crit-failure]
. You can change 2
to whatever number you would like. However, this currently does not work with inline rolls.
You can also roll a table inline in chat or a macro by wrapping it in double square brackets like this [[1t[table-name]]]
. Currently, any number beyond 1 does not display for the inline roll, the results are show on mouseover though.
Roll Templates
- default roll template
- sheet-specific
API
This is about a Roll20 feature exclusive to Pro-subscribers (and often to players in a Game created by a Pro-subscriber). If you'd like to use this feature, consider upgrading your account. |
Character Sheet Creation
Info and links to things that are only available for when you're Building Character Sheets. Consult the rest of the guide for general details.
- Select Attributes for Sheet Roll - An advanced technique for creating a dynamic roll button on your sheet
Roll Button
See Button#Roll_Button.
Sheetworkers
With the info from Macros, fairly complex outputs to the q Text Chat can be made, but to be able to construct complex and dynamic results based on various factors on your character sheet, you will need to use JavaScript to write Sheet Worker Scripts that modify & construct your roll output dynamically.
Roll Template
When you create/edit a character sheet, you can make your own Roll Templates to make your roll output look like you want, and to do some conditional things such as only showing some sections in case of a critical roll in another sections.
See Roll_Templates#Creating_a_Roll_Template for more.
Roll_Templates#Helper_Functions describes what functions you can build into your sheets.
Related Pages
- Complete Guide to Macros & Rolls
- q Text Chat - where the roll results appear, & info on the common chat commands
- Dice Reference - Comprehensive list of how the Roll20 dice-rolling syntax works, and list the features available
- Macros - How to create macros, and other info on how the Roll20 qText Chat works, like referencing stats on character sheets, roll queries, nesting macros & initiative
- Roll Templates - a method of formatting roll results in the chat, with some extra functions
- API(Pro Only) - API commands can be used in the qText Chat