Easy Kit

คำสั่งเดียว สร้างเกมที่เล่นได้จริงจากเครื่องมือ Easy ทั้ง 12 ตัว: เดินในหมู่บ้าน คุยกับ NPC ทำเควสต์ ซื้อของ ดูคัตซีน มีเพลง เอฟเฟกต์ เซฟเกม และสลับภาษา ไทย · English · Melayu
easykit new VillageDemo --template village_delivery drives Easy Sprite, Scene, Tilemap, Dialogue, Quest, UI, SFX, FX, Music, Anim, Items and Save through their own CLIs and MCP servers, then assembles the exports into a Godot 4.3+ project (with a passing headless test) and a PixiJS v8 web build of the same game. A unified MCP server proxies all 12 tools under namespaced names (sprite__export_character, save__check_all, …) next to the kit's own new_project, doctor and status. CLI, web dashboard, MCP over stdio and HTTP; local only.

Quick start

# the 12 Easy repos side by side (or set EASY<TOOL>_HOME / easykit.config.json), each with npm ci && npm run build
npm ci && npm run build
node dist/cli.js doctor                      # which tools are installed, versions, Godot / Chrome / xvfb
node dist/cli.js new VillageDemo --template village_delivery --seed 7 --dir ~/games
node dist/cli.js check ~/games/VillageDemo --shots ~/games/shots --frames
godot --path ~/games/VillageDemo/godot       # or serve ~/games/VillageDemo/web

About 30 s on a laptop. --engine godot|pixi|both (default both), --seed N varies the player's shirt colour, the coin sound, the coin-burst particles and the village theme, --force replaces an existing folder.

Related MCP server: McpHub

What easykit new does

Each tool works in <project>/.easy/<tool> with EASY<TOOL>_WORKSPACE and EASY<TOOL>_ALLOWED_DIRS set to the project, so the sibling repos are never written to. Sprite sheets and every other generated asset stay in the project; nothing generated is committed to this repo.

The village_delivery game

ต้นส่งของรอบหมู่บ้าน · Ton's village deliveries · Penghantaran Ton di kampung. A top-down multicultural southern Thai village (Buddhist temple, wooden kampung mosque, market, paddy, river) at 480×270:

• Walk: arrows / WASD; the camera follows Ton, buildings and NPCs collide.

• Talk: E or Enter near an NPC. Auntie Daeng (market) gives the job; Luang Phi (temple), Lung Mee (farm) and Grandpa Phoem (elder) each play their own dialogue segment; others answer with short barks in the current language.

• Quest: step and completion toasts with Easy FX, quest panel in the Easy UI HUD, coins into the Easy Items wallet.

• Shop: Bang Roti's halal stall (Easy Items raya_bazaar), its own Easy Music theme.

• Cutscene: intro from Easy Anim (Esc skips), with dialogue lines and music cues.

• Save: F5 quick save / F9 quick load (Easy Save slots with checksum + .bak), autosave every 2 minutes (Easy Save rotation); F9 on the title continues.

• Languages: L cycles th → en → ms for the HUD, prompts, barks and dialogue (Easy Save translations / Godot TranslationServer).

The Godot test (kit/test_game.gd, 52 checks) and the web check (scripts/check-web.py, 21 checks in headless Chrome) play the whole quest, the shop, save/load and the language switch.

Project layout

VillageDemo/
  easykit.project.json   manifest: seed, tool versions + commits, every step's outputs and notes
  README.md              how to run it and what each tool made
  assets/                generated character sheets (never shipped by Easy Kit)
  .easy/<tool>/          each tool's workspace: edit with the tool, then `easykit build VillageDemo`
  godot/                 Godot 4.3+ project (open project.godot)
  web/                   PixiJS v8 build (index.html, pixi.min.js bundled)

CLI

python3 scripts/make-gif.py SHOTS/godot out.gif turns --frames output into a GIF.

MCP

easykit mcp (stdio) or easykit mcp --http (http://127.0.0.1:8909/mcp) exposes the kit tools new_project, build_project, check_project, doctor, status, list_tools and proxies every installed tool as <tool>__<name>: 88 tool calls across the 12 servers (94 with the kit's own). Sibling servers start lazily on first use. EASYKIT_MCP_TOOLS=save,fx limits the proxy, none turns it off. See docs/MCP.md.

{ "mcpServers": { "easykit": { "command": "node", "args": ["/path/to/easykit/dist/cli.js", "mcp", "--workspace", "/path/to/games"] } } }

Configuration

Tool lookup, first match wins: EASY<TOOL>_HOME (e.g. EASYSAVE_HOME) → tools.<id> in easykit.config.json ($EASYKIT_CONFIG, ./easykit.config.json, then the kit folder) → <suiteDir>/easy<id> (default: the folder holding Easy Kit; Easy Sprite also tries easysprite-work). A folder only counts if its package.json name matches. Copy easykit.config.example.json. Godot: EASYKIT_GODOT, GODOT, godot in the config, or godot on PATH; Chrome: chrome in the config or the usual install paths.

Ports (unique across the suite): dashboard 8908, MCP HTTP 8909, Vite 5187, web check server 8989. Non-loopback hosts need the token printed at start (EASYKIT_TOKEN to set one).

Development

npm ci
npm run typecheck && npm run build && npm test   # 31 tests; 3 integration tests skip without the sibling repos
npm run smoke                                    # MCP (stdio + HTTP) and CLI smoke; `new` only when doctor is 12/12
npm run dev                                      # API on 8908 + `npx vite --config web/vite.config.ts` on 5187

CI has no sibling repos: integration tests, the proxied-MCP test and easykit new in the smoke test skip themselves (doctor reports 0/12). Locally with the whole suite they run the full pipeline. EASYKIT_SKIP_INTEGRATION=1 forces the skip.

Limitations

• One template so far (village_delivery); it reuses the Easy Tilemap sample map and the Easy Dialogue / Quest / Anim samples, re-cast with generated characters, rather than generating a new map or story.

• The intro cutscene's lines exist in Thai and English only (Easy Anim sample); Malay falls back to English there.

• Two files are exported by more than one tool (background.png, dialogue/village_delivery.dialogue.json); the first writer wins and the build lists the collisions.

• Refusing Auntie Daeng keeps the quest available (the kit never emits the quest's fail event).

• The Easy Items shop UI is laid out for 640×360 and is scaled to 75 % in the 480×270 game.

Easy Suite

Thirteen small, local-first tools that share one look (teak, lantern gold, Kanit, 16/48px pixels), one workflow (CLI · web editor · MCP server) and the same targets (Godot 4.3+ and PixiJS v8). ชุดเครื่องมือทำเกมพิกเซลสไตล์ไทย ใช้ร่วมกันได้ทั้งชุด · Easy Kit builds a whole playable game from the other twelve.
The samples share one multicultural southern Thai village: Buddhist temple, wooden kampung mosque and Chinese-Thai shrine on the same street. หมู่บ้านพหุวัฒนธรรม วัด มัสยิด ศาลเจ้า อยู่ร่วมกันในเมืองเดียว

Works with

All twelve: Easy Kit runs each tool's own CLI (Easy Sprite through its MCP server), so a tool upgrade reaches new projects without kit changes. easykit doctor shows which commit of each tool built a project, and the manifest records it.

Credits

Code: MIT. The template's kit strings and glue are written for this repo (CC0 1.0). Everything a generated game contains comes from the Easy tools under their own terms (samples CC0, Kanit SIL OFL 1.1); PixiJS v8 (MIT) is copied into web builds. See CREDITS.md.