# Project export: Nat One

This document was generated by HackStack to give an AI agent context about a hackathon project. Sections are labeled with their provenance; content marked as truncated was cut to keep this document small.

## Project metadata

- Hackathon: Cal Hacks 12.0
- Tagline: An AI-powered D&D website where players speak their actions, and the AI Dungeon Master generates story text, scenes, and maps in real time, with dice rolls and player tracking built in.
- Devpost: https://devpost.com/software/nat-one
- GitHub: not linked
- Demo: https://nat-one-ai-dungeon-master.replit.app/
- Video: https://www.youtube.com/embed/pFBtSDTTHKw?enablejsapi=1&hl=en_US&rel=0&start=&version=3&wmode=transparent
- Team: contributor stats unavailable

## Devpost submission (written by the team)

### Inspiration

We were inspired by the magic of tabletop role-playing games like Dungeons & Dragons — the creativity, collaboration, and unpredictable storytelling that comes from a group of players sharing an adventure. We wanted to recreate that experience online with the help of AI. What It Does Nat One is a multiplayer website where users can play Dungeons & Dragons together with an AI-powered Dungeon Master. The AI Dungeon Master listens to the players’ conversations in real time, transcribes their dialogue, and generates new story elements to continue the adventure. The scene display updates dynamically with AI-generated maps or images that reflect what’s happening in the story. Players can view the transcribed dialogue and the AI’s narrative directly on the screen. The interface also includes a player list and a dice roller for quick gameplay actions. How We Built It We built Nat One using a combination of front-end web technologies and AI APIs. The Lava API powers story and scene generation, while the Fish API handles the Dungeon Master's voice output using text-to-speech. We connected these APIs through a web interface that manages player interactions, transcriptions, and visual updates. Challenges We Ran Into Neither of us had ever implemented an API before, so figuring out how to get the Lava API to generate coherent stories and the Fish API to output the Dungeon Master’s dialogue with an AI voice was a huge challenge. Synchronizing all these systems — the audio, story text, and visuals — to feel natural and responsive took a lot of experimentation. Accomplishments That We're Proud Of We’re proud that we created a functional prototype where players can speak, see their dialogue transcribed, and have an AI Dungeon Master respond both through voice and text. Getting multiple APIs to communicate smoothly and bring an RPG world to life felt like a critical win. What We Learned We learned how to integrate APIs into a web app, manage asynchronous data flows, and balance user interactivity with AI-generated content. We also gained a deeper appreciation for how complex and rewarding building immersive storytelling systems can be. What's Next for Nat One We’d love to expand Nat One with more features, including: Integration with character sheets Ability to bring in NPCs and have different AI voices for each NPC Our ultimate goal is to make AI-driven storytelling as rich and unpredictable as a real D&D session — where every “Nat One” moment turns into a story worth telling.

## README (from the GitHub repository)

No README available.

## Detected evidence (automated analysis)

No repository was indexed for this project. Claimed technologies below could not be checked against code.
- CSS (language) — claimed on Devpost, not found in the code
- Express (technology) — claimed on Devpost, not found in the code
- PostgreSQL (technology) — claimed on Devpost, not found in the code
- React (technology) — claimed on Devpost, not found in the code
- Tailwind CSS (technology) — claimed on Devpost, not found in the code
- TypeScript (language) — claimed on Devpost, not found in the code

## Codebase structure

No repository index available.

## Key source files

No repository index available; no source files included.