Revision as of 12:44, 23 October 2021 (view source) Andreas J. (Talk | contribs) m (→‎Inline Labels) ← Older edit		Latest revision as of 12:36, 24 April 2022 (view source) Andreas J. (Talk | contribs) m (→‎Inline Labels: more examples)
Line 59:		Line 59:
	[[File:Inline-label-inline-roll.png|thumbnail|center|400px|Example of inline label use in a roll template, from the [[Mythic D6]] sheet.]]		[[File:Inline-label-inline-roll.png|thumbnail|center|400px|Example of inline label use in a roll template, from the [[Mythic D6]] sheet.]]
		+	Examples:
		+	* <code>&{template:default} {{name=Str}} {{attack=[[1d20+[[floor(12/5)]][Str] ]]}}</code>
		+	* <code>&{template:default} {{name=Magic blast}} {{Damage=[[3d6[Base]+3[Caster Level]+1[Efrit Racial Bonus] ]] Fire Damage}}</code>
	'''You can even use sheet attributes in labels.''' Especially useful if the name of the stat can be customized by the user, so the corresponding label should change to reflect the name.		'''You can even use sheet attributes in labels.''' Especially useful if the name of the stat can be customized by the user, so the corresponding label should change to reflect the name.

---

Latest revision as of 12:36, 24 April 2022

Page Updated:   2022-04-24

Main Page: Complete Guide to Macros & Rolls#Inline Rolls

Inline Rolls refers to the numerical roll result in(usually yellow) boxes that is displayed in the q Text Chat, and the double bracket syntax [[2d6+2]] used for creating them. They can be used both in user-made macros(Free) as well as API Scripts(^info feature).

Contents 1 Inline Rolls 1.1 Examples 2 Inline Labels 3 Tricks 4 Related Pages

[edit] Inline Rolls

If you use simple roll commands/macros like /roll 2d10+5, the whole command is a dice roll, and the individual rolled dice & their results are displayed in the q Text Chat.

But when you use Roll Templates, or want to have embedded dice rolls within other commands like /em, you use inline rolls, which results are displayed as just a final sum(the yellow box in the example). Inline Rolls are wrapped in double brackets([[ ]]) around the calculation for it to be processed.

The result of "Normal" dice rolls is shown as individual dice images displaying the result on each dice separately, along with the total result, while inline roll results are displayed in as a single numerical result, where you can see the roll breakdown by hovering your mouse over the result.

Inline rolls are just like regular rolls, with the following exceptions:

• You can use them in any chat message, not just a roll. For example, you can do a regular chat message, an emote(/em), or a whisper(/w), with an inline roll included.
  • Ex. /w alice the silent curse will affect you for [[2d4]] days.
• They are evaluated completely before any (/roll) commands, so you can use them as "random variables" in your rolls. See Order of Operations for more.
• You see only the total roll result by default, by the dice roll breakdown can be seen if you hover your mouse over the result.
  • Using inline labels in rolls will make it easier to understand more complex rolls
• Highlights (Critical Successes & Failures) are highlighted
  • If an inline roll contains a critical success, it will be highlighted with a green border.
  • If there's a critical failure, it's highlighted in red.
  • If it contains both, it's in blue.

Also when you mouse-over the inline roll to see the details of the roll, it'll show red and green highlights for the individual dice that rolled crits/fumbles.

With inline rolls, the numerical end result is shown in a (yellow) box, and if you hover you mouse over the result, you see the full equation of the roll, along with the result of each.

[edit] Examples

/em swings their sword and does [[2d6+2]] damage.

&{template:default} {{name=Test Attack}} {{attack=[[1d20+5]]}}

&{template:default} {{name=Mage Bolt}} {{attack=[[1d20+3[int]+2[proficiency] ]]}} {{Damage= [[3d6[base dmg]+3[int mod]+1d8[Elder Wand bonus] force dmg]]}} {{DC [[14]] Will Save= The enemy must make the save, or take an extra [[1d8]] fire dmg. }}

[edit] Inline Labels

If you want to include description or explanations to what individual dice or modifiers represent in you rolls, you can introduce inline labels, by using use square brackets in the macro. For example, /roll 2d10+5[Fire Damage] + 3d6[Ice Damage]. Inline labels works both with "normal" rolls and inline rolls. See the earlier gifs for inline label examples in inline rolls.

When these comments are applied directly after a die roll they show up as tool-tips on the dice:

This is especially useful if a roll contains multiple variables and you want to look up what number comes from what attribute.

Examples:

• &{template:default} Template:Name=Str {{attack=[[1d20+floor(12/5)[Str] ]]}}
• &{template:default} Template:Name=Magic blast {{Damage=[[3d6[Base]+3[Caster Level]+1[Efrit Racial Bonus] ]] Fire Damage}}

You can even use sheet attributes in labels. Especially useful if the name of the stat can be customized by the user, so the corresponding label should change to reflect the name.
Example:

/r @{selected|customskill1}d6[@{selected|customskill1name}] + @{selected|str}[str]

[edit] Tricks

• Inline Rolls in Rollable Tables^(Forum) - Eric B
  • followup^(Forum)

[edit] Related Pages

• Complete Guide to Macros & Rolls
  • Roll Templates
• API:Script Index