Documentation
Everything you need to build persistent game worlds with MistScale, from identities and relationships to your first AI Character.
Getting Started
Introduction
MistScale is persistent world infrastructure for games: identity, relationships, and state that carry across every session. AI Characters are the first product built on it, with persistent memory, emotion, mood, and per-player relationships.
Quick Start
Get from signup to your first live conversation with a MistScale AI Character in about five minutes. Sign up, create a Project for your world, build a character, and chat with it in the Playground.
World Primitives
Player Identities
Every player and every NPC that can take part in a conversation gets a canonical, project-scoped Identity. This is what memory, relationships, and chat history are actually tracked against — separate from an NPC's own character identity (name, voice, personality).
Relationships
Every Mistscale NPC keeps a private record for every player they've spoken to. Trust, patience, mood, and emotion are tracked independently. The same character can be warm with one player and hostile to another with no extra setup, and characters can hold trust toward each other.
Information Sharing
What a player tells one character can reach the other characters it trusts. Sharing follows per-character rules and trust thresholds, travels one hop, and always arrives as unverified hearsay. Off by default.
MNEMIS Memory
Mistscale NPCs remember through MNEMIS, a memory system that stores understanding instead of transcripts. It extracts meaningful facts, consolidates emotional signals into mood shifts, and retrieves the right past memory at the right moment.
Spatial Context
Spatial Context is Mistscale's real-time environmental awareness covering location, time, weather, and freeform context that shapes how an NPC responds in the moment. It's deliberately short-lived (five minutes) because stale context is worse than no context.
AI Characters
NPCs & Neural Identity
A Mistscale NPC is a persistent character built from three layers: Identity (name, voice, backstory), Cognitive (traits, goals, fears), and Knowledge (lore files). Together they produce behavior far richer than any dialogue tree.
Emotion & Mood
Mistscale separates volatile emotion (the immediate feeling driving the current reply) from stable mood (the long-term baseline an NPC carries toward a specific player). Together they produce believable affect across time.
Knowledge Base (RAG)
Upload text or files when creating or editing an NPC. Mistscale splits the content into chunks, embeds them, and retrieves the relevant pieces every time the NPC speaks, so answers stay grounded in your canonical lore.
World Knowledge
Overview
What World Knowledge is: a project-wide library of lore, facts and rules you can share with many NPCs. Learn how it differs from per-NPC knowledge, what audiences and visibility mean, how the draft → Deploy staging model works, and what is available today.
Creating & Managing Documents
Upload world-knowledge documents, choose who can read them, assign them to NPCs and audiences, track their status, and Deploy them live. Everything you do day-to-day on the World Knowledge page.
Audiences
Audiences are reusable groups of NPCs (e.g. guards, tavern_folk). Create them, manage their members in a side drawer, and share restricted documents with a whole group at once instead of one NPC at a time.
Using the Platform
Creating an NPC
Open your Project, go to NPCs, click Create NPC, and fill three layers: Identity, Cognitive, Knowledge. Save, and the NPC is immediately usable in the Playground.
Editing & Deleting
The NPC editor is the same surface used for creation. Open the NPC, change any field across Identity, Cognitive, or Knowledge, and save. The next conversation reflects the changes. Deletion removes identity, knowledge, and memories and cannot be undone.
Knowledge Files
Open the NPC editor's Knowledge layer to upload text or files (up to 3 per NPC). Each file passes through pending → processing → ready before the NPC uses it. Delete from the file list to remove both the original and all indexed chunks.
Using the Playground
Open a Project's Playground, pick an NPC from the sidebar, type a message, and watch the right-hand inspector show the NPC's emotion, mood, thinking trace, and newly formed memories update live.
Project Settings
Open the Project from the Dashboard, go to Settings in the project navigation, edit the name or other options, and save. Changes propagate to every NPC and Playground session inside the project.
Invites & Team
Open a Project's Settings, go to Members, and invite a collaborator by email. They accept from their Pending invites page and get access to that Project.
Account Settings
Open Settings from the dashboard navigation to update your display name, email, or password. Account settings are scoped to you personally, not to a Project.
Usage & Billing
Two dashboard pages handle it. Usage breaks down consumption by Project and NPC, while Billing shows your plan, payment, and invoices. Plan upgrades take effect immediately; usage figures may lag real-time activity by a few minutes.
Integrations
Unreal Overview
What the Mistscale Unreal plugin gives you and how the pieces fit together.
Installation & Setup
Drop the Mistscale plugin into your Unreal project and configure the subsystem.
Your First NPC
List your NPCs, connect to one, and stream a reply, in C++ and Blueprint.
Voice
Stream captured audio to an NPC and play back its spoken reply.
Spatial Context in Unreal
Make NPCs react to where they are: location, time of day, and weather from your game state.
Unity Overview
What the Mistscale Unity SDK gives you and how the pieces fit together.
Installation & Login
Add the Mistscale package to Unity, authenticate with your API key, and browse your NPCs in the editor.
Your First NPC
Put a talking Mistscale NPC in your scene with one component and a few lines of code.
Voice Conversations
Push-to-talk NPC conversations with voice detection and automatic reply playback.
Spatial Context in Unity
Make NPCs react to where they are: location, time of day, and weather from your game state.
Godot Overview
What the Mistscale Godot addon gives you and how the pieces fit together.
Installation & Setup
Copy the Mistscale addon into your Godot project and configure the singleton.
Your First NPC
List your NPCs, connect to one, and stream a reply.
Voice
Stream captured audio to an NPC and play back its spoken reply.
Spatial Context in Godot
Make NPCs react to where they are: location, time of day, and weather from your game state.
Web SDK Overview
What the Mistscale Web SDK gives you and how the pieces fit together.
Installation & Setup
Install the Mistscale Web SDK and create your first client.
Your First NPC
List your NPCs, connect to one, and stream a reply — in about fifteen lines.
Voice
Stream captured audio to an NPC and play back its spoken reply.
Spatial Context in the Web SDK
Make NPCs react to where they are: location, time of day, and weather from your game state.
REST & WebSocket API
Integrate directly over HTTP and WebSocket, without installing any SDK.
Reference
Limits
Each NPC supports up to 3 knowledge files by default, mood moves along a 10-step scale, spatial context auto-expires after 5 minutes, and NPC/Project counts are plan-dependent. Most ceilings lift with an upgrade. Contact us if a limit is blocking work.
Changelog
Platform updates, new features, and fixes now live on the dedicated Changelog page.