README.md

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