SWARMWORLD

CITY BOTS

Bots

Default 10. Needs an API key. 10k bots = 10k isolated LLM turns (parallel cap is in Settings).

Over 100 bots may be slow and expensive. Physics ticks and per-bot LLM calls can hitch; you still pay per bot.

World size

Default 48×48. Range 16–256 each. Play / Reset use this size.

Maps larger than 96×96 may be slow.

Describe a world…

City Bots

Jan 1900

$20,000

seed 1847

LLM off

LLM idle

QUERY

Click Query, then a tile or a bot.

THE CITY BOTS TIMES

Click a tool, then click-drag to paint. Right-drag pans. Query inspects tiles and bots.

LLM BYOK

Preset

OpenRouter presets use an OpenRouter key. OpenAI direct uses a key from platform.openai.com (api.openai.com). xAI direct uses a key from console.x.ai. Custom is any OpenAI-compatible Chat Completions base.

Model Base URL API key — sessionStorage only

Saved in this tab’s session only. Play and Build world use it.

Key stays in this tab (sessionStorage); never put it in the repo.

Reasoning effort

OpenRouter reasoning.effort. ox-alpha allows low / high / max (default max, cannot disable). Default leaves the model default.

Test LLM

Prompt

Parallel LLM calls

How many bot Chat Completions can run at once. Default 1. Range 1–64. After a 429 this drops to at most 2 until a success.

Min actions per plan

Floor for the JSON action list. Default 1. Range 1–max. Shown as observation.minActionsPerTurn. Shorter lists pad with wait.

Max actions per plan

Cap for the JSON action list. Default 5. Range 1–32. Shown as observation.actionsPerTurn. Extra actions are dropped.

Sensing radius

Chebyshev FOV around the bot. Default 2 (5×5). Range 1–8 (3×3 to 17×17). Shown as observation.fovRadius. Larger costs more tokens each think.

World ticks after each plan

Bots fire their plan first, then the world runs this many physics ticks (flood, sag, growth) before they think again. Default 1. Range 1–32.

City goal

Standing objective in every bot’s observation.goal. Default is grow a working city. Clear the box for no goal. Max 400 characters. Saved in this tab.

Bots

Default 10. Needs an API key. 10k bots = 10k isolated LLM turns (parallel cap is in Settings). Empty key or failed fetch: bots WAIT. Invalid JSON = WAIT. Optional CORS: VITE_LLM_PROXY and proxy.mjs.

Over 100 bots may be slow and expensive. Physics ticks and per-bot LLM calls can hitch; you still pay per bot.

World

World size

Default 48×48. Range 16–256 each.

Maps larger than 96×96 may be slow.

Describe a world…