gitmyhub

capybara_2d_engine

TypeScript ★ 180 updated 4d ago

A TypeScript 2.5D game engine designed for AI coding agents, with a single-file public interface and optional AI-generated art via the Capybara MCP.

TypeScriptNode.jsnpmsetup: easycomplexity 2/5

Capybara 2.5D Engine is a game engine built with TypeScript, designed so that AI coding assistants can build games with it more easily than with a typical engine. The whole public interface of the engine sits in one file, so an AI agent working on a game only has to understand that single file rather than dig through a large codebase to figure out how things connect.

The engine is meant to run on its own: you can install it, write your own gameplay code, and ship a finished game without signing up for anything extra. For teams that want AI-generated art and content, such as maps, characters, props, audio, and interface widgets, the project offers an optional add-on called the Capybara MCP. Coding agents cannot create images or audio themselves, so this connects to an outside service that generates those assets on request, using an API key from the project's own website.

The engine also ships with a small built-in SDK meant to take care of common backend needs like player accounts, saving progress to the cloud, and multiplayer, so a developer does not have to build that plumbing from scratch.

Getting started is straightforward: install the dependencies with npm install and start the local development server with npm run dev. The README also includes a tip for troubleshooting: if generated artwork looks wrong in the game, check the original file in the src/data folder before asking for it to be regenerated, since AI agents sometimes place art with the wrong aspect ratio.

This tool would suit someone building a 2D or 2.5D game with the help of an AI coding assistant, especially if they want to lean on generated art rather than draw everything by hand. A developer comfortable with basic command line steps and TypeScript would have the easiest time here.

Where it fits