Documentation
Everything you need to build with MistScale's AI NPC platform, from your first NPC to memory, mood, knowledge, and topology.
Getting Started
Introduction
Mistscale is an AI NPC platform that gives game characters persistent memory, evolving emotion, mood, and per-player relationships across sessions, so NPCs remember, feel, learn, and grow without dialogue trees or scripts.
Quick Start
Get from signup to your first live conversation with a Mistscale NPC in about five minutes. Sign up, set up a Studio, create a Project, build an NPC, and chat with it in the Playground.
Core Concepts
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.
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.
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.
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.
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.
Topology
Topology is the live visualization of an NPC's mind. Every meaningful thing the NPC has learned becomes a node, and related nodes auto-cluster into topics the NPC has built up an opinion or expertise on.
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, memories, and topology 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.
Viewing Topology
Open Project → NPCs → Topology, pick an NPC, and the main view renders clusters labelled by topic. Click a cluster to expand its nodes, then click a node to see the reasoning, confidence, and the conversation that produced it.
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 the Invites page, enter the email of the person you want to invite, and send. Once they accept, they appear in the Studio's team list and gain access to every Project inside the Studio.
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 Studio.
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.
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
Notable platform updates land on this page. The current headline entry is the public documentation launch covering Getting Started, Core Concepts, and platform walkthroughs.