Introduction
Get ready to build your worlds
Narrative Protocol
Narrative Protocol is a World State & Event Engine that enables you to define and execute complex world simulations.
Machine-Readable Documentation
The documentation is also available for machine readers at /llms.txt (concise) and /llms-full.txt (complete).
Key Concepts
Layers
The system separates the design layer (Blueprint) and runtime layer (Live):
- Blueprint: Define your world, entity schemas, and events
- Live: Create deployments, instances, and execute events
Core Components
| Component | Layer | Description |
|---|---|---|
| Worlds | Blueprint | Container for all definitions (title, tags, prompt seed) |
| Entity Schemas | Blueprint | Define the shape of entities (e.g., Horse, Track, Jockey) |
| Events | Blueprint | Define what can happen (with versioned behavior) |
| Deployments | Live | Running instance of a world with its own state |
| Instances | Live | Actual entities based on entity schemas (e.g., HORSE_1, HORSE_2) |
Feature Highlights
AI Event Execution
Events can mutate the world by using an AI engine with configurable model selection. Each deployment can use a different AI model. Every AI response includes a cryptographic attestation for verification.
Snapshotting
Create new deployments by copying state from existing ones, useful for forking simulations or creating test environments.
Multi-Chain Oracle
Event execution records can be pushed to Solana and/or NEAR networks. This is useful for on-chain games or archival records.
Quick Links
- Quickstart Guide - Get running in 5 minutes
- Core Concepts - Understand the architecture
- API Reference - Complete API documentation