tor-roller

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 (must be installed and in your PATH)

Usage

# 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:

# 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