Spaces:
Sleeping
Sleeping
| title: Dungeon Smasher | |
| emoji: "👁" | |
| colorFrom: yellow | |
| colorTo: pink | |
| sdk: gradio | |
| sdk_version: 5.33.1 | |
| app_file: app.py | |
| pinned: true | |
| tags: | |
| - agent-demo-track | |
| - AI dungeon master | |
| - procedural generation | |
| - worldbuilding | |
| - intelligent NPCs | |
| - storytelling | |
| - RPG | |
| - multi-agent | |
| thumbnail: >- | |
| https://cdn-uploads.huggingface.co/production/uploads/683d2ec2540df93aae2532f4/Xagf2XzjnOEUZB-a1ofXZ.png | |
| 🧠 Dungeon Smasher | |
| An Agentic Toolkit for Dynamic RPG Storytelling | |
| Built for the Hugging Face AI Agent Hackathon — Agent Demo Track | |
| 🌟 Overview | |
| Dungeon Smasher is an experimental AI toolkit for building intelligent, reactive RPG environments. Rather than a finished game, this is a modular agent demo showcasing five core systems: | |
| 🎭 DM Assistant · 👥 NPC Generator · 🗺️ World Builder · 💰 Loot Designer · 🐉 Character Creator | |
| Each module uses LLM reasoning and symbolic world logic to help GMs and players co-create immersive adventures—no prep required. | |
| ⚙️ Core Features | |
| Feature Description | |
| 🎭 AI Dungeon Master Orchestrates scenes, conflicts, and roleplay hooks with dramatic tone | |
| 👥 NPC Generator Builds named characters with secrets, flaws, goals, and voice | |
| 🗺️ World Builder Assembles regions, ruins, factions, and mythic histories | |
| 💰 Loot Master Designs magical items that reflect player actions and narrative symbols | |
| 🐉 Character Creator Generates heroes with stats, backstories, class synergy, and emotional arcs | |
| 🧪 Demo Capabilities | |
| ✅ Procedural setting, NPC, and loot generation | |
| ✅ Modular agent logic with memory and context threading | |
| ✅ Gradio-based interactive frontend for testing each system | |
| ✅ Rich character builder with storytelling-first logic | |
| ✅ Configurable, extensible, and fully open source | |
| 🧭 Demo Suggestions | |
| Explore the toolkit using these suggested flows: | |
| 🧙 Dungeon Master Agent | |
| Prompt with: "The players enter a ruined cathedral during a thunderstorm" | |
| Watch it generate narrative tension, scene tone, and roleplay threads. | |
| 👥 NPC Generator | |
| Prompt with: "a cursed knight guarding forgotten ruins" | |
| Get a complex NPC with motives, secrets, and drama potential. | |
| 🗺️ World Builder | |
| Prompt with: "a coastal nation obsessed with prophecy" | |
| Generates factions, politics, threats, and lore. | |
| 💰 Loot Master | |
| Prompt with: "a cursed artifact from a sunken temple" | |
| Produces symbolic, story-linked loot tied to in-game values. | |
| 🐉 Character Creator | |
| Prompt with: "A storm sorcerer who fears their own power" | |
| Returns stat blocks, class alignment, flaws, and heroic potential. | |
| 🛠️ Technologies | |
| Gradio 5.33.1 — Live demo interface | |
| OpenAI GPT-4 — Agent reasoning and generation | |
| Python (modular) — Custom agent scaffolding and game logic | |
| 🚀 How to Run | |
| git clone https://huggingface.co/spaces/YOUR_USERNAME/DungeonSmasher | |
| cd DungeonSmasher | |
| pip install -r requirements.txt | |
| python app.py | |
| Or view the live app at: | |
| 🌐 https://huggingface.co/spaces/YOUR_USERNAME/DungeonSmasher | |
| 🎯 Future Plans | |
| Playable dungeon mode with live turn-based flow | |
| AI narrator voice + dialogue puppeteering | |
| Campaign memory and recurring characters | |
| Dynamic player reputation, fear, and legacy | |
| Fully voiced roleplay loop via multimodal input | |
| 📄 License | |
| MIT License – Use freely, remix bravely. | |
| 💬 Final Note to Judges | |
| On Friday June 6th, I was unexpectedly terminated from my job. This wasn’t just a professional setback. It triggered a cascade of urgent and high-stakes responsibilities and I’ve spent the past several days filing legal responses and preparing to escalate claims of retaliation, IP theft, and unlawful recording. I’ve had to act as my own advocate, researcher, and legal strategist, at present. | |
| This sudden derailment had a significant impact on my ability to finalize my hackathon submission. While I still submitted something, it reflects only a fraction of what I’d intended to build. I wanted to share this contextas an honest explanation of why my submission may seem incomplete or rushed and not as an excuse. | |
| I’m grateful for the opportunity to bring this to life and for the space to create, even amidst personal crisis. | |
| Sincerely, | |
| — Jesse W. Stucker (ghost logic.) | |