summer-engine 3.0.0 → 3.2.0

package/library/tools/snap-to-surface/resource.yaml

@@ -1,10 +1,12 @@
 id: tool/snap-to-surface
 kind: tool
-version: 1.0.0
+version: 1.2.0
 summary: Move one 3D subject along a world ray until it sits at the requested gap from the first surface (floor, ramp, shelf, table), then save the scene.
 use_when:
   - seating a prop on a floor, ramp, table, or shelf instead of hand-tuning its Y position
   - grounding an imported or instantiated model that floats or sinks into its support
+  - lifting a prop that is sunk a few centimetres into the ground back onto it
+  - seating a prop without a collider (a fern, a bottle) on a PlaneMesh or other mesh-only ground
 do_not_use_when:
   - you only want to know whether a pose fits — summer_test_placement is read-only
   - arranging several objects relative to each other — summer_align_distribute_3d
@@ -25,6 +27,7 @@ related:
     - tool/align-distribute-3d
     - tool/world-snapshot
     - tool/set-prop
+    - tool/starcast
   skills:
     - skill/world-building-3d
 source: official

package/library/tools/world-snapshot/resource.yaml

@@ -1,11 +1,13 @@
 id: tool/world-snapshot
 kind: tool
-version: 1.0.2
-summary: Compact structured snapshot of the edited scene (paths, transforms, world AABBs, fingerprints, counts) — the cheap read before and after every mutation batch.
+version: 1.1.0
+summary: Structured scene snapshot (paths, transforms, world AABBs, fingerprints, counts), filterable by subtree, class and field; the read around every mutation.
 use_when:
   - taking a diffable baseline before a mutation batch, or verifying transforms/AABBs/fingerprints after one
   - '"where exactly is everything in this scene?" — positions, sizes, bounds'
   - '"are these two props overlapping?" / "is anything floating?"'
+  - '"where did the pieces of House3 land?" — path_prefix + fields:[pos, aabb] reads one subtree cheaply'
+  - counting instances per class in one subtree (matched_counts)
 do_not_use_when:
   - you only need the hierarchy shape — summer_get_scene_tree
   - "requires an engine build with GetWorldSnapshot (Summer Engine 0.5.66 or newer); older engines return engine_lacks_op"
@@ -50,7 +52,26 @@ input_schema:
     max_nodes:
       type: integer
       exclusiveMinimum: 0
-      description: Node cap (engine default 4000). The result declares truncation — never assume a capped list is complete.
+      description: Most node entries to return (default 200). The engine still snapshots the whole scene for the diff baseline; the result says when the list is cut (truncated, next_offset).
+    offset:
+      type: integer
+      minimum: 0
+      description: Skip this many matching nodes (path-sorted) before listing — page with the result's next_offset.
+    path_prefix:
+      type: string
+      description: Only this subtree, the node at this scene-relative path and everything below it, e.g. 'House3' or 'Lane2/Props'.
+    classes:
+      type: array
+      items:
+        type: string
+      maxItems: 32
+      description: Only nodes of these classes, e.g. ['MeshInstance3D', 'OmniLight3D'] (* wildcards allowed).
+    fields:
+      type: array
+      items:
+        type: string
+      maxItems: 16
+      description: "Only these per-node fields (path is always kept): class, name, pos, rot_deg, scale, visible, aabb, scene_file, script_fp, material_fps, z_index, rect, view_rect, limit_rect."
   additionalProperties: false
 authority:
   filesystem: false

package/library/tools/zoom/resource.yaml

@@ -0,0 +1,105 @@
+id: tool/zoom
+kind: tool
+version: 1.0.0
+summary: 'High-resolution close-up of exactly a frame region or of mark N, rendered as the exact sub-frustum at full resolution (real detail, not upscaled pixels).'
+use_when:
+  - 'checking seams, gaps, floating pieces, texture resolution or tiling up close'
+  - 'looking closer at a numbered mark from a marks render (summer_frame_nodes marks:true, or summer_screenshot marks at the same size)'
+  - 'inspecting a region a difference map or debug view flagged'
+do_not_use_when:
+  - 'the whole view — summer_shot_sheet / summer_frame_nodes'
+  - 'you have no pose yet — get one from a bookmark or summer_frame_shot first'
+facets:
+  lifecycle:
+    - build
+  domains:
+    - verification
+    - scenes
+    - 3d
+  modalities:
+    - scenes
+compatibility:
+  engine: ">=4.6"
+related:
+  tools:
+    - tool/frame-nodes
+    - tool/screenshot
+    - tool/debug-views
+    - tool/shot-sheet
+  skills:
+    - skill/verifying-scenes
+source: official
+license: MIT
+status: preview
+aliases:
+  - summer_zoom
+implementation:
+  module: src/mcp/tools/seeing-tools.ts
+  export: registerSeeingTools
+surfaces:
+  mcp:
+    tool_name: summer_zoom
+    remote: false
+input_schema:
+  type: object
+  properties:
+    scenePath:
+      type: string
+      description: Scene to look at, e.g. "res://levels/town.tscn" (the SAVED file). Omit for the scene open in the editor.
+    bookmark_name:
+      type: string
+      description: Pose from a camera bookmark (summer_camera_bookmark). Use INSTEAD of camera_position/camera_look_at.
+    camera_position:
+      type: string
+      description: 'Explicit pose: camera position, "Vector3(x, y, z)". Goes with camera_look_at.'
+    camera_look_at:
+      type: string
+      description: 'Explicit pose: point the camera looks at, "Vector3(x, y, z)".'
+    fov:
+      type: number
+      description: "Vertical field of view in degrees (1..179). Default: the bookmark's own, or 60."
+    region:
+      type: array
+      items:
+        type: number
+      minItems: 4
+      maxItems: 4
+      description: '[x, y, w, h] as fractions (0..1) of the frame from the same pose, x/y from the TOP-LEFT. Use this OR mark. Rendered EXACTLY (no padding by default, never widened to an aspect ratio): the image takes the region''s own aspect, with dark bars only for extreme shapes.'
+    mark:
+      type: integer
+      description: A label number from a marks:true render of the SAME pose and reference_size (summer_frame_nodes, or summer_screenshot framing free/bookmark at that size). The caption warns when that node is hidden behind other geometry at this pose.
+    reference_size:
+      type: array
+      items:
+        type: integer
+      minItems: 2
+      maxItems: 2
+      description: "[width, height] of the frame region/mark refer to (default [1024, 576]). Sets the zoom's aspect."
+    pad:
+      type: number
+      description: 'Margin added around the region on each side, as a fraction of its size (0..1; default 0 for region, 0.15 for mark). The caption''s widened_because says when the rendered window is larger than asked.'
+    view:
+      type: string
+      enum:
+        - beauty
+        - lighting
+        - unshaded
+        - normals
+        - overdraw
+        - wireframe
+      description: '"beauty" (default: real environment, lights, fog, tonemap), "lighting" (light only), "unshaded" (albedo/texture only), "normals" (world normals, x red y green z blue), "overdraw", "wireframe".'
+    max_size:
+      type: integer
+      minimum: 64
+      maximum: 4096
+      description: Longest edge of the returned JPEG in pixels (default 1024). Bigger costs more context; up to 4096 for detail work on a PC.
+    save_to:
+      type: string
+      description: Also write the returned image to res://.summer/shots/saved/<name>.jpg (1-64 of A-Z a-z 0-9 _ -; needs max_size <= 1024). Nothing is written without it, except one previous-image slot per rendered bookmark.
+  additionalProperties: false
+authority:
+  filesystem: true
+  editor_mutation: false
+  network: false
+  credentials: false
+  publish: false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "summer-engine",
-  "version": "3.0.0",
+  "version": "3.2.0",
   "description": "Local Summer CLI and MCP server for Summer Engine. Install and run the engine, connect Claude Code, Cursor, Codex, Gemini, and other agents, and build real games with bundled skills, hooks, and plugins.",
   "keywords": [
     "summer-engine",
@@ -86,12 +86,12 @@
     "@modelcontextprotocol/sdk": "^1.30.0",
     "commander": "^12.0.0",
     "open": "^10.0.0",
+    "yaml": "^2.9.0",
     "zod": "^3.23.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
     "typescript": "^5.5.0",
-    "vitest": "^3.2.4",
-    "yaml": "^2.9.0"
+    "vitest": "^3.2.4"
   }
 }

package/registry/generated/aliases.json

@@ -1,6 +1,7 @@
 {
   "_generated": "GENERATED — do not edit; run npm run generate:registry",
   "aliases": {
+    "animate-from-text": "skill/text-to-motion",
     "dissolve": "skill/vfx-dissolve",
     "docs/HEADLESS_ROUTING.md": "reference/headless-routing",
     "docs/MCP_FRESH_CHAT_PLAYBOOK.md": "reference/mcp-fresh-chat-playbook",
@@ -52,9 +53,6 @@
     "skills/gameplay-mechanics/design-mechanic": "skill/design-mechanic",
     "skills/level-design/design-level": "skill/design-level",
     "skills/level-design/scene-to-level": "skill/scene-to-level",
-    "skills/multiplayer-and-networking/host-authoritative-state": "skill/host-authoritative-state",
-    "skills/multiplayer-and-networking/peer-to-peer-multiplayer": "skill/peer-to-peer-multiplayer",
-    "skills/multiplayer-and-networking/setup-multiplayer": "skill/setup-multiplayer",
     "skills/performance/tune-performance": "skill/tune-performance",
     "skills/rendering-and-lighting/3d-lighting": "skill/3d-lighting",
     "skills/rendering-and-lighting/art-direction": "skill/art-direction",
@@ -102,17 +100,22 @@
     "summer_add_node": "tool/add-node",
     "summer_align_distribute_3d": "tool/align-distribute-3d",
     "summer_api_docs": "tool/api-docs",
+    "summer_attach_to_surface": "tool/attach-to-surface",
     "summer_batch": "tool/batch",
     "summer_camera_bookmark": "tool/camera-bookmark",
     "summer_check_job": "tool/check-job",
     "summer_clear_console": "tool/clear-console",
+    "summer_connect_ports": "tool/connect-ports",
     "summer_connect_signal": "tool/connect-signal",
     "summer_create_debug_report": "tool/create-debug-report",
     "summer_create_scene": "tool/create-scene",
     "summer_creator_config": "tool/creator-config",
     "summer_creator_publish": "tool/creator-publish",
     "summer_creator_releases": "tool/creator-releases",
+    "summer_debug_views": "tool/debug-views",
     "summer_fabricate_3d": "tool/fabricate-3d",
+    "summer_frame_nodes": "tool/frame-nodes",
+    "summer_frame_shot": "tool/frame-shot",
     "summer_game_control": "tool/game-control",
     "summer_game_input": "tool/game-input",
     "summer_game_probe": "tool/game-probe",
@@ -124,6 +127,7 @@
     "summer_get_agent_playbook": "tool/get-agent-playbook",
     "summer_get_asset": "tool/get-asset",
     "summer_get_asset_download_url": "tool/get-asset-download-url",
+    "summer_get_board": "tool/get-board",
     "summer_get_console": "tool/get-console",
     "summer_get_debugger_errors": "tool/get-debugger-errors",
     "summer_get_debugger_warnings": "tool/get-debugger-warnings",
@@ -133,12 +137,14 @@
     "summer_get_scene_tree": "tool/get-scene-tree",
     "summer_get_script_errors": "tool/get-script-errors",
     "summer_get_studio_workflow": "tool/get-studio-workflow",
+    "summer_grep": "tool/grep",
     "summer_import_asset": "tool/import-asset",
     "summer_import_asset_by_id": "tool/import-asset-by-id",
     "summer_import_from_url": "tool/import-from-url",
     "summer_import_from_url_batch": "tool/import-from-url-batch",
     "summer_import_hdri": "tool/import-hdri",
     "summer_input_map_bind": "tool/input-map-bind",
+    "summer_inspect_asset": "tool/inspect-asset",
     "summer_inspect_node": "tool/inspect-node",
     "summer_inspect_resource": "tool/inspect-resource",
     "summer_inspect_runtime_node": "tool/inspect-runtime-node",
@@ -146,16 +152,20 @@
     "summer_is_running": "tool/is-running",
     "summer_library_feedback": "tool/library-feedback",
     "summer_list_my_assets": "tool/list-my-assets",
+    "summer_measure": "tool/measure",
     "summer_navigation_probe": "tool/navigation-probe",
     "summer_open": "tool/open",
     "summer_open_main_scene": "tool/open-main-scene",
     "summer_open_scene": "tool/open-scene",
+    "summer_place_adjacent": "tool/place-adjacent",
     "summer_play": "tool/play",
     "summer_project_setting": "tool/project-setting",
+    "summer_raycast": "tool/raycast",
     "summer_read_file": "tool/read-file",
     "summer_read_library": "tool/read-library",
     "summer_recent_events": "tool/recent-events",
     "summer_remove_node": "tool/remove-node",
+    "summer_repeat_along": "tool/repeat-along",
     "summer_replace_node": "tool/replace-node",
     "summer_replace_text": "tool/replace-text",
     "summer_run_editor_script": "tool/run-editor-script",
@@ -165,12 +175,14 @@
     "summer_runtime_set": "tool/runtime-set",
     "summer_runtime_spawn": "tool/runtime-spawn",
     "summer_save_scene": "tool/save-scene",
+    "summer_scene_audit": "tool/scene-audit",
     "summer_screenshot": "tool/screenshot",
     "summer_search_assets": "tool/search-assets",
     "summer_search_library": "tool/search-library",
     "summer_select_node": "tool/select-node",
     "summer_set_prop": "tool/set-prop",
     "summer_set_resource_property": "tool/set-resource-property",
+    "summer_shot_sheet": "tool/shot-sheet",
     "summer_slice_asset_sheet": "tool/slice-asset-sheet",
     "summer_snap_to_surface": "tool/snap-to-surface",
     "summer_snapshot_diff": "tool/snapshot-diff",
@@ -185,6 +197,7 @@
     "summer_wait_for_event": "tool/wait-for-event",
     "summer_world_snapshot": "tool/world-snapshot",
     "summer_write_file": "tool/write-file",
+    "summer_zoom": "tool/zoom",
     "template-2d-brario-platformer": "template/2d-brario-platformer",
     "template-2d-dungeon-roguelike": "template/2d-dungeon-roguelike",
     "template-2d-grid-puzzle": "template/2d-grid-puzzle",
@@ -202,6 +215,7 @@
     "template-3d-royale-clash-type": "template/3d-royale-clash-type",
     "template-3d-third-person-controller": "template/3d-third-person-controller",
     "template-3d-voxel-sandbox": "template/3d-voxel-sandbox",
+    "text-motion": "skill/text-to-motion",
     "water-ripple": "skill/vfx-water-ripple"
   }
 }

package/registry/generated/counts.json

@@ -4,9 +4,9 @@
     "collection": 0,
     "example": 0,
     "reference": 9,
-    "skill": 94,
+    "skill": 116,
     "template": 19,
-    "tool": 86
+    "tool": 101
   },
-  "total": 208
+  "total": 245
 }

package/registry/generated/gemini-extension.json

@@ -1,7 +1,7 @@
 {
   "_generated": "GENERATED from integrations/gemini — do not edit; npm run generate:registry",
   "name": "summer",
-  "version": "3.0.0",
+  "version": "3.2.0",
   "description": "Agent tooling for Summer Engine: MCP bridge, context primer, and game-dev skills. Use with the npm CLI for skill files on disk.",
   "contextFileName": "GEMINI.md",
   "mcpServers": {
@@ -27,6 +27,7 @@
     "./library/skills/3d-lighting/",
     "./library/skills/adaptive-music/",
     "./library/skills/agent-playtesting/",
+    "./library/skills/ai-characters-in-games/",
     "./library/skills/ambient-bed/",
     "./library/skills/animated-loop/",
     "./library/skills/animation-tree/",
@@ -37,11 +38,14 @@
     "./library/skills/brainstorm-game/",
     "./library/skills/brainstorming/",
     "./library/skills/browse-templates/",
+    "./library/skills/camera-rigs/",
     "./library/skills/celeste-momentum-platforming/",
     "./library/skills/character-animation-wiring/",
     "./library/skills/character-model/",
+    "./library/skills/character-movement/",
     "./library/skills/character-portrait/",
     "./library/skills/cinematic-cutscene/",
+    "./library/skills/combat-basics/",
     "./library/skills/concept-art/",
     "./library/skills/create-asset-sheet/",
     "./library/skills/debug/",
@@ -63,16 +67,21 @@
     "./library/skills/generate-motion/",
     "./library/skills/godogen-visual-proof-game-generation/",
     "./library/skills/headless-scripting/",
-    "./library/skills/host-authoritative-state/",
+    "./library/skills/in-game-purchases/",
     "./library/skills/instantiate-asset-pack/",
     "./library/skills/investigating-bugs/",
     "./library/skills/lumera-single-image-scene-reconstruction/",
     "./library/skills/make-game/",
+    "./library/skills/multiplayer/",
+    "./library/skills/multiplayer-movement/",
+    "./library/skills/multiplayer-project/",
+    "./library/skills/multiplayer-publish/",
+    "./library/skills/multiplayer-state/",
+    "./library/skills/multiplayer-testing/",
     "./library/skills/music-track/",
     "./library/skills/navigate-summer/",
     "./library/skills/new-project/",
     "./library/skills/organic-model/",
-    "./library/skills/peer-to-peer-multiplayer/",
     "./library/skills/pixel-art/",
     "./library/skills/play/",
     "./library/skills/playtesting-a-feature/",
@@ -83,11 +92,11 @@
     "./library/skills/remote-deploy/",
     "./library/skills/retarget/",
     "./library/skills/running-in-the-cloud/",
+    "./library/skills/save-load/",
     "./library/skills/scene-composition/",
     "./library/skills/scene-hierarchy-design/",
     "./library/skills/scene-scripting/",
     "./library/skills/scene-to-level/",
-    "./library/skills/setup-multiplayer/",
     "./library/skills/skill-create/",
     "./library/skills/skill-improve/",
     "./library/skills/skill-test/",
@@ -96,6 +105,17 @@
     "./library/skills/sound-effect/",
     "./library/skills/spatial-placement/",
     "./library/skills/sprite-sheet/",
+    "./library/skills/summer-analytics/",
+    "./library/skills/summer-friends/",
+    "./library/skills/summer-leaderboards/",
+    "./library/skills/summer-match-results/",
+    "./library/skills/summer-matchmaking/",
+    "./library/skills/summer-parties/",
+    "./library/skills/summer-player-data/",
+    "./library/skills/summer-store/",
+    "./library/skills/summer-world-chat/",
+    "./library/skills/summer-world-saves/",
+    "./library/skills/text-to-motion/",
     "./library/skills/tileable-texture/",
     "./library/skills/trailer-shot/",
     "./library/skills/tune-performance/",
@@ -115,6 +135,8 @@
     "./library/skills/vfx-smoke/",
     "./library/skills/vfx-water-ripple/",
     "./library/skills/voice-line/",
+    "./library/skills/web-and-touch-input/",
+    "./library/skills/web-compatibility-look/",
     "./library/skills/world-building-3d/",
     "./library/skills/writing-plans/",
     "./library/skills/writing-skills/"