---

🏰 A powerful VTT, digital reference and various other tools powered by AI. MythicForge combines traditional VTT gaming with advanced AI capabilities to enhance your roleplaying experience. 🧙‍♂️

---

VERSION: 0.0.1 EARLY PRE-ALPHA

✨ Planned Features

• D&D 5E digital reference

  • Spells, items, monsters, and more
  • Quick search and filtering

• Character Creation & Management

  • Interactive character builder
  • Automatic stat calculations
  • Character sheet export/import
  • Custom character artwork integration

• AI-Powered Campaign Management & Tools

  • Campaign creation and management
  • Session tracking and notes
  • Player character tracking
  • AI Dungeon Master mode
  • Dynamic NPC generation
  • Intelligent encounter scaling
  • Campaign story generation
  • Memory-aware storytelling

• Flexible AI Integration

  • OpenAI, Google Gemini support
  • Local AI option for offline use
  • Customizable AI parameters

• DM Tools

  • Random encounter generator
  • Custom monster creator
  • Loot table generator
  • Initiative tracker
  • Interactive maps

• Dice Roller

  • Customizable dice sets
  • Advanced roll modifiers
  • History and statistics tracking

🚀 Getting Started

Prerequisites

• Python 3.8 or higher
• Node.js 14.x or higher
• SQLite3

Installation

1. Clone the repository

git clone https://github.com/armysarge/mythicforge.git
cd mythicforge

2. Install Python dependencies

pip install -r requirements.txt

3. Install Node.js dependencies

npm install

4. Configure your environment

cp .env.example .env
# Edit .env with your API keys and preferences

5. Start the application

npm run start

6. To update the application, run

python scripts/update.py

The application will be available at http://localhost:3000

🔧 Configuration

AI Provider Setup

Configure your preferred AI provider in the .env file:

AI_PROVIDER=openai  # Options: openai, gemini, local, none
OPENAI_API_KEY=your_key_here
GEMINI_API_KEY=your_key_here

📋 Roadmap

• ✅ Include 5E tools (Thanks to 5eTools)
• ✅ Basic UI/UX Design
• 🟦 Digital Reference (In Progress)
• 🟦 Dice roller (In Progress)
• ⬛️ DM tools (encounter generator, Initiative tracker, etc.)
• 🟦 Remote AI Integration (OpenAI, Google Gemini, etc) (In Progress)
• ⬛️ Local AI Integration (Local AI Model, requires extra setup)
• ⬛️ Character builder
• ⬛️ Campaign manager
• ⬛️ Run campaign with AI as DM or as player
• ⬛️ AI-powered DM tools
• ⬛️ AI-powered character builder
• ⬛️ AI-powered campaign tools
• ⬛️ Dungeon/Map Generator
• ⬛️ Soundboard for ambient sounds
• ⬛️ Multi-language support
• ⬛️ Mobile companion app
• ⬛️ Customizable character artwork

📈 Progress Screenshot

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide for details on our code of conduct and the process for submitting pull requests.

📄 License

This project is licensed under the AGPL License - see the LICENSE file for details.

🙏 Acknowledgements

• OpenAI and Google for AI capabilities
• The digital reference data was taken from 5eTools. All data is owned by Wizards of the Coast. The data is licensed under the Open Gaming License.
• 3d-dice for the dice rolling animation and logic 3d-dice
• BoxIcons for the icons used in the project BoxIcons
• Jquery for the JavaScript library Jquery
• Bootstrap for the CSS framework Bootstrap
• Node.js for the JavaScript runtime Node.js
• Other open-source projects that made this possible (see package.json, requirements.txt)
• The D&D community for inspiration and feedback

💬 Support

• Create an Issue
• Join our Discord
• Telegram Group
• Email: armysarge.ss@gmail.com

☕ Buy me a coffee

If you like this project, consider buying me a coffee to keep me motivated!

Built with ❤️ for the D&D community