> For the complete documentation index, see [llms.txt](https://docs.mutate.games/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mutate.games/component-tutorials/components-a-closer-look/entity-components/die-roller.md).

# Die Roller

is an Entity Component

Die Roller is another behind the scenes component, used for creating chance and randomisation in levels. It can be a little tricky, but once you get a knack for it it feels straight-forward.

Currently, die roller supports up to 6 potential outcomes - just like the sides of a die - but if you apply this component to multiple entities, all having 6 possible outcomes, depending on how solid your linking is, you can create theoretically infinite random interactions and occurrences!

![](https://3166848498-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzaqFJFbPM2opQ4D43YaF%2Fuploads%2FYe5FpeHk32erbqQAWSJN%2FDie.png?alt=media\&token=679915d4-0574-4b63-a4ed-fdb470f9fcfc)

* **High roll threshold** - determines the minimum number for a high roll, for linking purposes. The default is 4. E.g.:
  * If I roll 1, 2 or 3, I've rolled low
  * If I roll 4, 5 or 6, I've rolled high
    * Can be used to easily create a 2-option outcome

### Common Uses

* Introducing chance to games - maximises replayability
* Randomised ambience