koronto11 / ludo-npc-ai

Build the world. Meet the cast. Play the conversation. 
 A local narrative workbench for NPCs, branching dialogue and scene direction. 
 Bring your own AI. Keep the author's final say.
 English · 简体中文 
 Overview · Workbench · AI Skills · Local MCP · Quick start · Example · Your data · Docs · Star History · Support 
---
## A story deserves more than a wall of text
**NPCs AI Studio turns a story outline into a visible authoring workspace.** Establish the world's facts, build a cast, place characters in scenes, connect dialogue choices and rehearse what the player encounters. Use it for RPG quests, interactive fiction, narrative prototypes and NPC dialogue planning.
Your own AI can prepare the material through the bilingual Skills, or revise marked dialogue through local MCP. The built-in model connection can also generate focused candidates. Every workflow leaves you in control of the final text.
> **World brief → Characters → Scenes & appearances → Dialogue & events → Review → Rehearsal → Handoff**
| Workspace | What you can create |
| :--- | :--- |
| **🌍 World & levels** | Shared world facts and writing style, with region details and local story premises kept in each level. |
| **👥 Cast & relationships** | Key, supporting and background characters; editable profiles, knowledge, groups, quick notes and relationship connections. |
| **🎬 Scene direction** | Scene tracks and time/plot-phase anchors. Place the same character several times without copying their profile. |
| **💬 Dialogue cards** | NPC lines, player choices, conditions, effects, branches, shared destinations and endings in one connected canvas. |
| **✦ AI & review** | Character, story, dialogue and text candidates; readable review cards, field differences and protected author facts. |
| **▶ Play & delivery** | Temporary dialogue play, scene story flows, local records, reusable templates and JSON / Markdown / CSV exports. |
## Inside the workbench
### 01 · Direct the scene
Arrange appearances along scene tracks and story time. NPC groups collect background characters while keeping each member's profile and dialogue independently editable. Muted green groups, plum events and copper character controls make the canvas easier to read.
 One level · two scenes · three characters · a once-only event. Actual application capture. 
### 02 · Write the branch, then try it
Connect dialogue cards and player choices. Put availability conditions beside the response that needs them, and see why a choice is unavailable. In temporary card play, adjust the player's test state and continue from the current card.
 “I am injured. Please help.” becomes available when the test player is injured. 
### 03 · Walk through the story
Global rehearsal presents a scene story flow: enter a location, read environmental text, approach an available character and choose a response. Advance story time and inspect the events, character state and available text on the bottom timeline. Source links take you back to the authoring