ivx-narrative-engine

What problem does it solve?

The Narrative Engine removes the complexity of building branching conversations, persistent story state, and character relationship systems so teams can deliver rich interactive narratives without reinventing dialog logic for each platform.

Core Features & Use Cases

• Branching Conversation Trees: Create complex node graphs with conditional choices, localized text resolution, and choice-driven story actions.
• Persistent Story State & Relationships: Flags, variables, and affinity tracking that persist locally or sync to Nakama for cross-device continuity.
• AI-Assisted Dialog & Imports: Generate dynamic NPC responses with IVXNarrativeAI and import Ink and Yarn Spinner projects for rapid content iteration.
• Cutscene Sequencer & Cross-Platform APIs: Timeline-based narrative events and a consistent API surface across Unity, Unreal, Godot, web, and consoles.
• Use Case: Implement a merchant conversation that unlocks quests, modifies relationship tiers, and persists progress to the cloud while supporting localized lines and optional TTS.

Quick Start

Start a new branching conversation merchant_greeting with a merchant opening line, add three choices including a conditional sell option, hook dialog UI to IVXDialogManager events, and enable PersistState to sync story data to Nakama.