--- title: "Settlement" url: "https://aigamehub.app/en/games/settlement-village-dcef88" source: "https://github.com/Lingikaushikreddy/Settlement-Village" source_type: "github" play_url: "https://settlement-village.vercel.app" platform: "desktop" login_required: false pricing: "free" origin: "original" ai_tools: ["Claude"] game_languages: ["en"] author: "Lingikaushikreddy" author_handle: "Lingikaushikreddy" category: "Action" categories: ["action", "simulation"] tags: ["browser-game", "isometric", "multi-agent", "open-source", "strategy", "village-builder"] added: "2026-10-19T13:22:16.619Z" updated: "2026-10-19T13:22:16.619Z" locale: "en" content_locale: "en" --- # Settlement An illustrated multi-agent village strategy game. Set objectives; residents gather, build, upgrade and recruit. Battle, inspect decisions and test AI agents. No API key required. ## Description Give six residents a shared goal — grow the village, prepare for a raid, or restock supplies — and watch them claim jobs, gather resources, build and upgrade a farm, or coordinate recruitment. You can inspect what each resident is doing, why it took the job and what it remembers, then command your army in battle or open the research desk to study social decisions. The campaign and research tools run in the browser with no API key, account or database; campaign residents use deterministic game AI, with optional Claude decisions available for local-worker research experiments. Licensed MIT; playable online or run locally with npm. ## Original post An illustrated multi-agent village strategy game. Set objectives; residents gather, build, upgrade and recruit. Battle, inspect decisions and test AI agents. No API key required. Topics: agent-based-modeling, autonomous-agents, browser-game, city-builder, claude, deterministic-simulation, explainable-ai, game-ai, isometric, multi-agent-systems, nextjs, pathfinding, react, simulation, single-player, sqlite, strategy-game, typescript, vite
# Settlement ### Set the objective. Let the village figure out the work. A multi-agent village strategy game and an inspectable AI simulation lab. [![CI](https://github.com/Lingikaushikreddy/Settlement-Village/actions/workflows/ci.yml/badge.svg)](https://github.com/Lingikaushikreddy/Settlement-Village/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/License-MIT-d9bd75.svg)](LICENSE) [![TypeScript](https://img.shields.io/badge/TypeScript-5.9-3178c6.svg)](https://www.typescriptlang.org/) [![npm](https://img.shields.io/npm/v/settlement-testbed.svg)](https://www.npmjs.com/package/settlement-testbed) [![No API key required](https://img.shields.io/badge/Play_without_an_API_key-38664a.svg)](#run-locally) [![Play in your browser: no signup, no API key](https://img.shields.io/badge/%E2%96%B6_Play_in_your_browser-no_signup,_no_API_key-38664a?style=for-the-badge)](https://settlement-village.vercel.app) [Play online](https://settlement-village.vercel.app) · [Quick start](#run-locally) · [How agents work](#how-the-agents-work) · [Player guide](docs/player-guide.md) · [Contribute](CONTRIBUTING.md) · [Discuss](https://github.com/Lingikaushikreddy/Settlement-Village/discussions) [![Settlement in 15 seconds: give the village an objective, watch residents claim jobs and gather, then read the log of why each resident took its job](docs/media/settlement-demo.gif)](https://settlement-village.vercel.app) Real recording of the live site: one click on Grow the village, then the decision log. Click to play.
**Give six residents a shared goal: grow the village, prepare for a raid, or restock supplies. Watch them claim jobs, gather resources, build and upgrade a new farm, or coordinate recruitment.** Inspect what each resident is doing, why they took the job, and what they remember. Then command your army in battle, or open the research desk to investigate social decisions and replay their evidence. The campaign and free research tools run in your browser with **no API key, paid AI, account, or database required**, whether you open the hosted frontend or run it locally. Campaign residents use deterministic game AI. Optional Claude decisions are available for explicit steps in local-worker research experiments. | You want to… | Start here | | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | | **Play** | Open [settlement-village.vercel.app](https://settlement-village.vercel.app). Saves stay in your browser. | | **Test your own agent** | `npx settlement-testbed --agent http://127.0.0.1:8765/decide --name my-agent`, then see [Test your own agent](#test-your-own-agent). | | **Run or change it locally** | `git clone`, `npm ci`, `npm run dev`. See [Run locally](#run-locally). | If you like games where agent decisions are visible, **star the repository** to follow Settlement's development. ## Try t