> For the complete documentation index, see [llms.txt](https://docs.inconnu.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.inconnu.app/guides/quickstart/rolling-with-traits.md).

# Rolling with traits

Unlike other dice rollers, Inconnu allows you to roll by naming your Attributes and Skills.

{% hint style="info" %}
**Basic roll syntax:**

{% code overflow="wrap" %}

```
/roll pool:<POOL> hunger:<HUNGER> difficulty:<DIFFICULTY>
```

{% endcode %}
{% endhint %}

While you can supply raw numbers for each of these parameters, **Inconnu** really shines when you use *traits*. Traits are the Attributes and Skills you supplied while making the character, plus any custom traits you might define later.

{% hint style="success" %}
**Example:** Nadea is performing research at the library. She's at *hunger 2*, and the information is hard to find, so the roll is against *difficulty 4*. The pool is *Resolve* plus *Academics*, and she has a research specialty that grants her a bonus die.

{% code overflow="wrap" %}

```
/roll pool:resolve + academics + 1 hunger:Current Hunger difficulty:4
```

{% endcode %}

From this syntax, **Inconnu** interprets the following:

* `pool`: Resolve + Academics + 1
* `hunger`: Nadea's current Hunger rating
* `difficulty:` 4
  {% endhint %}

{% hint style="info" %}
**Notice that we didn't capitalize&#x20;*****Resolve*****&#x20;or&#x20;*****Academics*****?** That's fine. **Inconnu** doesn't care about that. In fact, we didn't even need to write the full trait names! You can provide an abbreviated name so long as **Inconnu** can match it to a *single* trait name. Thus, we could have supplied `r` for *Resolve* and `ac` for *Academics*, making our `pool` a much quicker `r + ac + 1`!
{% endhint %}

{% hint style="warning" %}
**You might have noticed we didn't provide a character name in our roll.** So long as you have only **one character**, you won't need to supply a character name for most functions. As soon as you add a second, however, you will need to supply the name of the character so **Inconnu** knows which traits to look up. Even then, in certain circumstances, Inconnu is smart enough to know which character can perform a given interaction. Feel free to experiment!
{% endhint %}
