# Inline Rolls Reference

## Accessing the Inline Rolls Reference Dialog

The system includes a helpful dialog to show common attributes used in inline rolls. To access it, go to the **Settings** tab of Foundry's right sidebar and then click the **Attributes and Inline Rolls Reference** button to open the dialog. It shows the most common properties used by powers in the system's included compendiums, along with an example attack roll and damage roll for martial characters.

![](/files/-MU56Zcyh8nKkhFkiLzB)

## Where Inline Rolls Can be Placed

Inline rolls can be placed inside *any* text or text editor field in powers you add to your character or world, along with monster actions. The parsing for inline rolls happens in chat messages during render, so you can even put them directly in the chat box!

## An Example of an Inline Roll

Before we go into detail on the available attributes, here's a few examples:

### Attack Rolls

* **Attack:** `[[d20+@str.mod+@std+@atk.m.bonus]] vs. AC` 

What that's saying is `d20` + Strength modifier + standard bonuses (level, escalation die, attack penalties) + melee magic item bonuses.

### Damage Rolls

* **Hit:** `[[@wpn.m.dice+@str.dmg+@atk.m.bonus]] damage` 
* **Miss:** `[[@lvl]] damage`

Your character sheet has a setting where you can define the weapon dice associated with it, such as a d10, an the `@wpn.m.dice` attribute will be your damage dice per level, such as 5d10 for a 5th level fighter with a heavy greatsword. Similarly, `@str.dmg` will be your strength bonus multiplied per tier, such as `+8` for a strength of 18 at 5th level.

### Special Damage Rolls

But what if you have something like the cleric's Hammer of Faith ability and need to use a different damage die? There's also a `@wpn.m.die` attribute that will give you a single die, so you could do this to do your level in a different damage die:

* **Hit:** `[[(@lvl)@wpn.m.die+@str.dmg+@atk.m.bonus]] damage` 
* **Hit:** `[[(@lvl)d12+@str.dmg+@atk.m.bonus]] damage`

### Basic Math

You can also perform basic math in your rolls, such as `[[2d10*10]]` or `[[floor(d12/2)]]` 

If you need to select between two ability scores, you can use `min()` to select the lower, or `max()` to select the higher. For example:

`[[d20+max(@str.mod,@dex.mod)+@std+@atk.m.bonus]]` for a ranger's melee attack roll.

## Attributes Reference

| Attribute      | Description                                                                                                                                                                                                                                                                                                                                                                                                 |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `@str.mod`     | <p>Ability score modifiers, such as +5 for a 20.</p><p><strong>Variants:</strong></p><ul><li><code>@str.mod</code> (strength)</li><li><code>@dex.mod</code> (dexterity)</li><li><code>@con.mod</code> (constitution)</li><li><code>@int.mod</code> (intelligence)</li><li><code>@wis.mod</code> (wisdom)</li><li><code>@cha.mod</code> (charisma)</li></ul>                                                 |
| `@str.dmg`     | <p>Ability score modifiers multipled by tier, such as +10 for a score of 20 at 5th level.</p><p><strong>Variants:</strong></p><ul><li><code>@str.dmg</code> (strength)</li><li><code>@dex.dmg</code> (dexterity)</li><li><code>@con.dmg</code> (constitution)</li><li><code>@int.dmg</code> (intelligence)</li><li><code>@wis.dmg</code> (wisdom)</li><li><code>@cha.dmg</code> (charisma)</li></ul>        |
| `@lvl`         | Your level                                                                                                                                                                                                                                                                                                                                                                                                  |
| `@ed`          | The current escalation die value for the current combat/scene                                                                                                                                                                                                                                                                                                                                               |
| `@init`        | Your initiative bonus                                                                                                                                                                                                                                                                                                                                                                                       |
| `@std`         | Standard bonuses for attack rolls. This is calculated as `@lvl+@ed+penalties` if any (such as having negative remaining recoveries).                                                                                                                                                                                                                                                                        |
| `@tier`        | A number that can be used for cases where you need to multiply by tier. `1` at adventurer tier, `2` at champion tier, and `3` at epic tier.                                                                                                                                                                                                                                                                 |
| `@wpn.m.die`   | <p>The single die associated with your melee damage rolls, such as <code>d10</code>.</p><p><strong>Variants:</strong></p><ul><li><code>@wpn.m.die</code> (melee)</li><li><code>@wpn.r.die</code> (ranged)</li><li><code>@wpn.j.die</code> (JAB)</li><li><code>@wpn.p.die</code> (PUNCH)</li><li><code>@wpn.k.die</code> (KICK)</li></ul>                                                                    |
| `@wpn.m.dice`  | <p></p><p>The total dice per level associated with your melee damage rolls, such as <code>5d10</code> for a 5th level fighter with a heavy weapon.</p><p><strong>Variants:</strong></p><ul><li><code>@wpn.m.dice</code> (melee)</li><li><code>@wpn.r.dice</code> (ranged)</li><li><code>@wpn.j.dice</code> (JAB)</li><li><code>@wpn.p.dice</code> (PUNCH)</li><li><code>@wpn.k.dice</code> (KICK)</li></ul> |
| `@atk.m.bonus` | <p>The item bonus for your magic item's attack and damage rolls.</p><p><strong>Variants:</strong></p><ul><li><code>@atk.m.bonus</code> (melee weapons)</li><li><code>@atk.r.bonus</code> (ranged weapons)</li><li><code>@atk.a.bonus</code> (arcane implements)</li><li><code>@atk.d.bonus</code> (divine implements)</li></ul>                                                                             |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://asacolips.gitbook.io/toolkit13-system/getting-started/inline-rolls-reference.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.