Drifting Air: Fireflies, Petals, Snow, Embers & Ambient Particles
- Author
- claude-code @ auraAgent
- Opened
- Nov 15, 2026
- From
- contrib-756mgp6x
- Into
- main
- Merged
- Nov 15, 2026
Found in Tsukimichi (fields 200 m from origin, heavily loaded machine), each verified with captures:
-
Following fields (follow=true: petals, dust, pollen, snow, ash, drizzle, leaves) were invisible once the camera was more than ~one box from the entity the field played on (by default a new entity at the origin). The solver's particles stand where they were born, under that entity, and the renderer culls them by where they stand; the shader moves them to the camera, but the cull had already dropped them. Fix (api.module): a following field now plays on a local anchor of its own that is kept on the camera in whole-box steps (the shader wraps by the box, so a whole-box step moves nothing on screen); centerY is re-sent only when the anchor steps vertically. follow is now a restart key (the play root changes). A user root is no longer the play root of a following field.
-
Fields started empty and took a whole lifetime (10-30 s) to fill when the first cook was slow: on a realTime timeline the solver begins at the graph time it is first asked for, so the single burst at time 0 was already in the past. Fix (parts/field): the burst is repeated through the first two minutes (every 0.5 s to 20 s, then every 2 s to 120 s) with capacity lowered to count*1.1+16, so the first burst after the solver begins fills the field and later ones only top up to capacity. (Solver prewarm via the 'start' param was tried: the call form does not accept it, and g:node + start broke on play inputs during the prewarm; noted for the engine.)
-
A large area thinned the field: counts were per style regardless of area, so a 60x50 m firefly field was a third as dense as the default 30x30. styles.countFor scales the tier count by area relative to the style's default area (x1..x4); api and get() use it.
Verified: Tsukimichi terrace night shot (fireflies 200,80,0, 60x50) reads clearly; blue-tinted follow petals render around a camera at (199,92,1); all 14 styles render at (440..960, 200, 400).
Source world: 0bbc8411-afec-4d1a-bc4e-2abc93d45863 Contributed paths:
- ambientDrift.package/airDrift.effect/parts/field.procGraph/graph.json
- ambientDrift.package/airDrift.effect/parts/field.procGraph/init.luau
- ambientDrift.package/api.module/init.luau
- ambientDrift.package/package.yaml
- ambientDrift.package/styles.module/init.luau
- ambientDrift.package
- ambientDrift.package/airDrift.effect
- ambientDrift.package/airDrift.effect/parts/field.procGraph
- ambientDrift.package/api.module
- ambientDrift.package/styles.module
- ambientDrift.package/Drift.component/init.luau
- ambientDrift.package/airDrift.effect/graphs/ash.procGraph/graph.json
- ambientDrift.package/airDrift.effect/graphs/autumnLeaves.procGraph/graph.json
- ambientDrift.package/airDrift.effect/graphs/cherryPetals.procGraph/graph.json
- ambientDrift.package/airDrift.effect/graphs/drizzle.procGraph/graph.json
- ambientDrift.package/airDrift.effect/graphs/dustMotes.procGraph/graph.json
- ambientDrift.package/airDrift.effect/graphs/embers.procGraph/graph.json
- ambientDrift.package/airDrift.effect/graphs/fireflies.procGraph/graph.json
- ambientDrift.package/airDrift.effect/graphs/glowSpores.procGraph/graph.json
- ambientDrift.package/airDrift.effect/graphs/lanternSparks.procGraph/graph.json
- ambientDrift.package/airDrift.effect/graphs/mistWisps.procGraph/graph.json
- ambientDrift.package/airDrift.effect/graphs/pollen.procGraph/graph.json
- ambientDrift.package/airDrift.effect/graphs/snow.procGraph/graph.json
- ambientDrift.package/airDrift.effect/graphs/sparkles.procGraph/graph.json
- ambientDrift.package/airDrift.effect/graphs/waterSpray.procGraph/graph.json
10 files changed
- ChangedambientDrift.packageFolderBeforeAfter
- ChangedambientDrift.package/airDrift.effectFolderBeforeAfter
- ChangedambientDrift.package/airDrift.effect/parts/field.procGraphFolderBeforeAfter
- ChangedambientDrift.package/airDrift.effect/parts/field.procGraph/graph.json44.0 KB → 73.8 KBBeforeAfter
- ChangedambientDrift.package/airDrift.effect/parts/field.procGraph/init.luau10.8 KB → 11.5 KBBeforeAfter
- ChangedambientDrift.package/api.moduleFolderBeforeAfter
- ChangedambientDrift.package/api.module/init.luau15.3 KB → 17.8 KBBeforeAfter
- ChangedambientDrift.package/package.yaml1.1 KB → 1.1 KBBeforeAfter
- ChangedambientDrift.package/styles.moduleFolderBeforeAfter
- ChangedambientDrift.package/styles.module/init.luau5.0 KB → 5.7 KBBeforeAfter
Checks
No checks have been posted.
Reviews
No reviews yet.
Conversation
No comments yet.
Sign in to comment or review.