summer-engine 3.4.0 → 3.5.0

package/library/skills/vfx-water-ripple/_building-blocks/additive-billboard-particles.md

@@ -1,6 +1,6 @@
 # Additive Billboard Particles — Canonical Material Settings
 
-Reusable material configuration for additive particle billboards (motes, sparks, glow, ash). Used by `magic-glow`, optionally substitutable in `hit-spark` and `fire` if a custom shader is overkill.
+Reusable material configuration for additive particle billboards (motes, sparks, glow, ash). Used by `vfx-magic-glow`, optionally substitutable in `vfx-hit-spark` and `vfx-fire` if a custom shader is overkill.
 
 `BaseMaterial3D` is abstract — `BaseMaterial3D.new()` is a parse error ("Native class
 "BaseMaterial3D" cannot be constructed as it is abstract"). Instantiate
@@ -27,8 +27,8 @@ bm.emission = Color(R, G, B)          # usually same as albedo for single-color
 
 ## When to use this vs a custom shader
 
-- **Use this `StandardMaterial3D` config** when the effect is just a tinted soft-circle mote (magic glow, sparkles, dust). Less code, faster iteration, free Godot-managed billboard math.
-- **Per-particle color over age does NOT need a custom shader.** `ParticleProcessMaterial` has `color_ramp`, `color_initial_ramp`, `alpha_curve` and `emission_curve` (all verified present in 4.6) — those drive the particle's `COLOR` from age and feed straight into a plain `StandardMaterial3D`. Reach for a ramp before reaching for a shader.
+- **Use this `StandardMaterial3D` config** when the effect is just a tinted soft-circle mote (magic glow, sparkles, dust). Less code, faster iteration, free engine-managed billboard math.
+- **Per-particle color over age does NOT need a custom shader.** `ParticleProcessMaterial` has `color_ramp`, `color_initial_ramp`, `alpha_curve` and `emission_curve` (all present on the shipped engine) — those drive the particle's `COLOR` from age and feed straight into a plain `StandardMaterial3D`. Reach for a ramp before reaching for a shader.
 - **Use a custom `ShaderMaterial`** when you need per-fragment shape masks (muzzle flash star burst), noise-distorted UVs (fire, smoke), or anything that varies *within* the quad. Those are what `StandardMaterial3D` genuinely can't express.
 - If a custom shader does need the particle age, note that the age lives in `INSTANCE_CUSTOM.y` (normalized by `INSTANCE_CUSTOM.w`, the lifetime), that `INSTANCE_CUSTOM.x` is the rotation angle — not the age — and that `INSTANCE_CUSTOM` is **vertex-stage only**. Pass it to `fragment()` through a `varying`.
 

package/library/skills/voice-line/SKILL.md

@@ -24,7 +24,7 @@ Then it generates one line (or a multi-turn dialogue) with the right stability /
 
 ## When NOT to use
 
-- Non-verbal vocal SFX (grunt, scream) → `audio/sound-effect` with prompt `male grunt of pain, mid-thirties, sharp, 400ms`.
+- Non-verbal vocal SFX (grunt, scream) → `sound-effect` with prompt `male grunt of pain, mid-thirties, sharp, 400ms`.
 - Pre-recorded voice from a real actor — import the .mp3 / .wav with `summer_import_from_url` and skip TTS.
 
 ## Steps
@@ -146,7 +146,7 @@ For a single line, the prompt is just the text. Punctuation and formatting matte
 
 - **Periods** = clear pauses (~300ms). Use them.
 - **Commas** = short pauses (~100ms).
-- **Em dashes** = sharp cut. (Note: avoid em dashes in user-facing UI copy per project standard, but they're fine in voice prompts as a delivery cue.)
+- **Em dashes** = sharp cut.
 - **All-caps word** = stress: `You SHALL not pass.`
 - **Ellipsis** = trailing pause: `I... I don't know what to say.`
 - **Parenthetical stage direction is ignored** — `(angrily)` is read as the word "angrily". Use stability/style instead.
@@ -230,7 +230,7 @@ Excited young hero:       18-28, high energy, mid-high pitch
 Cold villain:             30-50, neutral/theatrical, low-mid, slow with sharp consonants
 Mischievous trickster:    theatrical, light, fast cadence
 Calm scholar:             30-50, neutral, mid, even cadence
-Scared / breathy:         high stability=0.25, style=0.5
+Scared / breathy:         stability=0.25, style=0.5
 Robotic AI:               stability=1.0, style=0.0
 Narrator cinematic:       mid-deep, neutral/theatrical, even, very stable
 Narrator intimate:        warmer mid pitch, lower stability for breath
@@ -250,9 +250,9 @@ Narrator intimate:        warmer mid pitch, lower stability for breath
 
 ## Edge cases
 
-- **Line longer than ~1000 characters.** ElevenLabs caps per-call. Split at sentence boundaries, generate each, concatenate with `AudioStreamPlayer.queue` or chained `finished` signals.
+- **Line longer than ~1000 characters.** ElevenLabs caps per-call. Split at sentence boundaries, generate each, and play them in order by chaining the player's `finished` signal.
 - **Mispronunciation of a fictional word.** Spell it phonetically: `Caelthorne` → `KEL-thorn` or `KAYL-thorn`. Or use SSML if the model supports it.
-- **Voice drifts in long lines.** Increase `similarity_boost` toward 0.9; or split.
+- **Voice drifts in long lines.** Increase `similarityBoost` toward 0.9; or split.
 - **Need a non-English line.** `eleven_multilingual_v2` supports 29 languages. Just write in the target language; the same voice id works.
 - **User wants the line shorter on regen.** Edit the text first; don't try to compress with `speed` past 1.15 (artifacts).
 - **NPC bark variants.** Generate 3–5 variants of the same intent (`"They're at the gate!"`, `"Enemy approaching!"`, `"Look out!"`) and pick at random in code so the bark doesn't repeat.
@@ -266,10 +266,10 @@ Print the call (text, voice id, params, target path). User runs via the Summer d
 > Line `hodge_hold_the_line.mp3` wired to `NPC/VoiceLine` on the `Voice` bus. Cast bible updated. Next:
 > - Generate 3 bark variants of the same intent so the NPC doesn't sound like a recording.
 > - For the upcoming gate scene, run `/voice-line` with `text_to_dialogue` for the multi-turn exchange.
-> - Set up music ducking on the `Music` bus when `Voice` is active (one Tween or a `BusEffect Compressor` sidechained to `Voice`).
+> - Set up music ducking on the `Music` bus when `Voice` is active (one Tween, or an `AudioEffectCompressor` on `Music` with `sidechain` set to `Voice`).
 
 ## See also
 
-- `audio/audio-direction` — Voice bus and ducking rules
-- `audio/sound-effect` — non-verbal vocal SFX (grunt, scream)
-- `audio/adaptive-music` — ducking integration
+- `audio-direction` — Voice bus and ducking rules
+- `sound-effect` — non-verbal vocal SFX (grunt, scream)
+- `adaptive-music` — ducking integration

package/library/skills/world-building-3d/references/spatial-tools.md

@@ -17,7 +17,7 @@ Input is a candidate global position and global Euler rotation. The subject's cu
 
 Interpretation:
 
-- Physics overlap counts are lower bounds because Godot exposes no broadphase-completeness bit.
+- Physics overlap counts are lower bounds because the physics server exposes no broadphase-completeness bit.
 - Any known obstruction makes `fits: false`.
 - Zero known physics overlaps can still yield `fits: null`; never coerce it to success.
 - `grounded`, signed `floorGap`, and support evidence are independent of overlap certainty. Claim physics-grounded only when `floorEvidence` is `physics` and `supportQueryComplete` is true; otherwise label the evidence approximate or incomplete.
@@ -42,7 +42,7 @@ This is one-dimensional arrangement evidence. It does not prove clearance on the
 
 ## `summer_navigation_probe`
 
-Iteration 0 is unready; iteration 1 and later can be queried. Layer-filtered snapped endpoints and the reported snap distances define what Godot actually tested. `ready: false` means unknown, not unreachable.
+Iteration 0 is unready; iteration 1 and later can be queried. Layer-filtered snapped endpoints and the reported snap distances define what the engine actually tested. `ready: false` means unknown, not unreachable.
 
 Require both a reachable path and a small endpoint snap distance appropriate to the authored target.
 Probe every independent destination; one reachable subject does not validate the

package/library/skills/writing-plans/SKILL.md

@@ -66,9 +66,9 @@ This structure informs the task decomposition. Each task should produce self-con
 ### Task N: [Component Name]
 
 **Files:**
-- Create: `exact/path/to/file.py`
-- Modify: `exact/path/to/existing.py:123-145`
-- Test: `tests/exact/path/to/test.py`
+- Create: `exact/path/to/file.gd`
+- Modify: `exact/path/to/existing.gd:123-145`
+- Test: `tests/exact/path/to/test_file.gd`
 
 - [ ] **Step 1: Write the failing test**
 
@@ -103,7 +103,7 @@ Expected: PASS
 - [ ] **Step 5: Commit**
 
 ```bash
-git add tests/path/test.py src/path/file.py
+git add tests/unit/test_health.gd scripts/health.gd
 git commit -m "feat: add specific feature"
 ```
 ````

package/library/skills/writing-skills/SKILL.md

@@ -104,7 +104,7 @@ skills/
 
 ```markdown
 ---
-name: Skill-Name-With-Hyphens
+name: skill-name-with-hyphens
 description: Use when [specific triggering conditions and symptoms]
 ---
 
@@ -260,7 +260,7 @@ You: Searching...
 
 **Verification:**
 ```bash
-wc -w skills/path/SKILL.md
+wc -w library/skills/<slug>/SKILL.md
 # getting-started workflows: aim for <150 each
 # Other frequently-loaded: aim for <200 total
 ```
@@ -287,7 +287,7 @@ Use skill name only, with explicit requirement markers:
 
 **Check the skill exists before you point at it.** The registry of shipped skills is `registry/generated/skills-registry.json` (generated from `library/skills/`); `summer skills list` prints it. A `REQUIRED SUB-SKILL` pointing at a skill that was never shipped is worse than no cross-reference: the reader stops and looks for something that does not exist.
 
-**Why no @ links:** `@` syntax force-loads files immediately, consuming 200k+ context before you need them.
+**Why no @ links:** `@` syntax force-loads files immediately and spends context before you need them.
 
 ## Flowchart Usage
 
@@ -549,7 +549,7 @@ Run same scenarios WITH skill. Agent should now comply.
 
 Agent found new rationalization? Add explicit counter. Re-test until bulletproof.
 
-**Testing methodology:** See @testing-skills-with-subagents.md for the complete testing methodology:
+**Testing methodology:** See `testing-skills-with-subagents.md` in this directory for the complete testing methodology:
 - How to write pressure scenarios
 - Pressure types (time, sunk cost, authority, exhaustion)
 - Plugging holes systematically
@@ -633,10 +633,10 @@ Deploying untested skills = deploying untested code. It's a violation of quality
 How future Claude finds your skill:
 
 1. **Encounters problem** ("tests are flaky")
-3. **Finds SKILL** (description matches)
-4. **Scans overview** (is this relevant?)
-5. **Reads patterns** (quick reference table)
-6. **Loads example** (only when implementing)
+2. **Finds SKILL** (description matches)
+3. **Scans overview** (is this relevant?)
+4. **Reads patterns** (quick reference table)
+5. **Loads example** (only when implementing)
 
 **Optimize for this flow** - put searchable terms early and often.
 

package/library/tools/capture-gameplay/resource.yaml

@@ -1,12 +1,13 @@
 id: tool/capture-gameplay
 kind: tool
 version: 1.0.0
-summary: Capture real gameplay frames (PNG, HUD included) in Summer Engine's offscreen verify instance, without a running editor, e.g. store screenshots.
+summary: Capture real gameplay PNGs (HUD included) offscreen without a running editor; game flags and player steps (press, key, click) get past the title screen.
 use_when:
   - '"take gameplay screenshots for my store page"'
   - '"I need screenshots but the editor is not open"'
   - '"capture a 1920x1080 frame of my game"'
   - collecting real gameplay screenshots for summer_store_set_art desktop.screenshots or mobile.screenshots
+  - every capture shows the title screen — pass the game's flags in args or steps like press Play
 do_not_use_when:
   - the editor is open and the game is running — tool/screenshot with target game shows the live game
   - key art, covers or icons — those are generated art, not gameplay frames
@@ -62,6 +63,70 @@ input_schema:
     out:
       type: string
       description: Output folder. Defaults to <project>/.summer/captures/<time>/ (ignored by git).
+    args:
+      type: array
+      maxItems: 32
+      items:
+        type: string
+      description: The game's own command-line flags, passed after "--" (OS.get_cmdline_user_args()), e.g. ["--autostart", "--solo"] to skip the title screen.
+    steps:
+      type: array
+      maxItems: 50
+      description: 'What to do after waitSeconds, in order; exactly one of press, key, action, click, drag, wait, shot per step. Example: [{"press":"Play"},{"wait":3000},{"key":"Space"},{"shot":true},{"action":"jump"},{"wait":500},{"shot":true}]. With a shot step only shot steps save frames. A step that cannot run becomes a warning.'
+      items:
+        type: object
+        properties:
+          press:
+            type: string
+            description: Press the visible button with this text (or node name); waits up to timeoutSeconds (default 10) for it.
+          timeoutSeconds:
+            type: number
+            minimum: 0
+            maximum: 60
+          key:
+            type: string
+            description: Press a key by Godot name (Space, Enter, Escape, A, Up).
+          action:
+            type: string
+            description: Press an input action from the project's InputMap, e.g. jump.
+          holdMs:
+            type: number
+            minimum: 0
+            maximum: 10000
+            description: How long key or action is held (default 100).
+          click:
+            type: array
+            items:
+              type: number
+            description: Left-click at [x, y] in frame pixels.
+          drag:
+            type: object
+            properties:
+              from:
+                type: array
+                items:
+                  type: number
+              to:
+                type: array
+                items:
+                  type: number
+              ms:
+                type: number
+                minimum: 0
+                maximum: 10000
+            required:
+              - from
+              - to
+            description: Drag with the left button from [x, y] to [x, y] over ms (default 300).
+          wait:
+            type: number
+            minimum: 0
+            maximum: 60000
+            description: Wait this many milliseconds.
+          shot:
+            type: boolean
+            description: true saves a frame now.
+        additionalProperties: false
   additionalProperties: false
 authority:
   filesystem: true

package/library/tools/creator-publish/resource.yaml

@@ -1,12 +1,12 @@
 id: tool/creator-publish
 kind: tool
 version: 1.1.0
-summary: "Deprecated: publishes a .pck to the legacy Summercraft API. Use summer_export_game, then summer_publish_build, to upload to summer.games."
+summary: "Deprecated: publishes a .pck to the legacy creator API. Use summer_export_game, then summer_publish_build, to upload to summer.games."
 use_when:
-  - releasing a user-approved build to a Summercraft channel
-  - '"ship this exported build to the live channel"'
-  - '"release version 1.2.0 of my game"'
+  - an old project that still publishes a .pck to the legacy Summercraft creator channel with an sc_ creator token
+  - a ~/.summer/config.json that names a legacy creator projectId and channel
 do_not_use_when:
+  - releasing a version on summer.games — summer_publish_build, then summer_store_submit (the owner approves)
   - uploading to summer.games — summer_export_game, then summer_publish_build
   - the user has not approved the exact version, digest, and channel
   - the game is not exported yet — export the .pck first (skill/export-and-ship)

package/library/tools/creator-releases/resource.yaml

@@ -1,12 +1,12 @@
 id: tool/creator-releases
 kind: tool
 version: 1.0.2
-summary: List creator-owned releases from the Summercraft creator API with server-verified scope and ownership.
+summary: "Deprecated: lists releases on the legacy creator API. For summer.games use summer_store_releases."
 use_when:
-  - reviewing which versions of a project are live per channel
-  - '"what version is live right now?"'
-  - '"did the publish go through?" — confirming a release landed'
+  - an old project that published a .pck to the legacy Summercraft creator channel with an sc_ creator token
+  - paging legacy creator releases by projectId and cursor
 do_not_use_when:
+  - what players get on summer.games, or whether a release landed — summer_store_releases
   - publishing a new release — summer_publish_build
 facets:
   lifecycle:
@@ -18,7 +18,7 @@ compatibility:
   engine: ">=4.6"
 source: official
 license: MIT
-status: stable
+status: deprecated
 aliases:
   - summer_creator_releases
 implementation:

package/library/tools/export-game/resource.yaml

@@ -61,6 +61,9 @@ input_schema:
       minimum: 10
       maximum: 7200
       description: Stop the engine after this many seconds (default 900; a first export imports every asset).
+    alignDeclaration:
+      type: boolean
+      description: A game with a server, set summer.build.json targetPlatforms to targets before exporting. The store refuses an upload whose declaration differs from the exported platforms (declaration_mismatch) and that spends the version.
   additionalProperties: false
 authority:
   filesystem: true

package/library/tools/generate-image/resource.yaml

@@ -33,8 +33,7 @@ input_schema:
       description: Description of the image to generate
     model:
       type: string
-      default: nano-banana-2
-      description: Model name or full provider ID
+      description: Model name or full provider ID. Omit it and the server picks one that reaches the requested size (nano-banana-2 when no size is asked).
     style:
       type: string
       default: realistic
@@ -63,6 +62,9 @@ input_schema:
       type: object
       additionalProperties: {}
       description: Extra model params (seed, negative_prompt, ...). The result lists any it did not use in ignoredOptions.
+    out:
+      type: string
+      description: Where to save the image on this machine, a folder or a file path ending in .png, .jpg or .webp. Default is <TMPDIR>/summer-gen/.
   required:
     - prompt
   additionalProperties: false

package/library/tools/publish-build/resource.yaml

@@ -6,12 +6,16 @@ use_when:
   - '"upload my game to summer.games"'
   - '"publish this build to my store page"'
   - '"put my game online so my friends can play it"'
+  - '"release version 1.2.0 of my game"'
+  - '"ship this exported build to the live channel"'
   - uploading the .zip from summer_export_game as a new Build
   - uploading a web build or a macOS or Windows download from summer_export_game format download
 do_not_use_when:
   - the user has not approved the exact game, file, digest, version and publish choice
   - the game is not exported yet — summer_export_game first
-  - store page text, images or price — those are edited in Studio
+  - store page text, art or price — summer_store_update_listing, summer_store_set_art (mounted after summer login --store)
+  - making the build live — summer_store_submit (the owner approves publishing), then summer_build_release
+  - what players get now — summer_store_releases
 facets:
   lifecycle:
     - launch

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "summer-engine",
-  "version": "3.4.0",
+  "version": "3.5.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",

package/registry/generated/counts.json

@@ -4,9 +4,9 @@
     "collection": 0,
     "example": 0,
     "reference": 9,
-    "skill": 118,
+    "skill": 122,
     "template": 19,
     "tool": 105
   },
-  "total": 251
+  "total": 255
 }

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.4.0",
+  "version": "3.5.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": {
@@ -68,6 +68,7 @@
     "./library/skills/gdscript-patterns/",
     "./library/skills/generate-motion/",
     "./library/skills/godogen-visual-proof-game-generation/",
+    "./library/skills/grow-analytics/",
     "./library/skills/headless-scripting/",
     "./library/skills/in-game-purchases/",
     "./library/skills/instantiate-asset-pack/",
@@ -90,6 +91,7 @@
     "./library/skills/procedural-animation/",
     "./library/skills/prop-model/",
     "./library/skills/psx-retro-rendering/",
+    "./library/skills/publish-your-game/",
     "./library/skills/realtime-wet-surfaces/",
     "./library/skills/remote-deploy/",
     "./library/skills/retarget/",
@@ -107,6 +109,8 @@
     "./library/skills/sound-effect/",
     "./library/skills/spatial-placement/",
     "./library/skills/sprite-sheet/",
+    "./library/skills/store-art/",
+    "./library/skills/store-listing/",
     "./library/skills/summer-analytics/",
     "./library/skills/summer-friends/",
     "./library/skills/summer-leaderboards/",