summer-engine 2.0.0 → 2.3.0

package/dist/lib/skills-registry.js

@@ -4,9 +4,16 @@ export const AGENT_CLIENTS = [
     "claude-code",
     "cursor",
     "windsurf",
+    "cline",
+    "roo-code",
+    "gemini",
+    "opencode",
 ];
 export const SKILL_CATEGORIES = [
     "_meta",
+    "2d-assets",
+    "3d-assets",
+    "video",
     "character-controllers",
     "gameplay-mechanics",
     "scripting-patterns",
@@ -274,7 +281,7 @@ export const SKILL_REGISTRY = [
         testScenario: "Define audio direction (music + SFX vocabulary + dynamic plan) for a cozy farming sim; write .summer/audio-bible.md and configure the audio bus layout.",
     },
     {
-        name: "vfx",
+        name: "game-feel",
         category: "visual-effects",
         public: true,
         clients: ALL_CLIENTS,
@@ -402,4 +409,499 @@ export const SKILL_REGISTRY = [
         ],
         testScenario: "Run the Steam pre-flight checklist (Windows + Mac + Linux), validate icons/banners/screenshots/build config, and produce a release build only when green.",
     },
+    {
+        name: "concept-art",
+        category: "2d-assets",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: true,
+        requiresMcpTools: [
+            "summer_generate_image",
+            "summer_search_assets",
+            "summer_import_from_url",
+        ],
+        testScenario: "User asks for 'concept art for the protagonist' — skill produces 3-4 variant prompts on a locked style anchor and writes prompts to art/concept/_prompts.md as fallback when MCP unavailable.",
+    },
+    {
+        name: "character-portrait",
+        category: "2d-assets",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: true,
+        requiresMcpTools: [
+            "summer_generate_image",
+            "summer_search_assets",
+            "summer_import_from_url",
+        ],
+        testScenario: "User asks for a 'final portrait of the queen for dialogue UI' — skill locks composition, generates one polished bust against a locked anchor, imports as res://art/portraits/queen.png.",
+    },
+    {
+        name: "pixel-art",
+        category: "2d-assets",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: true,
+        requiresMcpTools: [
+            "summer_generate_image",
+            "summer_search_assets",
+            "summer_import_from_url",
+        ],
+        testScenario: "User requests a '64x64 pixel art heart icon' — skill generates with style: 'pixel', enforces nearest-neighbor texture filter project setting, imports to res://art/sprites/.",
+    },
+    {
+        name: "ui-graphics",
+        category: "2d-assets",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: false,
+        requiresMcpTools: [
+            "summer_generate_image",
+            "summer_import_from_url",
+            "summer_add_node",
+            "summer_set_prop",
+        ],
+        testScenario: "User asks for an inventory grid icon set — skill generates flat-design transparent PNGs, sets up AtlasTexture import, wires into TextureRect / NinePatchRect.",
+    },
+    {
+        name: "tileable-texture",
+        category: "2d-assets",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: false,
+        requiresMcpTools: [
+            "summer_generate_image",
+            "summer_import_from_url",
+            "summer_set_resource_property",
+        ],
+        testScenario: "User asks for a 'seamless brick wall texture' — skill generates with seamless prompt suffix, applies to PlaneMesh + StandardMaterial3D with uv1_scale tiled.",
+    },
+    {
+        name: "sprite-sheet",
+        category: "2d-assets",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: false,
+        requiresMcpTools: [
+            "summer_generate_image",
+            "summer_import_from_url",
+            "summer_set_resource_property",
+            "summer_add_node",
+            "summer_set_prop",
+        ],
+        testScenario: "User requests a '4-frame walk cycle for the goblin' — skill generates per-frame at locked anchor, builds SpriteFrames resource, wires AnimatedSprite2D.",
+    },
+    {
+        name: "skybox-panorama",
+        category: "2d-assets",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: false,
+        requiresMcpTools: [
+            "summer_generate_image",
+            "summer_import_from_url",
+            "summer_set_resource_property",
+        ],
+        testScenario: "User asks for a 'sunset desert skybox' — skill generates equirectangular 2:1 panorama, wires PanoramaSkyMaterial on WorldEnvironment.",
+    },
+    {
+        name: "prop-model",
+        category: "3d-assets",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: true,
+        requiresMcpTools: [
+            "summer_generate_3d",
+            "summer_search_assets",
+            "summer_import_from_url",
+            "summer_add_node",
+            "summer_set_prop",
+        ],
+        testScenario: "User asks for 'a treasure chest' — skill calls summer_generate_3d via image-to-3d pipeline with white-background prompt suffix, imports as MeshInstance3D.",
+    },
+    {
+        name: "character-model",
+        category: "3d-assets",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: true,
+        requiresMcpTools: [
+            "summer_generate_image",
+            "summer_generate_3d",
+            "summer_generate_motion",
+            "summer_search_assets",
+            "summer_inspect_resource",
+            "summer_add_node",
+            "summer_set_prop",
+            "summer_save_scene",
+        ],
+        testScenario: "User asks for 'a knight character' — skill produces T-pose ref via image, gates rig pass on user approval, imports rigged glb, wires CharacterBody3D + Skeleton3D, hands off to animation/generate-motion.",
+    },
+    {
+        name: "environment-kit",
+        category: "3d-assets",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: false,
+        requiresMcpTools: [
+            "summer_generate_3d",
+            "summer_search_assets",
+            "summer_import_from_url",
+            "summer_add_node",
+            "summer_set_prop",
+            "summer_save_scene",
+        ],
+        testScenario: "User asks for 'a dungeon kit' — skill locks style anchor, generates 5-10 modular pieces with consistent prompt suffix, imports on snap-grid.",
+    },
+    {
+        name: "vehicle-model",
+        category: "3d-assets",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: false,
+        requiresMcpTools: [
+            "summer_generate_3d",
+            "summer_search_assets",
+            "summer_import_from_url",
+            "summer_add_node",
+            "summer_set_prop",
+        ],
+        testScenario: "User asks for 'a sci-fi hover bike' — skill provides multi-angle reference, generates with hard-surface model preference, recommends texture pass for panel detail.",
+    },
+    {
+        name: "organic-model",
+        category: "3d-assets",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: false,
+        requiresMcpTools: [
+            "summer_generate_3d",
+            "summer_search_assets",
+            "summer_import_from_url",
+            "summer_add_node",
+            "summer_set_prop",
+        ],
+        testScenario: "User asks for 'a glowing mushroom cluster' — skill generates organic shape via summer_generate_3d, imports with emission material, suggests MultiMeshInstance3D for forest fill.",
+    },
+    {
+        name: "generate-motion",
+        category: "animation",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: true,
+        requiresMcpTools: [
+            "summer_generate_motion",
+            "summer_check_job",
+            "summer_search_assets",
+            "summer_inspect_resource",
+            "summer_get_scene_tree",
+            "summer_add_node",
+            "summer_set_prop",
+            "summer_set_resource_property",
+            "summer_save_scene",
+        ],
+        testScenario: "User asks for 'a walk animation on the goblin' — skill verifies the rigged target, picks meshy-library backend for standard 'walk', wires the clip into AnimationPlayer.",
+    },
+    {
+        name: "retarget",
+        category: "animation",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: false,
+        requiresMcpTools: [
+            "summer_generate_motion",
+            "summer_search_assets",
+            "summer_inspect_resource",
+            "summer_set_resource_property",
+            "summer_save_scene",
+        ],
+        testScenario: "User asks to 'apply the goblin's walk to the orc' — skill identifies the source clip, retargets to the orc skeleton via SkeletonProfile, wires into the orc's AnimationPlayer.",
+    },
+    {
+        name: "animation-tree",
+        category: "animation",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: false,
+        requiresMcpTools: [
+            "summer_get_scene_tree",
+            "summer_inspect_node",
+            "summer_add_node",
+            "summer_set_prop",
+            "summer_set_resource_property",
+            "summer_save_scene",
+        ],
+        testScenario: "User has idle/walk/run clips — skill builds an AnimationTree with a BlendSpace1D driven by speed, wires the BlendTree to the player controller.",
+    },
+    {
+        name: "procedural-animation",
+        category: "animation",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: false,
+        requiresMcpTools: [
+            "summer_get_scene_tree",
+            "summer_inspect_node",
+            "summer_add_node",
+            "summer_set_prop",
+            "summer_save_scene",
+        ],
+        testScenario: "User asks for 'foot IK so the character doesn't sink into stairs' — skill adds SkeletonModification3DLookAt + raycasting on each foot, wires into the character's Skeleton3D.",
+    },
+    {
+        name: "facial-and-lipsync",
+        category: "animation",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: false,
+        requiresMcpTools: [
+            "summer_inspect_resource",
+            "summer_set_resource_property",
+            "summer_save_scene",
+            "summer_generate_audio",
+        ],
+        testScenario: "User has a voice line and wants the character to lip-sync to it — skill generates phoneme markers, builds blend-shape animation track on the character's MeshInstance3D.",
+    },
+    {
+        name: "sound-effect",
+        category: "audio",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: true,
+        requiresMcpTools: [
+            "summer_generate_audio",
+            "summer_search_assets",
+            "summer_import_from_url",
+            "summer_add_node",
+            "summer_set_prop",
+        ],
+        testScenario: "User asks for 'a sword swing sound' — skill reads audio bible, builds ElevenLabs SFX prompt with material+action+intensity, wires AudioStreamPlayer3D on the SFX bus.",
+    },
+    {
+        name: "music-track",
+        category: "audio",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: true,
+        requiresMcpTools: [
+            "summer_generate_audio",
+            "summer_search_assets",
+            "summer_import_from_url",
+            "summer_add_node",
+            "summer_set_prop",
+        ],
+        testScenario: "User asks for 'ambient forest theme music for level 1' — skill generates 60s loop via ElevenLabs music, imports with loop enabled, wires AudioStreamPlayer on Music bus.",
+    },
+    {
+        name: "ambient-bed",
+        category: "audio",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: false,
+        requiresMcpTools: [
+            "summer_generate_audio",
+            "summer_search_assets",
+            "summer_import_from_url",
+            "summer_add_node",
+            "summer_set_prop",
+        ],
+        testScenario: "User asks for 'rain on tin roof ambience' — skill generates loop-clean ambience, sets up positional or non-positional player on Ambient bus.",
+    },
+    {
+        name: "voice-line",
+        category: "audio",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: true,
+        requiresMcpTools: [
+            "summer_generate_audio",
+            "summer_search_assets",
+            "summer_import_from_url",
+            "summer_add_node",
+            "summer_set_prop",
+        ],
+        testScenario: "User asks for 'the king says: you have served me well' — skill picks a voice ID matching character traits, generates TTS, wires to character's mouth via AudioStreamPlayer3D.",
+    },
+    {
+        name: "adaptive-music",
+        category: "audio",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: false,
+        requiresMcpTools: [
+            "summer_generate_audio",
+            "summer_search_assets",
+            "summer_inspect_node",
+            "summer_add_node",
+            "summer_set_prop",
+            "summer_set_resource_property",
+        ],
+        testScenario: "User wants combat music that swells when enemies are nearby — skill generates layered stems (calm, tension, combat), wires AudioStreamPlaybackInteractive with combat-state listener.",
+    },
+    {
+        name: "cinematic-cutscene",
+        category: "video",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: true,
+        requiresMcpTools: [
+            "summer_generate_video",
+            "summer_generate_image",
+            "summer_generate_audio",
+            "summer_search_assets",
+            "summer_import_from_url",
+            "summer_add_node",
+            "summer_set_prop",
+        ],
+        testScenario: "User asks for 'an opening cutscene where the hero arrives at the castle' — skill builds reference image, generates 5-10s shot via image-to-video, wires VideoStreamPlayer in cutscene scene.",
+    },
+    {
+        name: "trailer-shot",
+        category: "video",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: false,
+        requiresMcpTools: [
+            "summer_generate_video",
+            "summer_generate_image",
+            "summer_search_assets",
+            "summer_import_from_url",
+        ],
+        testScenario: "User asks for 'a hero shot of the boss for the trailer' — skill picks kling for premium quality, generates 5s low-angle dramatic shot, exports to assets/trailer/.",
+    },
+    {
+        name: "animated-loop",
+        category: "video",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: false,
+        requiresMcpTools: [
+            "summer_generate_video",
+            "summer_search_assets",
+            "summer_import_from_url",
+            "summer_add_node",
+            "summer_set_prop",
+        ],
+        testScenario: "User asks for 'a looping fire backdrop for the title screen' — skill generates 3-5s loop-clean clip via ltx, wires VideoStreamPlayer with autoplay+loop in title scene.",
+    },
+    {
+        name: "fire",
+        category: "visual-effects",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: true,
+        requiresMcpTools: [
+            "summer_add_node",
+            "summer_set_prop",
+            "summer_set_resource_property",
+            "summer_inspect_node",
+            "summer_save_scene",
+        ],
+        testScenario: "User asks for 'a torch flame' — skill creates GPUParticles3D with custom shader, writes addons/vfx/fire/{fire.gdshader, fire_controller.gd}, wires to scene.",
+    },
+    {
+        name: "muzzle-flash",
+        category: "visual-effects",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: true,
+        requiresMcpTools: [
+            "summer_add_node",
+            "summer_set_prop",
+            "summer_set_resource_property",
+            "summer_inspect_node",
+            "summer_save_scene",
+        ],
+        testScenario: "User asks for 'a muzzle flash on the rifle' — skill creates one-shot GPUParticles3D with star-burst shader, wires restart() on weapon-fire signal.",
+    },
+    {
+        name: "water-ripple",
+        category: "visual-effects",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: false,
+        requiresMcpTools: [
+            "summer_add_node",
+            "summer_set_prop",
+            "summer_set_resource_property",
+            "summer_inspect_node",
+            "summer_save_scene",
+        ],
+        testScenario: "User wants 'water ripples when objects splash' — skill creates MeshInstance3D plane with custom water shader, exposes add_ripple(position) API.",
+    },
+    {
+        name: "lightning",
+        category: "visual-effects",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: false,
+        requiresMcpTools: [
+            "summer_add_node",
+            "summer_set_prop",
+            "summer_set_resource_property",
+            "summer_inspect_node",
+            "summer_save_scene",
+            "summer_connect_signal",
+        ],
+        testScenario: "User wants 'a lightning strike VFX' — skill builds ImmediateMesh-based jagged-segment renderer with shader, calls CameraShake.add_trauma(0.6) on cast.",
+    },
+    {
+        name: "dissolve",
+        category: "visual-effects",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: false,
+        requiresMcpTools: [
+            "summer_add_node",
+            "summer_set_prop",
+            "summer_set_resource_property",
+            "summer_inspect_node",
+            "summer_save_scene",
+        ],
+        testScenario: "User wants 'an enemy that dissolves on death' — skill writes dissolve.gdshader override + dissolve_object(target, duration) controller, animates threshold uniform.",
+    },
+    {
+        name: "smoke",
+        category: "visual-effects",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: false,
+        requiresMcpTools: [
+            "summer_add_node",
+            "summer_set_prop",
+            "summer_set_resource_property",
+            "summer_inspect_node",
+            "summer_save_scene",
+        ],
+        testScenario: "User wants 'smoke from a burning torch' — skill creates GPUParticles3D + smoke shader using shared FBM noise, wires wind direction parameter.",
+    },
+    {
+        name: "hit-spark",
+        category: "visual-effects",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: false,
+        requiresMcpTools: [
+            "summer_add_node",
+            "summer_set_prop",
+            "summer_set_resource_property",
+            "summer_inspect_node",
+            "summer_save_scene",
+        ],
+        testScenario: "User wants 'sparks when a sword hits metal' — skill spawns one-shot GPUParticles3D with additive billboard material, orients to surface normal.",
+    },
+    {
+        name: "magic-glow",
+        category: "visual-effects",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: false,
+        requiresMcpTools: [
+            "summer_add_node",
+            "summer_set_prop",
+            "summer_set_resource_property",
+            "summer_inspect_node",
+            "summer_save_scene",
+        ],
+        testScenario: "User wants 'a magical glow on a rune' — skill creates OmniLight3D with pulse-on-sin script + GPUParticles3D motes, uses additive billboard material from building blocks.",
+    },
 ];

package/dist/mcp/tools/generate-tools.js

@@ -273,6 +273,20 @@ Available kinds:
   - "image-to-3d" — From your own image. Requires 'imageUrl'.
   - "texture" — Generate textures for a model. Requires 'imageUrl'.
 
+Optional rig pass (image-to-3d only):
+  Set options.rig = true to add an auto-rig pass via Meshy v6. The result
+  job (poll via summer_check_job) will include rigAssetId — the asset ID
+  of the rigged glb. Use that rigAssetId with summer_generate_motion to
+  add animation clips. Adds ~$0.30 and ~60s to the job.
+
+Example:
+  summer_generate_3d({
+    kind: "image-to-3d",
+    imageUrl: "https://...",
+    options: { rig: true }
+  })
+  // Returns jobId; poll until result includes { assetId, rigAssetId }.
+
 By default, waits for completion (up to 5 min) and returns the result directly.
 Set wait=false to get the jobId immediately and poll manually with summer_check_job.
 
@@ -419,4 +433,91 @@ Requires authentication: run 'npx summer-engine login' first.`, {
             return errorResult(`Job status check failed: ${msg}`);
         }
     });
+    // ========================================================================
+    // summer_generate_motion
+    //
+    // NOTE (2026-05-10): only the "meshy-library" backend is exposed today.
+    // The "hunyuan-custom" path exists in the Studio route but has not been
+    // tested end-to-end on a user's rig (Hunyuan returns a generic skeleton
+    // FBX that isn't retargeted onto the caller's character). The schema and
+    // call are kept commented-out below — re-enable by restoring the wider
+    // zod enum, the prompt/durationSeconds params, the validation branch, and
+    // the relevant description lines once the path is verified.
+    // ========================================================================
+    server.tool("summer_generate_motion", `Generate an animation clip for a Meshy-rigged humanoid character via Summer Engine Studio.
+
+Backend:
+  - "meshy-library" — picks a clip from a curated mocap set by name (idle, walk,
+    run, attack_sword, jump, ~70 standard names). Fast (~30s), cheap (~$0.10),
+    real mocap quality.
+
+Requires a Meshy-rigged humanoid as the target. The 'rigAssetId' must come from
+a prior summer_generate_3d call with options.rig=true.
+
+By default, waits for completion (up to 5 min) and returns the result directly.
+Set wait=false to get the jobId immediately and poll manually with summer_check_job.
+
+Common motion names:
+  Locomotion: idle, idle_alert, idle_combat, walk, walk_back, run, sprint,
+              crouch_idle, crouch_walk, jump, jump_loop, jump_land
+  Combat: attack_sword, attack_punch, attack_kick, attack_bow, attack_cast,
+          block, dodge_left, dodge_right, hit_react, death
+  Social: wave, dance, sit_idle
+
+Cost: ~$0.10 per clip. Confirm with user before spending.
+
+Custom prompt-driven motion is on the roadmap; not yet shipped. For one-off
+signature moves not on the curated list, fall back to hand-authoring in the
+Godot editor or importing from Mixamo.
+
+Requires authentication: run 'npx summer-engine login' first.`, {
+        rigAssetId: z
+            .string()
+            .describe("Asset ID of a rigged character (from summer_generate_3d with options.rig=true)"),
+        backend: z
+            .enum(["meshy-library"])
+            .default("meshy-library")
+            .describe("Backend: meshy-library (only option today)"),
+        motionName: z
+            .string()
+            .describe("Curated motion name: walk, run, attack_sword, idle, jump, etc."),
+        // prompt + durationSeconds reserved for the hunyuan-custom backend (not
+        // shipped yet — see header comment).
+        wait: z
+            .boolean()
+            .default(true)
+            .describe("Wait for completion (default true, up to 5 min). Set false to get jobId immediately."),
+        options: z
+            .record(z.any())
+            .optional()
+            .describe("Backend-specific passthrough"),
+    }, async ({ rigAssetId, backend, motionName, wait, options }) => {
+        // Client-side validation
+        if (!motionName) {
+            return errorResult("motionName is required (e.g. 'walk', 'run', 'attack_sword'). See the tool description for the curated list.");
+        }
+        const body = {
+            rigAssetId,
+            backend,
+            motionName,
+            options,
+        };
+        const result = await mcpGenerate("/api/mcp/generate/motion", body);
+        if (result.error) {
+            return errorResult(result.error, result.data);
+        }
+        const jobId = result.data?.jobId;
+        if (!wait || !jobId) {
+            return successResult(result.data);
+        }
+        const pollResult = await pollJob(jobId);
+        if (pollResult.error) {
+            return errorResult(pollResult.error, { ...pollResult.data, jobId });
+        }
+        return successResult({
+            ...pollResult.data,
+            jobId,
+            message: "Motion generation complete. animationAssetId is in result.",
+        });
+    });
 }

package/gemini-extension.json

@@ -1,7 +1,7 @@
 {
   "name": "summer",
-  "version": "2.0.0",
-  "description": "Superpowers for AI game dev. MCP bridge to the local Summer Engine plus a context primer that teaches Gemini the 22 Summer skills. Use with the npm CLI for skill files on disk.",
+  "version": "2.0.1",
+  "description": "Superpowers for AI game dev. MCP bridge to the local Summer Engine plus a context primer that teaches Gemini the 24 Summer skills. Use with the npm CLI for skill files on disk.",
   "contextFileName": "GEMINI.md",
   "mcpServers": {
     "summer-engine": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "summer-engine",
-  "version": "2.0.0",
+  "version": "2.3.0",
   "description": "Summer — superpowers for AI game dev. CLI, skills, and MCP tools for Summer Engine.",
   "keywords": [
     "game-engine",
@@ -19,6 +19,7 @@
   "license": "MIT",
   "author": "Summer Engine <founders@summerengine.com>",
   "type": "module",
+  "main": ".opencode/plugins/summer.js",
   "bin": {
     "summer": "./dist/bin/summer.js"
   },
@@ -26,16 +27,21 @@
     "dist/",
     "skills/",
     "hooks/",
+    "assets/",
+    "_persona/",
     ".claude-plugin/",
     ".cursor-plugin/",
     ".codex-plugin/",
+    ".factory-plugin/",
     ".opencode/",
     "gemini-extension.json",
-    "marketplace.json",
     ".mcp.json",
     "README.md",
     "LICENSE",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "AGENTS.md",
+    "GEMINI.md",
+    "CLAUDE.md"
   ],
   "scripts": {
     "build": "tsc",