Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/msadeqsirjani/dnd_ai_dm
An AI-powered Dungeon Master that generates dynamic D&D adventures, manages NPCs, and handles combat mechanics. Create immersive storytelling experiences with procedural world generation and natural language interaction
https://github.com/msadeqsirjani/dnd_ai_dm
ai dungeons-and-dragons game-development procedural-generation python rpg
Last synced: 4 days ago
JSON representation
An AI-powered Dungeon Master that generates dynamic D&D adventures, manages NPCs, and handles combat mechanics. Create immersive storytelling experiences with procedural world generation and natural language interaction
- Host: GitHub
- URL: https://github.com/msadeqsirjani/dnd_ai_dm
- Owner: msadeqsirjani
- License: mit
- Created: 2024-11-24T16:57:37.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2024-11-24T17:03:00.000Z (3 months ago)
- Last Synced: 2024-12-17T01:36:40.688Z (about 2 months ago)
- Topics: ai, dungeons-and-dragons, game-development, procedural-generation, python, rpg
- Language: Python
- Homepage:
- Size: 10.7 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🎲 AI-Powered D&D Game Master 🐉
An intelligent Dungeon Master powered by AI that creates dynamic, engaging D&D adventures! This console-based application generates unique storylines, manages NPCs, and handles combat mechanics while adapting to player choices.
## ✨ Features
- 🤖 AI-driven storyline generation using GPT models
- 🎭 Dynamic NPC creation and management
- ⚔️ Turn-based combat system with D&D 5e rules
- 🌍 Procedural world generation
- 🎲 Realistic dice rolling mechanics
- 💬 Natural language processing for player commands
## 🏗️ Project Structure
```bash
dnd_ai_dm/
├── core/ # Core game mechanics
│ ├── game_manager.py # Main game controller
│ ├── story_generator.py # AI story generation
│ ├── npc_manager.py # NPC handling
│ └── combat_system.py # Combat mechanics
├── models/ # Game entities
│ ├── character.py # Player character
│ ├── npc.py # NPC definition
│ └── world_state.py # World tracking
├── utils/ # Utility functions
│ ├── dice.py # Dice rolling
│ └── text_processor.py # Text handling
└── main.py # Entry point
```
## 🚀 Getting Started
### Prerequisites
- Python 3.8+
- OpenAI API key
### Installation
1. **Clone the repository**
```bash
git clone https://github.com/msadeqsirjani/dnd_ai_dm.git
```
2. **Create a virtual environment**
```bash
python -m venv venv
```
3. **Activate the virtual environment**
```bash
source venv/bin/activate
```
4. **Install requirements**
```bash
pip install -r requirements.txt
```
5. **Set up environment variables**
Create a `.env` file in the project root:
```bash
OPENAI_API_KEY=
```
### 🎮 Running the Game
```bash
python main.py
```
## 🎯 Core Components
### 🤖 Story Generator
- Utilizes OpenAI's GPT models
- Creates dynamic quest narratives
- Adapts story based on player choices
### 🎭 NPC Manager
- Generates unique NPCs with personalities
- Manages NPC interactions and relationships
- Tracks NPC locations and knowledge
### ⚔️ Combat System
- Initiative-based turn order
- D&D 5e combat rules
- Dice rolling mechanics
### 🌍 World State
- Tracks game world status
- Manages locations and quests
- Handles time and weather systems
## 📝 Example Gameplay
```bash
Welcome to AI D&D!
=================
Your quest begins:
You find yourself in the village of Eldermist, where rumors of strange
disappearances have been circulating...
What would you like to do?: talk to innkeeper
```
### Adding New Features
1. Create new modules in appropriate directories
2. Update the GameManager to integrate new features
3. Add tests for new functionality
4. Update documentation
## 🤝 Contributing
1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Open a Pull Request
## 📜 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🙏 Acknowledgments
- OpenAI for GPT API
- D&D 5e SRD for game mechanics
## 📞 Contact
MOHAMMADSAEGH SIRJANI - [@msadeqsirjani](https://twitter.com/msadeqsirjani)
Project Link: [https://github.com/msadeqsirjani/dnd_ai_dm](https://github.com/msadeqsirjani/dnd_ai_dm)
---
Made with ❤️ by MOHAMMADSADEGH SIRJANI