# The One Ring - Dice Roller

A CLI dice roller for *The One Ring* RPG, enhanced with `gum` for animations.

## Features

- Rolls Feat Dice (d12) with special symbols:
  - **Eye of Mordor** (1)
  - **Gandalf Rune** (12)
- Rolls Success Dice (d6) with special symbols:
  - **Magnificent Success** (6)
- Cryptographically secure randomness using `/dev/urandom`
- Terminal animations using `gum`
- FontAwesome symbols for dice types ( for d12,  for d6)
- **Macro System**: Save and recall complex dice configurations
  - Named macros for quick access
  - Support for Advantage/Disadvantage
  - Bonus/debuff modifiers
  - Configurable dice counts

## Prerequisites

- **Bash**
- **[Gum](https://github.com/charmbracelet/gum)** (must be installed and in your PATH)

## Usage

```bash
# Make executable
chmod +x roll_tor.sh

# Roll 1 Feat Die (default) - shows  symbol
./roll_tor.sh

# Roll 1 Feat Die + 3 Success Dice - shows  symbols
./roll_tor.sh 1 3

# Roll 2 Feat Dice - shows  symbols
./roll_tor.sh 2 0
```

### Macro System

Save frequently used dice configurations for quick access:

```bash
# Save macros
./roll_tor.sh --save-macro hero 1 3          # Basic macro
./roll_tor.sh --save-macro attack 2 4 adv    # With advantage
./roll_tor.sh --save-macro spell 1 2 disadv  # With disadvantage
./roll_tor.sh --save-macro skill 1 2 +5      # With +5 bonus
./roll_tor.sh --save-macro heroic 2 3 adv +5 # Complex macro

# List all saved macros
./roll_tor.sh --list-macros

# Use a saved macro
./roll_tor.sh hero

# Delete a macro
./roll_tor.sh --delete-macro hero

# Get help
./roll_tor.sh --macro-help
```

### Macro Features

- **Named Macros**: Assign descriptive names to your dice configurations
- **Advantage/Disadvantage**: Roll 2 sets and keep highest/lowest
- **Modifiers**: Add bonuses (+) or debuffs (-) to the final result
- **Persistent Storage**: Macros are saved to `~/.tor-roller-macros`
- **Validation**: Input validation ensures valid dice counts and modifiers