dndD&D 5e toolkit for players and DMs. Roll dice, look up spells and monsters, generate characters, create encounters, and spawn NPCs. Uses the official D&D 5e SRD API.
Install via ClawdBot CLI:
clawdbot install capt-marbles/dndYour complete Dungeons & Dragons 5th Edition assistant! Look up spells, monsters, roll dice, generate characters, encounters, and NPCs.
π² Dice Roller - Roll any dice with modifiers
β¨ Spell Lookup - Search the entire SRD spell list
πΉ Monster Stats - Get full stat blocks for any creature
βοΈ Character Generator - Random characters with stats
π‘οΈ Encounter Builder - Generate balanced encounters by CR
π€ NPC Generator - Create random NPCs with personality
All commands use the dnd.py script.
# Roll 2d6 with +3 modifier
python3 dnd.py roll 2d6+3
# Roll d20
python3 dnd.py roll 1d20
# Roll with negative modifier
python3 dnd.py roll 1d20-2
# Roll multiple dice
python3 dnd.py roll 8d6
Output:
π² Rolling 2d6+3
Rolls: [4 + 5] +3
Total: 12
# Search for a spell
python3 dnd.py spell --search fireball
# Direct lookup
python3 dnd.py spell fire-bolt
# List all spells
python3 dnd.py spell --list
Output:
β¨ Fireball
Level: 3 Evocation
Casting Time: 1 action
Range: 150 feet
Components: V, S, M
Duration: Instantaneous
A bright streak flashes from your pointing finger to a point
you choose within range and then blossoms with a low roar into
an explosion of flame...
# Search for a monster
python3 dnd.py monster --search dragon
# Direct lookup
python3 dnd.py monster ancient-red-dragon
# List all monsters
python3 dnd.py monster --list
Output:
πΉ Adult Red Dragon
Huge Dragon, chaotic evil
CR 17 (18,000 XP)
AC: 19
HP: 256 (19d12+133)
Speed: walk 40 ft., climb 40 ft., fly 80 ft.
STR 27 | DEX 10 | CON 25
INT 16 | WIS 13 | CHA 21
Special Abilities:
β’ Legendary Resistance (3/Day): If the dragon fails a saving throw...
Actions:
β’ Multiattack: The dragon can use its Frightful Presence...
# Generate character with rolled stats
python3 dnd.py character
Output:
βοΈ Elara
Race: Elf
Class: Wizard
Stats:
STR: 10 (+0)
DEX: 15 (+2)
CON: 12 (+1)
INT: 16 (+3)
WIS: 13 (+1)
CHA: 8 (-1)
# Generate encounter with challenge rating
python3 dnd.py encounter --cr 5
# Random CR
python3 dnd.py encounter
Output:
π² Random Encounter (CR ~5)
2x Troll (CR 5)
AC 15, HP 84
1x Ogre (CR 2)
AC 11, HP 59
python3 dnd.py npc
Output:
π€ Finn Shadowend
Race: Halfling
Occupation: Merchant
Trait: Curious
Add --json to any command for structured output:
python3 dnd.py roll 2d6 --json
python3 dnd.py spell --search fireball --json
python3 dnd.py character --json
Uses the official D&D 5e API which includes all System Reference Document (SRD) content.
fireball, magic-missile, cure-woundsancient-red-dragon, goblin, beholder--search dragon will show all dragons1d20, 2d6+5, 3d8-2, 100d100Enjoy your adventure! πβοΈβ¨
Generated Mar 1, 2026
Dungeon Masters and players use the toolkit during live D&D games to quickly roll dice, look up spell details, or generate NPCs on the fly, enhancing gameplay without disrupting immersion. It streamlines rule checks and reduces manual lookups in books or online.
Indie game developers and designers leverage the toolkit to generate balanced encounters, monster stats, and character profiles for creating D&D-inspired video games or board games. It provides a structured data source from the SRD API for prototyping and testing.
Educators and therapists use the toolkit in classroom or therapeutic settings to facilitate role-playing exercises, generating characters and encounters to teach teamwork, creativity, and problem-solving. It simplifies setup for structured storytelling activities.
Streamers and content creators on platforms like Twitch or YouTube integrate the toolkit to roll dice, spawn NPCs, or build encounters during live D&D streams, adding interactive elements and visual aids for audience engagement.
Organizers of gaming conventions or local meetups use the toolkit to prepare materials like pre-generated characters, encounter tables, and NPC rosters for D&D sessions, ensuring smooth event execution and participant enjoyment.
Offer the core toolkit for free with basic dice rolling and SRD lookups, then charge for advanced features like custom encounter builders, expanded content beyond SRD, or integration with virtual tabletops. Revenue comes from subscriptions or one-time purchases.
License the toolkit's backend or API access to other developers and companies building D&D-related apps, games, or educational tools. Revenue is generated through licensing fees based on usage tiers or enterprise agreements.
Monetize by partnering with gaming retailers, book publishers, or virtual tabletop platforms to promote products within the toolkit, such as linking to dice sets or rulebooks. Revenue comes from affiliate commissions on sales driven through referrals.
π¬ Integration Tip
Integrate the toolkit into chatbots or voice assistants by mapping user queries to CLI commands, ensuring JSON output for structured data handling in applications.
Terminal Spotify playback/search via spogo (preferred) or spotify_player.
Search GIF providers with CLI/TUI, download results, and extract stills/sheets.
Download videos from YouTube, Bilibili, Twitter, and thousands of other sites using yt-dlp. Use when the user provides a video URL and wants to download it, extract audio (MP3), download subtitles, or select video quality. Triggers on phrases like "δΈθ½½θ§ι’", "download video", "yt-dlp", "YouTube", "Bη«", "ζι³", "ζει³ι’", "extract audio".
Search and add movies to Radarr. Supports collections, search-on-add option.
Control Spotify playback on macOS. Play/pause, skip tracks, control volume, play artists/albums/playlists. Use when a user asks to play music, control Spotify, change songs, or adjust Spotify volume.
Search and add TV shows to Sonarr. Supports monitor options, search-on-add.