-
Notifications
You must be signed in to change notification settings - Fork 1
Home
UnscriptedAdventures is a text-based RPG game that leverages Large Language Models (LLMs) to create an immersive, single-player tabletop role-playing game (TTRPG) experience. Players interact with a virtual Game Master (GM) and various Non-Player Characters (NPCs) through a dynamic storytelling system, where their choices shape the game’s narrative in real-time.
The game draws inspiration from classic TTRPGs like Dungeons & Dragons, while utilizing AI to adapt the story based on player decisions. It supports the full player journey, from character creation to campaign development and gameplay, with each part of the system guided by intelligent agents.
- Dynamic Storytelling: A virtual GM driven by an LLM guides the story, responding to player choices and shaping the narrative in real-time.
- Character Customization: Players can create and develop unique characters with various traits, backgrounds, and professions.
- Interactive World: Explore a rich, evolving world where NPCs react to player decisions, and storylines adapt accordingly.
- Game Mechanics Support: Core game mechanics are enforced using official D&D sourcebooks, ensuring consistency with established rules.
- Seamless Session Management: The system tracks player progress, allowing players to leave and return to the game without losing any context or consistency in the storyline.
UnscriptedAdventures is built around three key systems that work together to provide a cohesive and immersive experience:
-
Character Creation System:
- Guide the player through the creation of a fully customizable character.
- Enforce game rules and provide access to official sourcebook information.
-
Campaign Creation System:
- Assist the DM or player in creating rich campaign settings, story arcs, and NPC interactions.
- Leverage LLMs to enhance world-building and adapt campaign elements dynamically.
-
Gameplay System:
- Manage the active game, guiding the player through narrative choices, combat scenarios, and NPC interactions.
- Ensure consistent storytelling using a memory management system that tracks player actions and game state.
To begin your adventure with UnscriptedAdventures, follow these steps:
-
Clone the Repository:
- Get the latest version of the game from GitHub by cloning the repository to your local machine.
-
Install the Required Dependencies:
- UnscriptedAdventures runs on Python 3.7+ and Flask. Check out the Getting Started Guide for installation instructions.
-
Create Your First Character:
- Use the Character Creation System to develop your in-game character. Customize everything from race and class to unique backstories that will affect gameplay.
-
Start a Campaign:
- Once your character is ready, load them into a campaign and begin exploring the world built by the virtual GM.
-
Enjoy the Adventure:
- UnscriptedAdventures is designed for immersive, single-player sessions where your decisions shape the story and world. Save and resume your game whenever you want, without losing your character or progress.
- Developer's Guide: Explore the architecture, core components, and best practices for contributing to UnscriptedAdventures.
- FAQ: Frequently asked questions about getting started, gameplay, and technical issues.
- Known Issues: A list of current bugs, troubleshooting tips, and workarounds.
We welcome contributions from the community! If you're interested in contributing to UnscriptedAdventures, check out the Developer's Guide to get started.
Thank you for joining the adventure! Start exploring, and let the UnscriptedAdventures unfold.