Log inGet started
World

Drifting Air: Fireflies, Petals, Snow, Embers & Ambient Particles

Merged

ambientDrift 1.0.3: fields render anywhere (follow culling, empty start, area-scaled count)

#1
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:

  1. 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.

  2. 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.)

  3. 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.