## Phase 161: Neith Niagara-Class GPU VFX Authoring Editor — Unreal Niagara / Unity VFX Graph / PopcornFX / Houdini COPs-to-Game / EmberGen Runtime Parity

Closes the authoring-side VFX gap. Phase 42.2.7 ships fluid particle runtime.
Phase 157 ships DCC-quality Mantaflow-class simulation. Phase 40 lists
volumetrics briefly. None of these deliver a **gameplay VFX authoring editor** —
the Niagara / VFX-Graph class tool that artists use to build gameplay effects
(explosions, beams, attacks, weather, UI-coupled FX, signal visualisation) that
live inside the game runtime with GPU particle counts in the millions.

Sovereign replacement for Unreal Niagara (emitters, modules, data interfaces,
renderers, simulation stages, budget / LOD), Unity VFX Graph (HDRP particle
authoring), PopcornFX, CryEngine Particle Editor, Godot GPUParticles3D
authoring, EmberGen-integrated runtime effect exports, and Houdini
COPs-as-runtime pipelines.

---

### 161.1 @neith/vfx-core — Effect Asset Model

- [x] **161.1.1** Effect asset (system) container
- [x] **161.1.2** Emitter sub-asset (multiple per system)
- [x] **161.1.3** Module stack per emitter (init / update / render / spawn /
      event)
- [x] **161.1.4** Per-system user-parameter surface
- [x] **161.1.5** System scripting with node graph
- [x] **161.1.6** Graph-compile to GPU shader + CPU script
- [x] **161.1.7** Hot-reload on save
- [x] **161.1.8** Dependency tracking with stale marker
- [x] **161.1.9** Versioned effect asset schema
- [x] **161.1.10** Asset thumbnail auto-bake
- [x] **161.1.11** Nested effect (sub-system inside system)
- [x] **161.1.12** Time-based events + triggers
- [x] **161.1.13** Parameter binding from gameplay blackboard
- [x] **161.1.14** Material / mesh / SDF asset references
- [x] **161.1.15** Author-time sample data (test playback)

---

### 161.2 @neith/vfx-spawn — Spawn Rules & Emission

- [x] **161.2.1** Burst spawn (count + delay)
- [x] **161.2.2** Rate-based spawn
- [x] **161.2.3** Volume / shape emitter (sphere / box / cone / torus / cylinder
      / mesh)
- [x] **161.2.4** Skeletal mesh emitter (from bones / socket)
- [x] **161.2.5** Decal / surface emitter
- [x] **161.2.6** Beam / ribbon path emitter
- [x] **161.2.7** Curve-path emitter
- [x] **161.2.8** GPU-readback-driven (fluid → particle) emitter
- [x] **161.2.9** Rate-from-gameplay-stat binding
- [x] **161.2.10** Inheritance of parent-emitter velocity / colour
- [x] **161.2.11** Event-driven spawn (collision, death, trigger)
- [x] **161.2.12** Seeded random streams
- [x] **161.2.13** Spawn budget per system / per scene
- [x] **161.2.14** Spawn cooldown / throttle
- [x] **161.2.15** Spawn mask (never-spawn-inside-obstacle)

---

### 161.3 @neith/vfx-attribute — Particle Attribute System

- [x] **161.3.1** Built-in attrs (position / velocity / rotation / size /
      lifetime / colour / uv / id)
- [x] **161.3.2** User-defined attrs (struct of floats / vec / int / bool)
- [x] **161.3.3** Per-attr default + random range
- [x] **161.3.4** Attr read / write in modules
- [x] **161.3.5** Attr export to render pass (GBuffer-like layout)
- [x] **161.3.6** Persistent-across-frame storage
- [x] **161.3.7** Structure-of-arrays GPU layout
- [x] **161.3.8** Attr compression (half / bytes) option
- [x] **161.3.9** Attr graph inspector (runtime debug)
- [x] **161.3.10** Attr binding to material parameter

---

### 161.4 @neith/vfx-modules — Module Library

#### 161.4.1 Motion

- [x] **161.4.1.1** Gravity / acceleration
- [x] **161.4.1.2** Wind / air-drag
- [x] **161.4.1.3** Attract / repel point / line / volume
- [x] **161.4.1.4** Orbit / curl noise
- [x] **161.4.1.5** Follow curve
- [x] **161.4.1.6** Follow SDF
- [x] **161.4.1.7** Velocity-cone random
- [x] **161.4.1.8** Rotation-velocity
- [x] **161.4.1.9** Point-cloud snap
- [x] **161.4.1.10** Boid / flock rule set

#### 161.4.2 Appearance

- [x] **161.4.2.1** Colour-over-life gradient
- [x] **161.4.2.2** Size-over-life curve
- [x] **161.4.2.3** Rotation / alpha over life
- [x] **161.4.2.4** UV-flip / sub-image animation
- [x] **161.4.2.5** Noise colour jitter
- [x] **161.4.2.6** Emissive intensity curve
- [x] **161.4.2.7** Light group membership
- [x] **161.4.2.8** Ambient-colour modulation
- [x] **161.4.2.9** Triplanar texture sample
- [x] **161.4.2.10** HDR bloom-feed clamp

#### 161.4.3 Collision / Environment

- [x] **161.4.3.1** Collide with world (depth buffer / SDF)
- [x] **161.4.3.2** Collide with physics scene
- [x] **161.4.3.3** Bounce / friction / stick behaviour
- [x] **161.4.3.4** Kill on collision
- [x] **161.4.3.5** Stick-to-surface with orient
- [x] **161.4.3.6** Volume boundary kill / wrap
- [x] **161.4.3.7** Emit sound on hit (Phase 167)
- [x] **161.4.3.8** Decal spawn on hit
- [x] **161.4.3.9** Heat / cold temperature field
- [x] **161.4.3.10** Gameplay-layer filter

#### 161.4.4 Events

- [x] **161.4.4.1** Emit event on death
- [x] **161.4.4.2** Emit event on milestone (age, speed)
- [x] **161.4.4.3** Event receiver (spawn sub-emitter)
- [x] **161.4.4.4** Event chain limit
- [x] **161.4.4.5** Gameplay-event bridge (cast to BP / C++)
- [x] **161.4.4.6** Timer / cron-like scheduler
- [x] **161.4.4.7** Attribute-change event
- [x] **161.4.4.8** Collision event
- [x] **161.4.4.9** OOB / OOF event
- [x] **161.4.4.10** User-custom event

---

### 161.5 @neith/vfx-renderers — Render Primitives

- [x] **161.5.1** Sprite (billboard / orient-velocity / orient-custom)
- [x] **161.5.2** Mesh instance renderer
- [x] **161.5.3** Ribbon renderer (constant / tapered / UV-stretch)
- [x] **161.5.4** Beam renderer with noise offset
- [x] **161.5.5** Light renderer (per-particle point / spot)
- [x] **161.5.6** Decal renderer (project to geometry)
- [x] **161.5.7** Volume renderer (slice or ray march)
- [x] **161.5.8** SDF-metaball renderer (marching cubes at runtime)
- [x] **161.5.9** Hair / strand renderer (Phase 155 integration)
- [x] **161.5.10** 2D UI renderer (HUD-sprite bridged to UMG / UI Toolkit)

---

### 161.6 @neith/vfx-sim — Simulation Stages (Advanced)

- [x] **161.6.1** Multi-stage dispatch (preprocess / update / postprocess)
- [x] **161.6.2** Compute shader custom stage
- [x] **161.6.3** Grid / fluid emitter (light-weight runtime GPU fluid)
- [x] **161.6.4** SDF-generation stage (per-frame dynamic SDF)
- [x] **161.6.5** Neighbour-query stage (hash grid)
- [x] **161.6.6** Sort stage (by depth / attribute)
- [x] **161.6.7** Reduce / scan stage
- [x] **161.6.8** Indirect-dispatch stage
- [x] **161.6.9** Double-buffer ping-pong
- [x] **161.6.10** ML inference stage (call Phase 47 model at runtime)

---

### 161.7 @neith/vfx-data-interfaces — External Data Plug-Ins

- [x] **161.7.1** Mesh query (sample position / normal / uv)
- [x] **161.7.2** Skeletal-mesh socket / bone data
- [x] **161.7.3** SDF volume sample
- [x] **161.7.4** Texture sample (including 3D / RT)
- [x] **161.7.5** Camera data (position / direction / focal)
- [x] **161.7.6** Physics scene query
- [x] **161.7.7** Navigation mesh sample
- [x] **161.7.8** Audio FFT / loudness input
- [x] **161.7.9** Music-beat (Phase 133 link) input
- [x] **161.7.10** Gameplay blackboard binding
- [x] **161.7.11** Weather / environment data
- [x] **161.7.12** Render-target read-back
- [x] **161.7.13** Depth / normal / velocity buffer
- [x] **161.7.14** GPU curve / LUT asset
- [x] **161.7.15** Neural-network inference interface

---

### 161.8 @neith/vfx-editor — Authoring Editor UI

- [x] **161.8.1** Node-graph editor (drag / drop modules)
- [x] **161.8.2** Per-module property panel
- [x] **161.8.3** Timeline with key-frameable params
- [x] **161.8.4** Preview viewport with play / pause / scrub
- [x] **161.8.5** Real-time recompile on edit
- [x] **161.8.6** Debug HUD (counts, cost, memory)
- [x] **161.8.7** Breakpoint on attribute
- [x] **161.8.8** Particle inspector (click on particle → see attrs)
- [x] **161.8.9** Overlay (velocity / collision / normals)
- [x] **161.8.10** Spawn budget meter
- [x] **161.8.11** Save / load preset
- [x] **161.8.12** Template starter effects (explosion / beam / weather)
- [x] **161.8.13** Asset browser with tag-filter
- [x] **161.8.14** Undo / redo history
- [x] **161.8.15** Collaborative editing multi-user (Phase 139)

---

### 161.9 @neith/vfx-perf — Performance, LOD & Budgeting

- [x] **161.9.1** Per-system LOD curve (distance / budget-based)
- [x] **161.9.2** Dynamic culling with camera frustum
- [x] **161.9.3** Global effect budget (GPU ms / VRAM)
- [x] **161.9.4** Priority per effect (hero / ambient / low)
- [x] **161.9.5** Pooling and recycling
- [x] **161.9.6** Warm-up (pre-compile shaders / pre-fill particles)
- [x] **161.9.7** Async compute graph hooks
- [x] **161.9.8** Multi-GPU distribution
- [x] **161.9.9** Platform-specific LOD profile (mobile / console / PC)
- [x] **161.9.10** Auto-disable behind wall / off-screen

---

### 161.10 @neith/vfx-library — Preset Library

- [x] **161.10.1** Combat (muzzle / impact / shell / blood)
- [x] **161.10.2** Magic (beam / AoE / shield / portal)
- [x] **161.10.3** Weather (rain / snow / dust / heat-wave)
- [x] **161.10.4** Environment (waterfall / torch / fireflies / campfire)
- [x] **161.10.5** Vehicle (exhaust / tire-dust / engine-heat)
- [x] **161.10.6** UI (coin pickup / confetti / toast)
- [x] **161.10.7** Sci-fi (plasma / energy-shield / hologram)
- [x] **161.10.8** Horror (fog / dust-motes / gore)
- [x] **161.10.9** Stylised / NPR (Phase 154 NPR integration)
- [x] **161.10.10** Educational / training (beam / arrow / highlight)

---

### 161.11 Testing & Validation

- [ ] **161.11.1** 1M-particle stress scene at 60 FPS: the real 1M stack runs
      via `nx run @neith/vfx-testing:stress-1m` (CPU reference measured 21.9
      ms/frame on 2026-07-15). (Blocker made visible 2026-09-18: the 60 FPS GPU
      acceptance was said to need a physical-GPU capture — the Mac's GPU is a
      physical GPU.) Capture the GPU frame time on the Mac (Metal, via timestamp
      queries). Verify: the stress-1m GPU run on the Mac records ≤ 16.6
      ms/frame, or the achieved time is recorded as the baseline with a
      regression guard if 60 FPS is not reached on the Air-class GPU.
- [ ] **161.11.2** 5M-particle hero demo at 30 FPS: run
      `nx run @neith/vfx-testing:stress-5m` (CPU reference 106.6 ms/frame) and
      capture the GPU frame time on the Mac (Metal). Verify: the GPU run records
      ≤ 33.3 ms/frame, or the achieved time is recorded as the baseline with a
      regression guard.
- [x] **161.11.3** Cross-platform shader determinism
- [x] **161.11.4** LOD transition visual smoothness test
- [x] **161.11.5** Budget cap enforcement test
- [ ] **161.11.6** Niagara effect-file import compatibility (optional): UE 5.5
      is on the executing machine, so a paired Niagara `.uasset` fixture is
      producible. Export a simple Niagara system from UE 5.5, parse its
      serialized graph, and map it to the neith VFX graph, comparing the
      imported effect against the source. (Blocker made visible 2026-09-18: the
      prior HTML comment said this needs a redistributable paired fixture — UE
      5.5 provides one.) Verify: a spec imports the fixture and asserts the
      emitter/module structure matches the source; note that the `.uasset`
      binary layout is undocumented, so record the format assumptions made.
- [ ] **161.11.7** VFX-Graph file import compatibility (optional). Producing and
      validating a Unity VFX Graph fixture needs the Unity editor, which is not
      available in this environment (Unity is not on the fleet, unlike UE 5.5)
      (stated 2026-09-18). `blocked:external`
- [ ] **161.11.8** Multi-GPU distribution soak — `@neith/vfx-perf multigpu`
      partitions the load and the typed gate rejects evidence with fewer than
      two physical adapters. This host exposes one Virtio DRM adapter; a
      multi-GPU soak needs two or more physical GPUs, which the fleet lacks
      (stated 2026-09-18). `blocked:hardware`
- [ ] **161.11.9** Dogfood: a Phase 42 game demo embedding this VFX runtime
      runs. (Blocker made visible 2026-09-18: no runnable Phase-42 demo
      embedding the runtime exists in the checkout.) Build a minimal Maya-engine
      (Phase 42) scene that instantiates the VFX runtime and drives at least one
      effect, run it headless for N frames. Verify: the demo runs the effect for
      N frames with zero runtime errors and the typed gate accepts the build
      revision and frame evidence.
- [ ] **161.11.10** Artist usability study (Phase 27 Obsidian crew) — the typed
      gate requires ≥ 3 unique completed artist sessions. Phase 27 was
      reclassified as a proposal on 2026-09-18; there is no Obsidian artist
      crew, so this gate needs a different dogfood subject or withdrawal (owner
      decision), and the study itself needs human participants.
      `blocked:governance`
