storyteller/docs/features

🎭 Features Documentation

Detailed documentation for all Storyteller RPG features.

---

Feature Guides

Core Features

Demo Session

Pre-configured test session that auto-loads on startup. Includes two characters (Bargin & Willow) and "The Cursed Tavern" adventure. Perfect for development and testing.

Quick Access:

• Session ID: demo-session-001
• One-click buttons on home page
• No setup required

---

Context-Aware Response Generator

AI-powered tool for storytellers to generate responses considering multiple characters' actions simultaneously.

Key Features:

• Multi-character selection
• Scene descriptions (broadcast to all)
• Individual responses (private to each)
• Automatic parsing and distribution
• Smart context building

---

Technical Documentation

Prompt Engineering Improvements

Details on how we improved the LLM prompts for reliable individual response parsing using the [CharacterName] format.

Topics Covered:

• Square bracket format rationale
• Regex parsing patterns
• System prompt enhancements
• Edge case handling

---

Bug Fixes Summary

Comprehensive list of bugs fixed in the latest release.

Fixed Issues:

• Character chat history showing only recent messages
• Pydantic deprecation warnings (.dict → .model_dump)
• WebSocket manager reference errors
• Session ID copy functionality

---

Feature Overview by Category

For Storytellers 🎲

Feature	Description	Status
Session Management	Create/join sessions, manage characters	✅ Complete
Scene Narration	Broadcast scene descriptions to all players	✅ Complete
Private Responses	Send individual messages to characters	✅ Complete
AI Suggestions	Get AI-generated response suggestions	✅ Complete
Context-Aware Generator	Generate responses considering multiple characters	✅ Complete
Pending Message Tracking	See which characters need responses	✅ Complete
Demo Session	Pre-loaded test scenario for quick start	✅ Complete

For Players 🎭

Feature	Description	Status
Character Creation	Define name, description, personality	✅ Complete
Private Messages	Send private messages to storyteller	✅ Complete
Public Actions	Broadcast actions visible to all players	✅ Complete
Mixed Messages	Public action + private thoughts	✅ Complete
Scene Viewing	See current scene description	✅ Complete
Public Feed	View all players' public actions	✅ Complete
Conversation History	Full chat log with storyteller	✅ Complete

Message System 📨

Feature	Description	Status
Private Messages	One-on-one conversation	✅ Complete
Public Messages	Visible to all players	✅ Complete
Mixed Messages	Public + private components	✅ Complete
Real-time Updates	WebSocket-based live updates	✅ Complete
Message Persistence	In-memory storage (session lifetime)	✅ Complete

AI Integration 🤖

Feature	Description	Status
Multiple LLM Support	GPT-4o, GPT-4, GPT-3.5, Claude, Llama	✅ Complete
AI Response Suggestions	Quick response generation	✅ Complete
Context-Aware Generation	Multi-character context building	✅ Complete
Structured Output Parsing	[CharacterName] format parsing	✅ Complete
Temperature Control	Creative vs. focused responses	✅ Complete

---

Coming Soon 🚀

Planned Features

• Database Persistence - Save sessions and characters permanently
• Character Sheets - Stats, inventory, abilities
• Dice Rolling - Built-in dice mechanics
• Combat System - Turn-based combat management
• Image Generation - AI-generated scene/character images
• Voice Messages - Audio message support
• Session Export - Export conversation logs
• User Authentication - Account system with saved preferences

---

Feature Request Process

Want to suggest a new feature?

1. Check existing documentation - Feature might already exist
2. Review roadmap - Check if it's already planned (see MVP_ROADMAP.md)
3. Create an issue - Describe the feature and use case
4. Discuss implementation - We'll evaluate feasibility and priority

---

Version History

v0.2.0 - Context-Aware Features (October 2025)

• ✅ Context-aware response generator
• ✅ Demo session with pre-configured characters
• ✅ Improved prompt engineering for parsing
• ✅ Bug fixes (chat history, Pydantic warnings)
• ✅ Session ID copy button

v0.1.0 - MVP Phase 1 (October 2025)

• ✅ Basic session management
• ✅ Character creation and joining
• ✅ Private/public/mixed messaging
• ✅ Real-time WebSocket communication
• ✅ Scene narration
• ✅ AI-assisted responses
• ✅ Multiple LLM support

---

Documentation Structure

docs/
├── features/           ← You are here
│   ├── README.md
│   ├── DEMO_SESSION.md
│   ├── CONTEXTUAL_RESPONSE_FEATURE.md
│   ├── PROMPT_IMPROVEMENTS.md
│   └── FIXES_SUMMARY.md
├── development/
│   ├── MVP_PROGRESS.md
│   ├── TESTING_GUIDE.md
│   └── TEST_RESULTS.md
├── planning/
│   ├── MVP_ROADMAP.md
│   ├── PROJECT_PLAN.md
│   └── NEXT_STEPS.md
├── setup/
│   ├── QUICKSTART.md
│   └── QUICK_REFERENCE.md
└── reference/
    ├── PROJECT_FILES_REFERENCE.md
    └── LLM_GUIDE.md

---

Need help? Check the main README or the Quick Start Guide.