particle-system-modify

Modifies ParticleSystem component modules on Unity GameObjects via the unity-mcp-cli tool.

1|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/Fermisloth/Project-Aegis-Adaptive-Outbreak-Containment --skill particle-system-modify-fermisloth
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: particle-system-modify
Source: https://github.com/Fermisloth/Project-Aegis-Adaptive-Outbreak-Containment/tree/main/.agent/skills/particle-system-modify
Command: npx skills add https://github.com/Fermisloth/Project-Aegis-Adaptive-Outbreak-Containment --skill particle-system-modify-fermisloth

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires unity-mcp-cli.

What problem does it solve? Editing Unity ParticleSystem components requires navigating dozens of modules and properties in the editor, which is slow and error-prone when done manually or through AI-assisted workflows. This Skill lets you programmatically modify any ParticleSystem module on a GameObject with a single structured command. ## Core Features & Use Cases - Selective Module Updates: Modify only the modules you specify (main, emission, shape, noise, trails, renderer, and 20+ others) without touching the rest of the component. - Flexible Targeting: Reference the target GameObject by instanceID, hierarchy path, name, or asset reference, and optionally select a specific ParticleSystem when multiple exist. - Structured Response: Returns success status, component references, and a log of modifications and warnings for verification. - Use Case: While building a VFX effect, adjust the emission rate and color-over-lifetime gradient of a particle effect in the active scene without opening the Unity Inspector. ## Quick Start Ask the AI to modify the emission rate and start color of the ParticleSystem on the GameObject named 'SmokeEffect' using the particle-system-modify tool.

Frequently Asked Questions about particle-system-modify

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I modify a ParticleSystem in Unity from the command line?

Run unity-mcp-cli run-tool particle-system-modify with a JSON input containing a gameObjectRef and the modules to change. Only the modules and properties you include are updated; everything else stays unchanged.

How do I target a specific GameObject for particle system changes?

Provide a gameObjectRef with an instanceID, hierarchy path, name, assetPath, or assetGuid. InstanceID has the highest priority, followed by path and name, letting you target objects in the active scene or an open prefab.

Can I modify a ParticleSystem when a GameObject has multiple ones?

Yes, pass a componentRef with a component index, type name, or instanceID to select a specific ParticleSystem. If omitted, the tool modifies the first ParticleSystem found on the GameObject.

Which ParticleSystem modules can be modified with this tool?

All standard modules are supported, including main, emission, shape, velocityOverLifetime, colorOverLifetime, sizeOverLifetime, noise, collision, subEmitters, textureSheetAnimation, lights, trails, customData, and renderer.

Why is unity-mcp-cli not found when running the command?

The CLI is not installed globally. Install it with npm install -g unity-mcp-cli or prefix commands with npx unity-mcp-cli, and check the unity-initial-setup skill for full installation instructions.