Half Dice is a versatile bot designed for effortless dice rolling with results displayed in a user-friendly format. 
The bot supports rolling multiple dice, specialty dice, and dice with modifiers, plus features competitive tournament battles where players can face off in structured dice-based competitions.

## Core Dice Rolling Commands

### `/roll` (Default 1d100)
**Description**: Advanced dice rolling with D&D 5e modifiers  
**Usage**: `/roll [notation] [private]`  
**Examples**:
- `/roll` - Rolls 1d100 (default)
- `/roll 1d20` - Rolls a 20-sided die
- `/roll 2d6+3` - Rolls two 6-sided dice and adds 3
- `/roll 1d20 adv` - Roll with advantage (2d20kh1)
- `/roll 1d20 dis` - Roll with disadvantage (2d20kl1)
- `/roll 2d20kh1+5` - Keep highest of 2d20, add 5
- `/roll 4d6ro<3` - Reroll once if less than 3 (Great Weapon Fighting)
- `/roll 10d6ra6` - Reroll and add on 6 (Wild Magic Bombardment)
- `/roll 4d6mi2` - Minimum 2 per die (Elemental Adept)
- `/roll 2d6e6` - Explode on 6
- `/roll 2d6+3 -criton 19` - Custom crit range (Champion Fighter)
- `/roll 1d20 crit` - Force critical hit
- `/roll 1d20+5 Attack Roll` - Add a title to your roll

**D&D 5e Modifiers**:
- `adv` / `dis` - Advantage/Disadvantage (auto 2d20kh1/kl1)
- `crit` - Force critical hit
- `-criton X` - Custom crit range (e.g., `-criton 19`)
- `kh1` / `kl1` - Keep highest/lowest
- `ro<3` - Reroll once if less than 3
- `ra6` - Reroll and add on max (Wild Magic)
- `mi2` - Minimum value per die (Elemental Adept)
- `ma20` - Maximum value cap
- `e6` - Explode on specific value
- `ph1` / `pl1` - Drop highest/lowest

### `/quickroll`
**Description**: Quick dice rolls with common options  
**Usage**: `/quickroll [dice_type] [modifier] [advantage] [private]`  
**Examples**:
- `/quickroll dice_type:d20 modifier:5`
- `/quickroll dice_type:d20 advantage:advantage`
- `/quickroll dice_type:d6 modifier:3`

**Dice Types**: d4, d6, d8, d10, d12, d20, d100

### `/multiroll`
**Description**: Roll the same dice multiple times  
**Usage**: `/multiroll <iterations> <dice> [private]`  
**Examples**:
- `/multiroll 5 1d20+3` - Roll 1d20+3 five times
- `/multiroll 10 2d6` - Roll 2d6 ten times
- Shows total and average of all rolls

### `/iterroll`
**Description**: Roll multiple times against a DC  
**Usage**: `/iterroll <iterations> <dice> <dc> [private]`  
**Examples**:
- `/iterroll 10 1d20+5 15` - Roll 10 times vs DC 15
- Shows success rate and pass/fail for each roll

## D&D 5e Character Commands

### `/stats`
**Description**: Roll character ability scores  
**Usage**: `/stats [method] [private]`  
**Methods**:
- **Standard**: 4d6 drop lowest (official D&D 5e rules)
- **Heroic**: 4d6 drop lowest, reroll 1s (higher stats)
- **Classic**: 3d6 straight (old school)

**Features**:
- Rolls 6 stats automatically
- Shows individual rolls with dropped dice
- Displays sorted array, total, average
- Calculates point buy equivalent

**Example**: `/stats method:standard`

### `/initiative`
**Description**: Roll initiative for combat  
**Usage**: `/initiative [modifier] [advantage] [private]`  
**Examples**:
- `/initiative modifier:3` - Roll initiative with +3
- `/initiative modifier:2 advantage:True` - Roll with advantage

### `/save`
**Description**: Roll a saving throw  
**Usage**: `/save <ability> [dc] [advantage] [private]`  
**Examples**:
- `/save ability:5 dc:15` - Roll save with +5 vs DC 15
- `/save ability:3 advantage:advantage` - Save with advantage
- `/save ability:-1 dc:12` - Negative modifier allowed

**Shows**: Success/failure if DC provided, color-coded results

### `/check`
**Description**: Roll an ability or skill check  
**Usage**: `/check <skill> <modifier> [dc] [advantage] [private]`  
**Examples**:
- `/check skill:Stealth modifier:7 dc:12`
- `/check skill:Perception modifier:5 advantage:advantage`
- `/check skill:"Sleight of Hand" modifier:8 dc:15`

**Shows**: Success/failure if DC provided, color-coded results

### `/deathsave`
**Description**: Roll a death saving throw  
**Usage**: `/deathsave [advantage] [private]`  
**Features**:
- Automatically tracks successes and failures
- **Natural 20**: Regain 1 HP, tracker resets
- **Natural 1**: Counts as 2 failures
- **3 Successes**: Character stabilizes
- **3 Failures**: Character dies

**Example**: `/deathsave advantage:True`

### `/resetdeathsaves`
**Description**: Reset your death saving throw tracker  
**Usage**: `/resetdeathsaves`

### `/percentile`
**Description**: Roll percentile dice (d100)  
**Usage**: `/percentile [private]`  
**Features**:
- Shows tens (00-90) and ones (0-9) separately
- Proper d100 format: 00 + 0 = 100
- Perfect for Wild Magic tables, treasure rolls

## Advanced D&D Combat Commands

### `/attack`
**Description**: Roll attack with damage  
**Usage**: `/attack <bonus> <damage> [advantage] [target_ac] [private]`  
**Examples**:
- `/attack bonus:5 damage:1d8+3` - Basic attack
- `/attack bonus:7 damage:2d6+4 fire advantage:advantage` - Attack with advantage
- `/attack bonus:5 damage:1d8+3 target_ac:15` - Check if hit lands
- `/attack bonus:8 damage:1d6 cold + 1d4 poison` - Multiple damage types

**Features**:
- Auto-doubles damage dice on critical hits
- Supports multiple damage types
- Shows hit/miss if AC provided
- Natural 20 = auto-crit, Natural 1 = auto-miss

### `/damage`
**Description**: Roll damage dice only  
**Usage**: `/damage <dice> [crit] [private]`  
**Examples**:
- `/damage dice:2d6+3` - Basic damage
- `/damage dice:2d6+3 crit:True` - Critical damage (doubles dice)
- `/damage dice:1d8 fire + 1d6 cold` - Multiple damage types

### `/concentration`
**Description**: Roll concentration saving throw  
**Usage**: `/concentration <damage> [bonus] [advantage]`  
**Examples**:
- `/concentration damage:15 bonus:3` - Auto-calculates DC
- `/concentration damage:22 bonus:5 advantage:True` - With advantage

**Features**:
- DC = half damage taken (minimum 10)
- Shows if concentration maintained or broken

## Character Tracking Commands

### `/hp`
**Description**: Track your hit points  
**Usage**: `/hp <action> [amount] [max_hp]`  
**Actions**:
- **Set HP**: `/hp action:set amount:25 max_hp:50`
- **Take Damage**: `/hp action:damage amount:10`
- **Heal**: `/hp action:heal amount:8`
- **Add Temp HP**: `/hp action:temp amount:5`
- **View HP**: `/hp action:view`

**Features**:
- Visual HP bar
- Temp HP absorbs damage first
- Warns when unconscious (0 HP)
- Color-coded by health percentage

### `/spellslots`
**Description**: Track spell slots  
**Usage**: `/spellslots <action> [level] [amount]`  
**Actions**:
- **Set Slots**: `/spellslots action:set level:1 amount:4`
- **Use Slot**: `/spellslots action:use level:3`
- **Recover Slot**: `/spellslots action:recover level:2`
- **Long Rest**: `/spellslots action:longrest` (recovers all)
- **View Slots**: `/spellslots action:view`

**Features**:
- Track levels 1-9
- Visual slot display (◉ available, ◯ used)
- Per-user tracking

### `/inspiration`
**Description**: Toggle inspiration on/off  
**Usage**: `/inspiration`

### `/wildmagic`
**Description**: Roll on Wild Magic Surge table  
**Usage**: `/wildmagic`  
**Features**:
- Rolls d100
- Shows Wild Magic effect

## Tournament Commands

### `/tournament`
**Description**: Join or view dice rolling tournaments  
**Usage**: React with 🎲 to join when announced

### `/h2p`
**Description**: Show how to play tournament instructions  
**Usage**: `/h2p`

**Tournament Flow**:
1. Admin starts a tournament
2. Players react with 🎲 to join (60-second window)
3. Elimination-style battles begin
4. Use any roll command when it's your turn
5. Higher roll wins each round
6. Last player standing wins

### `/tournamentstatus` 
**Description**: Check current tournament status  
**Usage**: `/tournamentstatus`

### `/canceltournament` 
**Description**: Cancel the current tournament (Admin only)  
**Usage**: `/canceltournament`

## Math & Utility Commands

### `/math`
**Description**: Evaluate mathematical expressions in infix or postfix notation  
**Usage**: `/math <expression>`  
**Examples**:
- `/math 5*5` - Basic arithmetic (25)
- `/math (2+3)*4` - With parentheses (20)
- `/math sqrt(9)` - Square root (3)
- `/math sin(1.57)` - Trigonometric functions
- `/math 5 5 *` - Postfix notation (25)
- `/math 2 3 + 4 *` - Complex postfix (20)

**Supported Operations**:
- Basic: `+`, `-`, `*`, `/`, `//` (floor division), `%` (modulo)
- Powers: `**`, `^`
- Functions: `sqrt`, `sin`, `cos`, `tan`, `log`, `ln`, `log10`, `abs`, `floor`, `ceil`

### `/vote` 
**Description**: Vote for the bot on Top.gg to receive rewards  
**Usage**: `/vote`

**Rewards**:
- Receive voter role for 24 hours in the Official Server
- Get reminded when you can vote again
- Support the bot's growth

### `/purge`
**Description**: Delete and recreate the current channel (removes ALL messages)  
**Usage**: `/purge`  
**Requirements**: Administrator, Manage Channels, or Manage Messages permission

**Warning**: This command completely deletes the channel and recreates it, removing all message history permanently.

### `/botstats`
**Description**: View bot statistics  
**Usage**: `/botstats`

**Shows**: Server count, member count, shard info, latency

## Quick Reference Table

| Command | Description | Example |
|---------|-------------|---------|
| `/roll` | Advanced dice rolling | `/roll 2d20kh1+5` |
| `/quickroll` | Quick preset rolls | `/quickroll dice_type:d20 modifier:5` |
| `/multiroll` | Roll multiple times | `/multiroll 5 1d20+3` |
| `/iterroll` | Roll vs DC multiple times | `/iterroll 10 1d20+5 15` |
| `/stats` | Roll character stats | `/stats method:standard` |
| `/initiative` | Roll initiative | `/initiative modifier:3` |
| `/save` | Saving throw | `/save ability:5 dc:15` |
| `/check` | Ability/skill check | `/check skill:Perception modifier:7` |
| `/deathsave` | Death saving throw | `/deathsave` |
| `/percentile` | Roll d100 | `/percentile` |
| `/attack` | Attack with damage | `/attack bonus:5 damage:1d8+3` |
| `/damage` | Damage roll | `/damage dice:2d6+3` |
| `/concentration` | Concentration check | `/concentration damage:15 bonus:3` |
| `/hp` | HP tracker | `/hp action:damage amount:10` |
| `/spellslots` | Spell slot tracker | `/spellslots action:use level:3` |
| `/inspiration` | Toggle inspiration | `/inspiration` |
| `/wildmagic` | Wild Magic table | `/wildmagic` |
| `/math` | Math calculations | `/math 5*5` |
| `/tournament` | Tournament commands | React with 🎲 to join |
| `/vote` | Vote for rewards | `/vote` |

## Usage Notes

- All dice commands support `private:True` for private rolls visible only to you
- Math commands support both infix (`5*5`) and postfix (`5 5 *`) notation
- Death saves are tracked per user across the server
- Critical hits (nat 20) and fumbles (nat 1) are automatically detected and highlighted
- HP and spell slots are tracked per user and persist across sessions

## Donations and Premium 

- Gain access to Unlimited Tournaments Daily!
- Help keep the bot online

[![Support HalfDice on Ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/halfdice)

---

*For support, feature requests, or bug reports, join our official Discord server!*

Half Dice

Made for dice rolling and Tournaments! Supports multiple modded and special dice.

Voting for Half Dice

Do you want to support us?