Niagara Systems

🧠 Brains complement: IF an unreal-engine-skills-manager tool (external MCP) exists in this session, call it with {action: "load", skill: "niagara-vfx"} for UE domain knowledge on this topic — correct APIs, architecture, best practices — and treat it as the rubric for any review / "best practices" question. If no such tool is available (e.g. running under Claude Code or Codex without that MCP), skip this line entirely and proceed with this skill alone — do NOT attempt the call.

Niagara Systems Skill

Architecture (read first): VibeUE extends Unreal's native MCP endpoint. System / emitter / parameter create / add / copy / remove / list / compile are owned by the engine toolset NiagaraToolsets.NiagaraToolset_System (plus …_Assets, …_Component, …_Blueprint, …_Info), called through call_tool. VibeUE's NiagaraService was trimmed to the rapid-iteration-parameter tuning + diagnostics that the engine toolset does not cover, and NiagaraScratchPadService (Custom-HLSL graph authoring) which is unique to VibeUE.

VibeUE NiagaraService (this skill) keeps ONLY:

• Rapid-iteration parameter read/write — list_rapid_iteration_params, set_rapid_iteration_param, set_rapid_iteration_param_by_stage
• Diagnostics — compare_systems, get_emitter_lifecycle, debug_activation

For system/emitter/parameter CRUD and compile → engine NiagaraToolsets.* via call_tool. For emitter color/curve authoring → load niagara-emitters. For scratch-pad module graphs (Custom HLSL, Map Get/Set, Op, typed pins, wiring) → NiagaraScratchPadService — also documented in the niagara-emitters skill.

Loading skills

Skills load through the engine's AgentSkillToolset (ListSkills / GetSkills) — there is no vibeue-skills-manager tool. The workhorse for all VibeUE services is execute_python_code (call unreal.<Service>.<method>() plus the full unreal.* Python API). Engine toolsets are reached with call_tool (discover them with list_toolsets / describe_toolset).

⚠️ System / emitter / parameter CRUD → engine NiagaraToolsets

🛑 CRASH RISK — Niagara user-parameter ops (issue #464). The engine NiagaraToolset_System.AddUserVariables tool (the "add user parameter" path) can trigger a fatal engine assertion (NiagaraVariant.cpp:108 InCount > 0) that hard-crashes the editor — it builds an FNiagaraVariant with a zero-byte payload when the variable's type/default yields no value bytes. Do NOT add Niagara user parameters via this tool until #464 is fixed. Worse: a system left half-modified by a failed AddUserVariables is corrupted, and subsequent read ops on it (GetUserVariables, GetSystemCompileState, GetEmitterTopology, GetEmitterSummary, …) then crash with an array-index-out-of-bounds. If a user parameter is truly required, supply a concrete non-empty default for the exact type and verify the system still reads back before doing anything else. For scratch-module work, prefer the crash-safe NiagaraScratchPadService (validated solid in the sweep).

Also note (issue #557): AddUserVariables returns null even on success — a null result is not a failure signal. Always verify the write landed with GetUserVariables afterwards.

Creating a system, adding/copying/removing emitters, adding user parameters, listing emitters, compiling — these moved to the engine. Discover and call them like this:

# Discover the engine Niagara toolsets and their exact tool names + schemas:
#   list_toolsets()
#   describe_toolset("NiagaraToolsets.NiagaraToolset_System")
#   describe_toolset("NiagaraToolsets.NiagaraToolset_Assets")
#
# Then invoke a tool, e.g. create a system / add an emitter / add a user parameter:
#   call_tool(toolset_name="NiagaraToolsets.NiagaraToolset_System",
#             tool_name="<tool from describe_toolset>",
#             arguments={ ... })

Always inspect existing systems before creating a new one (use the engine …_Info / …_Assets toolset to search/summarize), and ask the user before duplicating an effect as a template.

⚠️ Parameter Discovery Order (rapid-iteration tuning)

When tuning a parameter (e.g., color), VibeUE's NiagaraService covers the rapid-iteration parameters on emitter scripts. User-exposed (User.*) and system-script (System.*) parameters are read/written through the engine NiagaraToolsets parameter tools.

1. User Parameters (User.Color, User.SpawnRate) → engine NiagaraToolsets
2. System Script Settings (System.Color, SystemSpawn/Update) → engine NiagaraToolsets
3. Emitter Script Settings (per-emitter rapid-iteration params) → VibeUE NiagaraService below

import unreal

path = "/Game/VFX/NS_TeslaCoil"

# Emitter rapid-iteration params (VibeUE):
params = unreal.NiagaraService.list_rapid_iteration_params(path, "Sparks")
for p in params:
    print(f"[{p.script_type}] {p.parameter_name}: {p.value}")