voidless-mcp 1.6.14 → 1.6.15

package/README.md

@@ -89,6 +89,8 @@ Or just the hosted connector, no key: `claude mcp add --transport http voidless
 | --- | --- |
 | `generate_image` | Sprite, character, portrait, prop, tileset, UI piece or artwork in a chosen model, style, palette, size and perspective; artwork can be 16:9 for backdrops |
 | `edit_image` | Change an image with an instruction; the edit is added as a new frame |
+| `make_normal_map` | A normal map for an image, an edit or every frame of an animation, for 2D lights in a game engine; free |
+| `make_glow_map` | The light an edit added (lit windows, a night version's lamps) on its own, for an additive glow layer; free |
 | `rotate_sprite` | An 8-way set (front, back, sides, diagonals) in one pass |
 | `extract_parts` | Split a character into body parts for rigging |
 | `upload_image` | Add an image you already have to your library |

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "voidless-mcp",
   "mcpName": "dev.voidless/voidless",
-  "version": "1.6.14",
+  "version": "1.6.15",
   "description": "MCP server for Voidless: generate game sprites, animations, sound, music, video and 3D models",
   "license": "MIT",
   "author": "Voidless Dev Inc. <contact@voidless.dev>",

package/tools.js

@@ -27,7 +27,7 @@ import { Agent, setGlobalDispatcher } from "undici";
 // server does.
 setGlobalDispatcher(new Agent({ headersTimeout: 0, bodyTimeout: 0, connectTimeout: 30_000 }));
 
-export const VERSION = "1.6.14";
+export const VERSION = "1.6.15";
 const BASE_URL = process.env.VOIDLESS_API_URL || "https://api.voidless.dev";
 const CDN_URL = "https://cdn.voidless.dev";
 // Where asset links point. Results link to the asset's page in the app rather than to raw GIFs: the
@@ -46,7 +46,7 @@ const MAX_INLINE_IMAGES = 8;
 const GALLERY_URI = "ui://voidless/gallery.html";
 const GALLERY_MIME = "text/html;profile=mcp-app";
 const GALLERY_TOOLS = [
-  "generate_image", "upload_image", "edit_image", "rotate_sprite", "animate_sprite", "generate_animation_set",
+  "generate_image", "upload_image", "edit_image", "make_normal_map", "make_glow_map", "rotate_sprite", "animate_sprite", "generate_animation_set",
   "flip_left_side", "generate_video", "generate_sfx", "generate_music", "generate_3d_model", "get_asset",
   "list_assets", "extract_parts", "pixelate_image", "extend_video", "clean_up_sprite", "check_generation",
 ];
@@ -58,7 +58,7 @@ const GALLERY_HTML = readFileSync(new URL("./gallery.html", import.meta.url), "u
 // job is still going the tool says so and check_generation fetches the result later (Strapi keeps
 // it under the key: GET /generate/job/:key).
 const LONG_PATHS = new Set([
-  "/generate/image", "/generate/image-edit", "/generate/image-rotations", "/generate/image-parts",
+  "/generate/image", "/generate/image-edit", "/generate/bbox-edit", "/generate/image-rotations", "/generate/image-parts",
   "/generate/image-animation", "/generate/multi-animation", "/generate/video", "/generate/video-extend",
   "/generate/sfx", "/generate/music", "/generate/3d-model", "/generate/model-rig", "/generate/model-animation",
 ]);
@@ -841,6 +841,65 @@ export function createVoidlessServer(API_KEY) {
     tool(async (args) => framesResult(await apiPost("/generate/image-edit", { ...args, model: "p-image" }), args.id, "Edit"))
   );
 
+  server.tool(
+    "make_normal_map",
+    "Make a normal map for an image asset, for 2D lights in a game engine: which way each pixel faces, so a " +
+      "moving light shades it. The shape comes from a depth model, the drawn detail from the picture. PNG at the " +
+      "picture's own size, OpenGL style (green = up: Godot and Unity read it as is; flip green for Unreal). " +
+      "Pass frameId (from get_asset) for an edit, or an animation (one map per frame); leave it out for the " +
+      "image itself. Free.",
+    {
+      id: assetId,
+      frameId: z
+        .number()
+        .int()
+        .optional()
+        .describe("Optional: the frame (an edit or an animation, from get_asset) to make it for. Empty = the image itself."),
+    },
+    writeTool("Make normal map"),
+    tool(async ({ id, frameId: fid }) => {
+      const data = await apiPost("/generate/normal-map", { id, ...(fid === undefined ? {} : { frameId: fid }) });
+      const keys = data.maps?.normals || (data.maps?.normal ? [data.maps.normal] : []);
+      const content = [
+        {
+          type: "text",
+          text:
+            `Normal map${keys.length > 1 ? `s (${keys.length}, one per frame)` : ""} saved on asset ${id} ` +
+            `(${APP_URL}/asset/${id}):\n` + keys.map((k) => `${CDN_URL}/${k}`).join("\n"),
+        },
+      ];
+      const image = keys.length ? await inlineImage(keys[0]) : null;
+      if (image) content.push(image);
+      return { content, structuredContent: { summary: content[0].text } };
+    })
+  );
+
+  server.tool(
+    "make_glow_map",
+    "Make a glow map from an edit that switched lights on (or made a night version with lights glowing): the " +
+      "light the edit added over the picture it came from, on transparency, for an additive or emissive layer in " +
+      "a game. Same size as the picture. Pass the edit's frameId (from get_asset). Free.",
+    {
+      id: assetId,
+      frameId: z.number().int().describe("The edit (a frame from get_asset) whose light to keep"),
+    },
+    writeTool("Make glow map"),
+    tool(async ({ id, frameId: fid }) => {
+      const data = await apiPost("/generate/glow-map", { id, frameId: fid });
+      const keys = data.maps?.glows || (data.maps?.glow ? [data.maps.glow] : []);
+      const content = [
+        {
+          type: "text",
+          text: `Glow map${keys.length > 1 ? `s (${keys.length})` : ""} saved on asset ${id} (${APP_URL}/asset/${id}):\n` +
+            keys.map((k) => `${CDN_URL}/${k}`).join("\n"),
+        },
+      ];
+      const image = keys.length ? await inlineImage(keys[0]) : null;
+      if (image) content.push(image);
+      return { content, structuredContent: { summary: content[0].text } };
+    })
+  );
+
   server.tool(
     "rotate_sprite",
     "Turn a sprite into an 8-way set (front, back, sides and diagonals) in one pass. The result is a " +
@@ -1141,11 +1200,10 @@ export function createVoidlessServer(API_KEY) {
 
   server.tool(
     "rig_3d_model",
-    "Add a skeleton to a humanoid 3D model so it can be animated (non-humanoids are refused before any " +
-      "charge). Run before animate_3d_model. 140 credits.",
+    "Add a skeleton to a 3D model so it can be animated: a humanoid, a four-legged animal, or a prop's " +
+      "moving parts (a chest lid, a door, a tree's trunk). Run before animate_3d_model. 30 credits.",
     {
       id: z.number().int().describe("3D model asset ID"),
-      height_meters: z.number().min(0.2).max(10).default(1.7).describe("Character height in metres"),
     },
     writeTool("Rig 3D model"),
     tool(async (args) => {
@@ -1156,11 +1214,18 @@ export function createVoidlessServer(API_KEY) {
 
   server.tool(
     "animate_3d_model",
-    "Animate a rigged 3D model from a description of the motion. 30 credits.",
+    "Animate a rigged 3D model. Either a ready-made move (free; characters: idle, walk, run, jump, attack, " +
+      "punch, kick, wave, hurt, death, cast, dance; four-legged animals: idle, walk, run, jump, attack, sit, hurt, " +
+      "death), a move copied from another of the user's rigged models (free: from_id + from_animation), or a " +
+      "description of any motion ('wag its tail', 'open the lid', 20 credits). Returns the clip, a GLB of the " +
+      "skeleton's motion that plays on the rigged model.",
     {
       id: z.number().int().describe("Rigged 3D model asset ID"),
-      prompt: z.string().describe("The motion, e.g. 'walk cycle', 'idle breathing'"),
-      duration: z.number().min(1).max(10).default(3).describe("Seconds"),
+      preset: z.string().optional().describe("Ready-made move id, e.g. 'walk' (free)"),
+      from_id: z.number().int().optional().describe("Copy a move from this other rigged model (free)"),
+      from_animation: z.number().int().optional().describe("The animation id on from_id to copy"),
+      prompt: z.string().optional().describe("Or describe the motion, e.g. 'a spinning kick' (20 credits)"),
+      duration: z.number().min(1).max(10).optional().describe("Seconds, for a described motion (default: its natural length)"),
     },
     writeTool("Animate 3D model"),
     tool(async (args) => {