Back to Unity Mcp

manage_vfx

website/docs/reference/tools/vfx/manage_vfx.md

9.7.11.4 KB
Original Source

manage_vfx

Auto-generated from the Python tool registry. Do not hand-edit outside <!-- examples:start --><!-- examples:end --> blocks — the generator (tools/generate_docs_reference.py) will overwrite them.

Group: vfx  ·  Module: services.tools.manage_vfx

Description

Manage Unity VFX components (ParticleSystem, VisualEffect, LineRenderer, TrailRenderer). Action prefixes: particle_, vfx_, line_, trail_. Action-specific parameters go in properties (keys match ManageVFX.cs).

Parameters

NameTypeRequiredDescription
actionstryesAction to perform (prefix: particle_, vfx_, line_, trail_).
targetstr | NoneTarget GameObject (name/path/id).
search_methodLiteral['by_id', 'by_name', 'by_path', 'by_tag', 'by_layer'] | NoneHow to find the target GameObject.
propertiesdict[str, Any] | str | NoneAction-specific parameters (dict or JSON string).
component_indexint | NoneZero-based index to select which component when multiple of the same type exist (e.g., multiple ParticleSystems). If omitted, targets the first instance.

Returns

A dict containing the Unity response. The exact shape depends on the action.

Examples

<!-- examples:start -->

No examples yet. Add usage examples here — they will be preserved across regenerations.

<!-- examples:end -->