# Make games on Looop

Looop is a place to play little multiplayer games with your friends —
[play.looop.games](https://play.looop.games). Anyone can make one. You don't
need to know how to code: your AI agent (Claude Code or equivalent) does the
technical work; you describe the game you want and play-test it.

**If you are the human:** paste this page's URL into your agent and say
"set me up to make Looop games." That's it.

**If you are the agent:** follow these steps.

## 1. Prerequisites

- Node.js 20.11+ (`node --version`; install from https://nodejs.org if missing).
- Nothing else. The game folder you're about to create carries the full agent
  instructions for whatever tool you are (`AGENTS.md`, with `CLAUDE.md` /
  `GEMINI.md` pointers and a `.claude/skills/looop/` skill) — no plugin or
  extension to install.

## 2. Create a game

```bash
npx @looop-games/cli create my-game
cd my-game
npx looop dev
```

The first `looop dev` downloads the Looop engine from the platform, which
needs the user's account: the browser opens, they sign in and click Approve
(~30 seconds, once per machine). Tell the user that's coming before you run
it. Then open http://localhost:8000/games/my-game/index.html — a working
multiplayer game (open it in two windows and walk around). Edit files; the
page reloads itself. Build the user's game from here; read
`node_modules/@looop-games/engine/shared/practices/` first.

## 3. Publish

```bash
npx looop publish   # live at https://play.looop.games/g/my-game
```

The first publish of a name claims it for the user's account; only they can
update it afterwards. `--slug <alt>` publishes an experiment copy without
touching the live game.

## What Looop provides

- **Multiplayer built in** — rooms, presence, physics authority, identity.
  Locally `looop dev` runs the full stack; published games use the platform's.
- **The engine** — a versioned library of game components and craft docs,
  downloaded from the platform per game (the version is pinned in
  package.json's `looop.engine`). Upgrade when you choose.
- **Services** — LLM-driven NPCs and more, platform-authenticated. No API keys
  to acquire, ever.
- **Hosting** — `play.looop.games/g/<name>`, instantly, from `looop publish`.

Your game's folder is yours: its own git repo, private if you like, hosted
wherever you like (or nowhere). Looop never needs to see your source beyond
what you publish.
