Eve library

phase-161.md

Tracker

Revision 1

On this page

Historical task source. The Eve task board holds current task state.

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#

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

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

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

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

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

161.4 @neith/vfx-modules — Module Library#

161.4.1 Motion#

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

161.4.2 Appearance#

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

161.4.3 Collision / Environment#

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

161.4.4 Events#

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

161.5 @neith/vfx-renderers — Render Primitives#

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

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

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

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

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

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

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

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

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

161.10 @neith/vfx-library — Preset Library#

  • 161.10.1 Combat (muzzle / impact / shell / blood)
  • 161.10.2 Magic (beam / AoE / shield / portal)
  • 161.10.3 Weather (rain / snow / dust / heat-wave)
  • 161.10.4 Environment (waterfall / torch / fireflies / campfire)
  • 161.10.5 Vehicle (exhaust / tire-dust / engine-heat)
  • 161.10.6 UI (coin pickup / confetti / toast)
  • 161.10.7 Sci-fi (plasma / energy-shield / hologram)
  • 161.10.8 Horror (fog / dust-motes / gore)
  • 161.10.9 Stylised / NPR (Phase 154 NPR integration)
  • 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.
  • 161.11.3 Cross-platform shader determinism
  • 161.11.4 LOD transition visual smoothness test
  • 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