# Sistemas de partículas con IA en Unity: la extensión ParticleSystem — AI Game Dev

Los agentes de IA leen y modifican los 24 módulos de ParticleSystem en Unity. Crea fuego, humo, magia y más con prompts en lenguaje natural.

Esta página se tradujo automáticamente del inglés. [Lee el original en inglés](https://ai-game.dev/blog/unity-ai-particle-system-extension).

[Blog](https://ai-game.dev/es/blog)

Los agentes de IA leen y modifican los 24 módulos de ParticleSystem en Unity. Crea fuego, humo, magia y más con prompts en lenguaje natural.

Ivan Murzak · 24 de marzo de 2026 · 4 min de lectura ·

**Actualizado el 17 de octubre de 2026.** Desde Unity-MCP 1.0.0, esta extensión es un módulo RQL en lugar de las dos herramientas MCP que se describen a continuación: el agente lee y edita los 24 módulos de ParticleSystem mediante rql-query y rql-mutate. Los prompts de esta publicación funcionan igual que antes. Detalles actuales: ai-game.dev/docs/extensions/unity/particles y ai-game.dev/docs/rql.

El ParticleSystem de Unity es uno de los componentes más potentes, y también más complejos, del motor. Con 24 módulos independientes, cientos de parámetros y ajustes profundamente anidados, configurar un efecto de partículas a mano supone hacer clic en infinidad de paneles del inspector. ¿Y si pudieras simplemente decirle a una IA «crea partículas de fuego que pasen de naranja a transparente» y tenerlo listo en segundos? Eso es exactamente lo que permite la extensión Unity-AI-ParticleSystem.

Partículas de fuego creadas y configuradas por IA con la extensión ParticleSystem

## ¿Qué es Unity-AI-ParticleSystem?

Unity-AI-ParticleSystem es una extensión de AI Game Developer que añade dos herramientas MCP —particle-system-get y particle-system-modify— y ofrece a los agentes de IA acceso completo de lectura y escritura a cada módulo de ParticleSystem de tu proyecto de Unity. Funciona con cualquier cliente de IA compatible con MCP: Claude Code, VS Code Copilot, Cursor, Windsurf y más.

## Dos herramientas, cobertura total

La extensión expone solo dos herramientas MCP, pero lo cubren todo. La herramienta get lee el estado actual de cualquier ParticleSystem, y la herramienta modify aplica actualizaciones parciales: solo cambia las propiedades que especifiques y deja todo lo demás intacto.

### particle-system-get

Recupera el estado completo de un ParticleSystem, incluido el estado de reproducción (isPlaying, isPaused, particleCount) y cualquier combinación de sus 24 módulos. Puedes solicitar módulos individuales o usar el flag includeAll para obtenerlo todo a la vez. El modo de serialización profunda expande de forma recursiva los objetos anidados para una inspección completa.

JSON Llamada a herramienta MCP

```json
{
  "tool": "particle-system-get",
  "input": {
    "gameObjectRef": { "path": "/Effects/Fire" },
    "includeMain": true,
    "includeEmission": true,
    "includeColorOverLifetime": true
  }
}
```

### particle-system-modify

Aplica actualizaciones parciales a cualquier módulo. Solo se modifican las propiedades que incluyas en la solicitud; todo lo demás queda tal cual. La herramienta devuelve registros detallados de la modificación para que la IA sepa exactamente qué se ha actualizado.

JSON Llamada a herramienta MCP

```json
{
  "tool": "particle-system-modify",
  "input": {
    "gameObjectRef": { "path": "/Effects/Fire" },
    "main": [
      { "memberPath": "duration", "value": 5.0 },
      { "memberPath": "startLifetime.constant", "value": 2.0 },
      { "memberPath": "loop", "value": true }
    ],
    "emission": [
      { "memberPath": "rateOverTime.constant", "value": 50 }
    ]
  }
}
```

## Los 24 módulos compatibles

La extensión cubre todos y cada uno de los módulos de ParticleSystem disponibles en Unity. La IA puede leer y modificar cualquiera de ellos:

- Main — duración, vida inicial, velocidad inicial, tamaño inicial, color inicial, gravedad, espacio de simulación, bucle
- Emission — tasa por tiempo, tasa por distancia, ráfagas
- Shape — tipo de forma, radio, ángulo, arco, posición, rotación, escala
- Velocity Over Lifetime — curvas de velocidad lineal y orbital
- Limit Velocity Over Lifetime — límites de velocidad y amortiguación
- Color Over Lifetime — animación de color basada en degradados
- Color By Speed — color asignado a la velocidad de la partícula
- Size Over Lifetime — curvas de tamaño a lo largo de la vida de la partícula
- Size By Speed — tamaño asignado a la velocidad de la partícula
- Rotation Over Lifetime — curvas de velocidad angular
- Noise — campos de turbulencia y ruido Perlin
- Collision — ajustes de colisión con el mundo y con planos
- Trails — renderizado de estelas de partículas
- Renderer — material, malla, modo de renderizado, ordenación
- Además: Force Over Lifetime, External Forces, Inherit Velocity, Lifetime By Emitter Speed, Rotation By Speed, Trigger, Sub Emitters, Texture Sheet Animation, Lights, Custom Data

## Uso real: qué puedes pedirle a la IA

Como la IA tiene acceso completo a todos los parámetros de ParticleSystem, puedes hacer peticiones en lenguaje natural y la IA averigua qué módulos y propiedades debe cambiar:

- «Crea un efecto de hoguera con partículas de naranja a rojo que suban y se desvanezcan»
- «Haz que las partículas de humo sean más grandes y lentas, con más turbulencia»
- «Añade colisión para que las chispas reboten en el suelo»
- «Activa las estelas en las partículas del proyectil mágico»
- «Duplica la tasa de emisión y haz que las partículas se repitan de forma continua»
- «Cambia la forma de cono a esfera y aumenta el radio»

## Instalación

La extensión requiere que AI Game Developer (Unity-MCP) esté instalado primero. Una vez configurado, añade la extensión ParticleSystem mediante OpenUPM o el instalador .unitypackage.

### Opción A: OpenUPM (recomendado)

Bash Terminal

```bash
openupm add com.ivanmurzak.unity.mcp.particlesystem
```

### Opción B: Unity Package Installer

Sigue la descarga del instalador que se indica en el README de la extensión, en [github.com/IvanMurzak/Unity-MCP/blob/main/extensions/ParticleSystem/README.md](https://github.com/IvanMurzak/Unity-MCP/blob/main/extensions/ParticleSystem/README.md), e importa el .unitypackage en tu proyecto de Unity desde Assets > Import Package > Custom Package.

## Cómo funciona por dentro

Los módulos de ParticleSystem de Unity son structs de C#, no clases, lo que significa que no se pueden modificar mediante una reflexión simple. La extensión usa ReflectorNet para boxear cada módulo, aplicar las modificaciones mediante diffs de miembros serializados y volver a escribir el valor modificado. Todas las llamadas a la API de Unity se despachan al hilo principal, y las ventanas del editor se repintan tras cada modificación para que veas los cambios al instante.

C# Tool\_ParticleSystem.cs

```csharp
// The extension registers tools via attributes — Unity-MCP discovers them automatically
[AiToolType]
public partial class Tool_ParticleSystem
{
    [AiTool("particle-system-get", Description = "Get ParticleSystem data")]
    public async Task<string> GetParticleSystem(
        GameObjectRef gameObjectRef,
        bool includeMain = false,
        bool includeEmission = false,
        bool includeShape = false,
        // ... flags for all 24 modules
        bool includeAll = false,
        bool deepSerialization = true)
    {
        // Serializes requested modules and returns structured JSON
    }
}
```

## Compatibilidad

- Unity 2022.3 o superior
- Requiere AI Game Developer (Unity-MCP) v0.60.0+
- Funciona con cualquier cliente MCP: Claude Code, VS Code Copilot, Cursor, Windsurf, Continue
- Probado en Unity 2022.3, 2023.2 y Unity 6 (6000.3)

## Empezar

Instala AI Game Developer, añade la extensión ParticleSystem y empieza a describir los efectos que quieres. La IA se encarga del resto. Consulta la guía de inicio rápido en [ai-game.dev/docs/quickstart](https://ai-game.dev/docs/quickstart) para ver el proceso de configuración completo, o descarga el plugin desde la página de descargas en [ai-game.dev/download](https://ai-game.dev/download).

- Unity-AI-ParticleSystem: [github.com/IvanMurzak/Unity-MCP/blob/main/extensions/ParticleSystem/README.md](https://github.com/IvanMurzak/Unity-MCP/blob/main/extensions/ParticleSystem/README.md)
- AI Game Developer (Unity-MCP): [github.com/IvanMurzak/Unity-MCP](https://github.com/IvanMurzak/Unity-MCP)
- Extensión de animación con IA: [github.com/IvanMurzak/Unity-MCP/blob/main/extensions/Animation/README.md](https://github.com/IvanMurzak/Unity-MCP/blob/main/extensions/Animation/README.md)
- Extensión AI ProBuilder: [github.com/IvanMurzak/Unity-MCP/blob/main/extensions/ProBuilder/README.md](https://github.com/IvanMurzak/Unity-MCP/blob/main/extensions/ProBuilder/README.md)
- Descarga: [ai-game.dev/download](https://ai-game.dev/download)
- Guía de inicio rápido: [ai-game.dev/docs/quickstart](https://ai-game.dev/docs/quickstart)
- Tutorial de configuración: [ai-game.dev/blog/claude-code-unity-tutorial](https://ai-game.dev/blog/claude-code-unity-tutorial)

## Más del blog

[Todas las entradas](https://ai-game.dev/es/blog)

### [De imágenes de referencia a un modelo 3D listo para el juego: Tripo AI dentro de AI Game Developer](https://ai-game.dev/es/blog/tripo-ai-3d-models-from-reference-images)

26 de octubre de 2026

Convierte de dos a cuatro vistas en un modelo 3D con Tripo en AI Game Developer y luego texturízalo, límpialo, rígcalo y anímalo en el mismo chat.

Ivan Murzak 7 min de lectura

### [Planifica primero, luego cambia: el modo plan para agentes de IA en el desarrollo de juegos](https://ai-game.dev/es/blog/plan-mode-ai-agent-game-development)

26 de octubre de 2026

Usa el modo plan, preguntas de aclaración, cola de mensajes y tarjetas de revisión en AI Game Developer para controlar al agente en tareas grandes.

Ivan Murzak 6 min de lectura

---

Source (HTML): https://ai-game.dev/es/blog/unity-ai-particle-system-extension

Machine-translated (es) from the English page: https://ai-game.dev/blog/unity-ai-particle-system-extension
