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
.uassetfixture 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.uassetbinary 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 multigpupartitions 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