Spaces:
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.)