From efe7a88e1084f0168e2bd9286d40b4e04a340976 Mon Sep 17 00:00:00 2001
From: CodeForge Bot <codeforge@noreply>
Date: Mon, 23 Mar 2026 13:52:34 +0000
Subject: [PATCH] =?UTF-8?q?feat(codeforge):=20CodeForge:=20Uprav=20mi=20re?=
 =?UTF-8?q?adme=20pros=C3=ADm=20moc=20d=C4=9Bkuji?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Task ID: e717cfbd-06ae-44b6-9585-31de39229afa
Co-authored-by: CodeForge Bot <codeforge@noreply>
---
 .mcp.json | 11 -----------
 README.md | 42 +++++++++++++++++++++++++++++++++++++-----
 2 files changed, 37 insertions(+), 16 deletions(-)
 delete mode 100644 .mcp.json

diff --git a/.mcp.json b/.mcp.json
deleted file mode 100644
index b6161b9..0000000
--- a/.mcp.json
+++ /dev/null
@@ -1,11 +0,0 @@
-{
-  "mcpServers": {
-    "pixelforge": {
-      "command": "npx",
-      "args": ["-y", "pixelforge-mcp@latest"],
-      "env": {
-        "GEMINI_API_KEY": ""
-      }
-    }
-  }
-}
diff --git a/README.md b/README.md
index dec3a0f..81e7303 100644
--- a/README.md
+++ b/README.md
@@ -4,9 +4,11 @@ MCP server that forges pixel art sprites & game assets using Google Gemini — g
 
 ## Features
 
-- **AI-powered generation** — sprites, animations, backgrounds, thumbnails via Google Gemini
+- **AI-powered generation** — sprites, animations, backgrounds, thumbnails, tilesets, item kits via Google Gemini
 - **Smart post-processing** — background removal, auto-crop, pixelation downscale, square padding
 - **Sprite sheet splitting** — auto-detect and split sheets into individual frames
+- **Seamless tiling** — generate tileable textures for terrain and backgrounds
+- **Batch generation** — create multiple related sprites with visual consistency
 - **Style presets** — neon, retro, gameboy, snes, clean
 - **Pure PNG pipeline** — zero-dependency PNG encoder/decoder, no native modules
 - **Reference matching** — pass existing sprites to match visual style
@@ -70,6 +72,16 @@ Add to your `.mcp.json` or equivalent config:
 - Node.js >= 20
 - [Google Gemini API key](https://aistudio.google.com/apikey)
 
+## Quick Examples
+
+```
+"Generate a green slime enemy sprite, 48px, retro style"
+"Create a bouncing ball animation with 4 frames"
+"Make a grass tileset texture, 32px"
+"Generate fruit item kit: apple, banana, cherry"
+"Create space background with stars, 16:9 aspect ratio"
+```
+
 ## Tools
 
 ### `forge_sprite`
@@ -127,6 +139,28 @@ Post-process an existing PNG — background removal, auto-crop, sprite sheet spl
 **Required:** `inputPath`
 **Optional:** `outputPath`, `split`, `names`, `threshold`, `square`, `padding`, `skipCrop`, `skipTransparent`
 
+### `forge_tileset`
+
+Generate a seamless tileable pixel art texture. Perfect for terrain, floors, walls, and backgrounds.
+
+```
+"Generate grass terrain tileset, 32px"
+```
+
+**Required:** `description`, `outputPath`
+**Optional:** `size` (default: 32), `style`, `model`
+
+### `forge_item_kit`
+
+Generate multiple related sprites in a single batch for visual consistency. Ideal for item sets, collectibles, or inventory icons.
+
+```
+"Generate fruit items: apple, banana, cherry, grapes"
+```
+
+**Required:** `items`, `outputPrefix`
+**Optional:** `names`, `size` (default: 48), `style`, `background`, `square`, `model`, `references`
+
 ### `optimize_sprite`
 
 Downscale oversized AI images to true pixel art resolution using area-averaging (not blurry bilinear).
@@ -138,16 +172,14 @@ Downscale oversized AI images to true pixel art resolution using area-averaging
 **Required:** `inputPath`, `size`
 **Optional:** `outputPath`, `removeBackground`, `square`
 
-> Full parameter docs: see [docs/tools.md](docs/tools.md)
-
 ## Models
 
 | Alias | Model ID | Notes |
 |-------|----------|-------|
 | `nano-banana`, `banana` | nano-banana-pro-preview | **Default** — best for pixel art |
-| `flash`, `gemini-flash` | gemini-3.1-flash-image-preview | Fast, reliable |
+| `flash`, `gemini-flash`, `banana-2`, `nano-banana-2` | gemini-3.1-flash-image-preview | Fast, reliable |
 | `pro`, `gemini-pro` | gemini-3-pro-image-preview | Best quality |
-| `25`, `gemini-25` | gemini-2.5-flash-image | Stable fallback |
+| `25`, `gemini-25`, `gemini-flash-25` | gemini-2.5-flash-image | Stable fallback |
 
 ## Prompts