Quickstart

Build and publish your first AI NPC in five steps.

1. Create a Persona

Click New Persona from the dashboard. Give your character a name and an identity prompt — a paragraph describing who they are, how they speak, and what they know. This is the foundation the AI uses to stay in character.

2. Add a Scenario

Inside your persona, click New Scenario. Set an objective that describes what this conversation is about — for example, "Negotiate a trade deal" or "Conduct a job interview." The editor opens with a default initial state.

3. Define States

States are the phases of your conversation. Add at least three:

  • Initial — Where the conversation begins. The NPC introduces itself.
  • Intermediate — The core interaction (negotiation, Q&A, problem-solving).
  • Terminal — The conversation ends with a result or farewell.

For each state, write a system prompt telling the AI how to behave in that phase.

4. Configure Transitions

When you add a state, default transitions are created automatically. Click on any transition to edit its condition (what the player needs to say or do) and decision type:

  • pass — Advance to the next state.
  • redirect — Stay in the current state and retry. The player didn't quite pass or fail.
  • reject — In non‑scoring mode, ends the conversation at the REJECT terminal state. In scoring mode, advances via the pass transition but deducts a point.
  • kick_out — End the conversation immediately.

5. Test and Publish

Open the Chat Preview panel to run a live conversation with your NPC. Watch state transitions happen in real time and tweak prompts until it feels right. When you're satisfied, click Publish to generate a share link anyone can use.

Iterate freely
Your first version doesn't need to be perfect. Publish early, gather feedback, and refine your states and transitions over time.