ivx-narrative-engine

Manage branching dialog, story state, and AI narrative generation across game engines.

1|4|Updated Jan 12, 2026
One-click install
npx skills add https://github.com/intelli-verse-x/Intelli-verse-X-SDK --skill ivx-narrative-engine
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ivx-narrative-engine
Source: https://github.com/intelli-verse-x/Intelli-verse-X-SDK/tree/main/.cursor/skills/ivx-narrative-engine
Command: npx skills add https://github.com/intelli-verse-x/Intelli-verse-X-SDK --skill ivx-narrative-engine

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about ivx-narrative-engine

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I implement branching dialog with persistent story state across multiple game platforms?

You implement branching dialog by creating node graphs with conditional choices and enabling the PersistState option to sync story data. The Narrative Engine provides cross-platform APIs for Unity, Unreal, Godot, web, and consoles to manage conversation trees and persistent story state.

Can I import existing Ink and Yarn Spinner projects to use with branching conversation trees?

Yes, you can import existing Ink and Yarn Spinner projects into the narrative engine. This allows rapid content iteration by bringing your pre-written branching dialog scripts directly into the story state management system.

How do I track NPC relationships and story variables locally or in the cloud?

You track NPC relationships and story variables using flags, variables, and affinity tracking. The system persists this story state locally or syncs it to Nakama for cross-device continuity of relationship tiers and quest progress.

What's the best way to generate dynamic NPC responses for cutscenes and quests?

The best way to generate dynamic NPC responses is using the IVXNarrativeAI assistant. This AI-assisted dialog feature creates interactive narrative content for quests and cutscenes, which you can sequence using the timeline-based cutscene sequencer.

Does the narrative engine support localized text resolution and TTS for NPC conversations?

Yes, the narrative engine supports localized text resolution for branching conversation trees. You can hook dialog UI to IVXDialogManager events to support localized lines and optional text-to-speech for NPC conversations across platforms.

How do I set up a conditional choice node graph for a merchant conversation?

You set up a conditional choice node graph by starting a new branching conversation, adding an opening line, and inserting choices including conditional options. You then hook dialog UI to IVXDialogManager events and enable PersistState to sync data to Nakama.