LLM-Controlled
Social Simulations

A Phaser.js game engine for creating AI-driven social scenarios. Characters move, talk, and interact — all orchestrated by your LLM.

▶ Try the Demo View on GitHub
🎮

Interactive demo at /player.html

EXPLORE

🎮

Scenario Player

Watch scenarios play out with characters moving, talking, and interacting. Test your YAML scenarios in real-time.
🎨

Locale Editor

Design scenes visually. Drag props, set positions, and export YAML. Demo mode — changes saved to your browser.
📡

Action API

Browse the JSON schema for LLM actions. See available commands like say, move, emote, and more.
📦

GitHub & Docs

Full source code, AGENTS.md documentation, example scenarios, and integration guides.

FEATURES

🤖

LLM Integration

Built-in callbacks for LLM decision points. Your AI controls character actions.

⚛️

React Component

<PixelGame> component with full TypeScript support and ref-based API.

📝

YAML Scenarios

Define scenes, characters, and sequences in readable YAML format.

🐍

Python Client

Headless mode for simulations and evaluations. No browser required.

QUICK START

import { PixelGame } from 'pixelgame/react';

function App() {
  return (
    <PixelGame
      scenario={scenarioYaml}
      autoPlay={true}
      onReady={() => console.log('Ready!')}
      onLLMQuery={async (req) => {
        // Your LLM decides what the character does
        return { actions: [{ action: 'say', params: { text: 'Hello!' }}] };
      }}
    />
  );
}