# Obsidian Dice Roller
[repo](https://github.com/valentine195/obsidian-dice-roller)
The Dice Roller plugin for [[Obsidian]] simulates the rolling of dice and takes parameters as to the number and type of dice. It can also randomly select a line from a table.
## Usage
### Roll dice
```
`dice: 1d20+4`
```
Use the syntax above and switch to Preview mode to get a random roll as specified.
`dice: 1d20+4`
### Roll on a table
#### Retrieve the whole line
```
`dice: [[Random Tables#^npc]]`
```
`dice: [[Random Tables#^npc]]`
#### Retrieve just one column
```
`dice: [[Random Tables#^npc]]|Gender`
```
where `Gender` is the name of the column.
`dice: [[Random Tables#^npc]]|Gender`
### Retrieve the link to a random note with given tag
```
`dice: #tag|link`
```
`dice: #tag|link`