Dice

What This Skill Does

The Dice skill is a specialized command-line utility for tabletop gamers and enthusiasts who require a reliable, privacy-focused tool to manage dice rolls, player scores, and gaming statistics. It operates entirely offline, storing all activity logs, session history, and game data locally in your home directory. By providing a suite of commands for rolling dice, tracking player performance, and managing leaderboards, the Dice skill acts as a comprehensive record-keeper for your RPG sessions or board game nights. It supports various data formats for export and offers built-in status monitoring to ensure your data directory remains healthy.

Installation

To integrate this utility into your OpenClaw environment, use the provided install command:

clawhub install openclaw/skills/skills/bytesagain3/dice

Once installed, verify the installation by running dice version or dice status within your terminal to ensure the directory structure is properly initialized.

Use Cases

• Tabletop RPGs: Easily track initiative rolls and damage scores without needing paper or external websites.
• Tournament Management: Use the leaderboard and ranking functions to maintain accurate standings across multiple game sessions.
• Statistical Analysis: Review long-term trends of dice rolls or performance metrics using the history and stats commands.
• Data Archiving: Periodically export game session logs to JSON or CSV formats to share with fellow players or back up your progress.

Example Prompts

1. "Dice, roll 2d20 and add the results to my current session history."
2. "Show me the current leaderboard for the group and export it to a JSON file."
3. "Can you provide a summary of my recent statistics and tell me how much space my dice data is consuming?"

Tips & Limitations

• Offline Privacy: Since this tool runs entirely locally, it is inherently safe, but you must manage your own backups. Ensure you run dice export periodically to prevent data loss.
• Directory Management: The tool stores logs in ~/.local/share/dice/. Avoid manually editing these files to prevent parsing errors.
• Resource Usage: Check your disk usage status frequently with dice status to ensure your logs aren't becoming unnecessarily large over time.