particles
Idempotent
Create and configure Godot particle systems: add GPU particle nodes (2D/3D), set emission/process parameters, load presets, and apply materials. Works at runtime for the current context.
Instructions
创建 GPUParticles2D/3D 节点、设置发射/处理参数、加载预设效果、设置粒子材质。运行时操作，仅影响当前执行上下文。如需持久化，请编辑 .tscn 文件。运行时操作，仅影响当前执行上下文。如需持久化，请编辑 .tscn 文件。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | 节点名称（particles_create） | |
| action | Yes | 操作类型 | |
| amount | No | 发射数量（正整数） | |
| parent | No | 父节点路径（默认 root） | |
| preset | No | 预设效果名称 | |
| spread | No | 扩散角度（0-180 度） | |
| damping | No | 阻尼 | |
| gravity | No | 重力 {x,y,z} | |
| lifetime | No | 粒子生命周期（秒） | |
| position | No | 位置。3D 用 {x,y,z}，2D 用 {x,y} | |
| direction | No | 发射方向 {x,y,z} | |
| node_path | No | 粒子节点路径 | |
| node_type | No | 粒子节点类型（particles_create） | |
| randomness | No | 随机性（0-1） | |
| speed_scale | No | 速度缩放 | |
| project_path | No | Godot 项目目录路径（可选，默认使用 GODOT_PROJECT_PATH 环境变量或当前目录） | |
| explosiveness | No | 爆发性（0-1） | |
| material_type | No | 材质类型（ParticleProcessMaterial） | |
| emission_shape | No | 发射形状 | |
| load_autoloads | No | 是否加载 Autoload 上下文（默认 true） | |
| emission_box_extents | No | 盒体发射范围 {x,y,z}（emission_shape=box 时有效） | |
| emission_sphere_radius | No | 球体发射半径（emission_shape=sphere 时有效） |