voidless-mcp 1.6.15 → 1.6.16

package/README.md

@@ -113,6 +113,7 @@ Or just the hosted connector, no key: `claude mcp add --transport http voidless
 | `generate_sfx` / `generate_music` | Sound effect, or a music track with length, tempo and key |
 | `generate_video` / `extend_video` | Short clip from a prompt and reference images, or continue one |
 | `generate_3d_model` / `rig_3d_model` / `animate_3d_model` | 3D model, rig it, animate it |
+| `render_3d_sprites` | A 3D model's move (or the model standing) as 2D sprites: 8, 4, platformer, isometric or front views, 16 frames, 32-512 px; free |
 
 Generation tools create new content in your library; none deletes or overwrites existing assets. Each tool's description lists its credit cost.
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "voidless-mcp",
   "mcpName": "dev.voidless/voidless",
-  "version": "1.6.15",
+  "version": "1.6.16",
   "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

@@ -49,6 +49,7 @@ const GALLERY_TOOLS = [
   "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",
+  "render_3d_sprites",
 ];
 const GALLERY_HTML = readFileSync(new URL("./gallery.html", import.meta.url), "utf8");
 
@@ -61,6 +62,7 @@ const LONG_PATHS = new Set([
   "/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",
+  "/generate/model-sprites",
 ]);
 const WAIT_MS = Number(process.env.VOIDLESS_WAIT_MS) || 80_000;
 const CUT_OFF = /\((502|504|520|522|524)\)|fetch failed|ECONNRESET|socket|terminated|other side closed/i;
@@ -1237,6 +1239,50 @@ export function createVoidlessServer(API_KEY) {
     })
   );
 
+  server.tool(
+    "render_3d_sprites",
+    "Render a 3D model as 2D game sprites: one of its moves (from animate_3d_model) or the model standing, " +
+      "seen from 8 directions, 4, the two sides of a platformer, 4 isometric diagonals, or the front. 16 frames " +
+      "by default, at 32-512 px (pixel art up to 128, from the same pass as generated sprites; smooth above). Saved as an " +
+      "animated sprite asset linked to the model, one animation per direction, ready to export as a sheet or " +
+      "edit. Every render of the same model goes onto that one asset. Free.",
+    {
+      id: z.number().int().describe("3D model asset ID"),
+      animation: z
+        .string()
+        .optional()
+        .describe("The move to render: its name ('walk'), preset or animation id. Empty = the model standing"),
+      directions: z
+        .enum(["eight", "four", "platformer", "isometric", "front"])
+        .default("eight")
+        .describe("Which views: 8 around, 4 (down/right/up/left), platformer (right, left, side-on), isometric diagonals, or the front"),
+      size: z
+        .union([z.literal(32), z.literal(64), z.literal(128), z.literal(256), z.literal(512)])
+        .default(128)
+        .describe("Sprite size in pixels: 32-128 come out as pixel art, 256 and 512 as smooth renders"),
+      frames: z.number().int().min(2).max(32).default(16).describe("Frames per direction (default 16)"),
+    },
+    writeTool("Render 3D sprites"),
+    tool(async (args) => {
+      const data = await apiPost("/generate/model-sprites", args);
+      const asset = await apiGet(`/assets/${data.assetId}`).catch(() => null);
+      const name = String(data.animation?.name || "still").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 40);
+      const made = ((asset?.meta_data?.frames) || [])
+        .filter((f) => f && f.type === "animation" && String(f.name || "").startsWith(`${name}-`))
+        .slice(-(data.directions || []).length || undefined);
+      const head = [
+        `${data.animation ? `"${data.animation.name}"` : "The model standing"} rendered from 3D: ` +
+          `${(data.directions || []).length} direction${(data.directions || []).length === 1 ? "" : "s"} ` +
+          `(${(data.directions || []).join(", ")}), ${data.frameCount} frame${data.frameCount === 1 ? "" : "s"} each at ${data.size} px, ${data.fps} fps.`,
+        `${data.added ? "Added to" : "Saved as"} sprite asset ${data.assetId} (${APP_URL}/asset/${data.assetId}), linked to model ${args.id}.`,
+        money(data),
+      ].filter(Boolean).join("\n");
+      const content = [{ type: "text", text: head }];
+      if (made.length) content.push(...(await frameContent(made)));
+      return withGallery({ content }, made.flatMap((f) => frameItems(f, data.assetId)), "3D sprites");
+    })
+  );
+
   // The inline gallery, and the tools whose results it shows.
   server.registerResource(
     "gallery",