A skill that turn any brand into a scrollable 3D world landing page
JavaScript
Camera architecture: continuous forward take (fixes seam stutter)
cyw7c661dcdc4f9
diff --git a/plugins/scroll-world/.claude-plugin/plugin.json b/plugins/scroll-world/.claude-plugin/plugin.jsonindex d96d3da..4a7e04b 100644--- a/plugins/scroll-world/.claude-plugin/plugin.json+++ b/plugins/scroll-world/.claude-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "scroll-world","description": "Build an immersive scroll-scrubbed 'fly through the world' landing page for any industry or brand using Higgsfield. As the visitor scrolls, a pre-rendered camera flies from outside each scene into its interior, then flows on to the next scene with no cuts — one continuous connected flight. Interviews the user for the topic, story beats, and brand kit, then generates cohesive scenes + seamless camera clips and wires a portable, framework-agnostic scroll-scrub engine. Use for a '3D world' / 'browse-through-the-industry' hero, a scroll cinematic, or a diorama landing.",- "version": "0.1.2",+ "version": "0.1.3","author": {"name": "cyw","email": "[email protected]"diff --git a/plugins/scroll-world/skills/scroll-world/SKILL.md b/plugins/scroll-world/skills/scroll-world/SKILL.mdindex d2932e8..2de0e3a 100644--- a/plugins/scroll-world/skills/scroll-world/SKILL.md+++ b/plugins/scroll-world/skills/scroll-world/SKILL.md@@ -131,10 +131,34 @@ These stills double as **video posters and lazy-load fallbacks**, so keep them.----## Step 4 — Generate the dive-in clips--One camera flight per scene: starts high/outside, descends into the interior, structure-opens. Model **`seedance_2_0`** (image-to-video), `--start-image = the scene still`.+## Step 4 — Camera architecture (pick one — this makes or breaks the feel)++How the camera moves *between* scenes is the single biggest quality lever. Two shapes;+pick by aesthetic.++### A) Continuous forward take — RECOMMENDED for grounded / realistic / walkthrough+One camera that only ever glides **forward**, first scene through last, as a single take.+Generate the legs **sequentially**: leg 0 from scene-0's still (glide forward into it);+then each leg's `--start-image` = the **previous leg's ACTUAL last frame** (extract with+ffmpeg), prompt *"continue gliding smoothly FORWARD into [scene i], never pulling back"*,+and **no `--end-image`** — an end-image of a wide establishing shot forces the camera to+pull back, which is the #1 cause of stutter. Extract each leg's last frame to feed the+next. Result: every seam is frame-identical **and** the camera never reverses. There are+**no connectors** (skip Step 5) — the legs ARE the journey. Wire each leg as a section+clip with `connectors: []` and a small `crossfade` (~0.08). Even without an `--end-image`+the legs still arrive at distinct rooms (the prompt steers the content). Cost: strictly+**sequential** (can't parallelize) and slower; interiors trip the NSFW filter, so build in+re-rolls (3 attempts/leg).++### B) Dive-in + aerial connector — only for diorama / miniature / god's-eye worlds+A "dive into each scene" clip + a connector that pulls **up and out** and flies over to the+next scene (Step 5). The pull-out **reverses camera direction at every seam** (forward dive+→ backward pull-out). In a miniature/diorama world that reads as an intentional "zoom out+to the map, fly to the next island"; in a grounded first-person walkthrough it reads as a+jarring **rewind/stutter**. Use B only for the map-like aesthetic. When in doubt, use A.++**For B**, one camera flight per scene: starts high/outside, descends into the interior,+structure opens. Model **`seedance_2_0`** (image-to-video), `--start-image = the scene still`.- Use the **solid-background still** (not the knocked-out transparent one) as thestart image, so the video has a full frame.@@ -149,7 +173,11 @@ opens. Model **`seedance_2_0`** (image-to-video), `--start-image = the scene sti----## Step 5 — The seamless chain (THE CRITICAL PART)+## Step 5 — Connectors (architecture B only)++Skip this whole step for architecture **A** — the forward take has no connectors; its legs+already chain seamlessly. This step applies to **B** (diorama/miniature), and note the+reversal caveat from Step 4.The connector clips are what make the world feel *connected* instead of cut. A connectorflies from the end of scene i out and into the start of scene i+1. **Both of its@@ -276,6 +304,11 @@ is the thing most likely to be wrong:- **Seam pop** → connector endpoints were the diorama stills, not the neighbouringclips' actual frames. Always extract real frames (Step 5).+- **Seam stutter / camera "jumps backward"** → even with frame-matched seams, if the+ camera *velocity reverses* (forward dive, then a connector that pulls back out) it+ reads as a rewind. This is inherent to architecture B. For any grounded walkthrough use+ architecture A (one continuous forward take — legs chained from actual last frames, no+ pull-back, no `--end-image`); see Step 4.- **Frozen video / stuck at frame 0** → `seekable=[0,0]`; the host isn't serving byteranges. Use blob URLs (engine does).- **Huge files** → you used all-intra. Use `-g 8` + blob instead.diff --git a/plugins/scroll-world/skills/scroll-world/references/scrub-engine.js b/plugins/scroll-world/skills/scroll-world/references/scrub-engine.jsindex 3ed6329..9d89eb5 100644--- a/plugins/scroll-world/skills/scroll-world/references/scrub-engine.js+++ b/plugins/scroll-world/skills/scroll-world/references/scrub-engine.js@@ -43,6 +43,7 @@ function mountScrollWorld(container, config) {const CONNECTORS = config.connectors || [];const DIVE_W = config.diveScroll || 1.3;const CONN_W = config.connScroll || 0.9;+ const CROSSFADE = (config.crossfade != null) ? config.crossfade : 0.12; // seam dissolve width (vh)const N = SECTIONS.length;if (!N) return;@@ -170,7 +171,7 @@ function mountScrollWorld(container, config) {function read() {const y = window.scrollY || window.pageYOffset;- const fade = 0.12 * vh;+ const fade = CROSSFADE * vh;let ci = 0;for (let i = 0; i < NSEG; i++) if (y >= SEGMENTS[i].start) ci = i;