# particles > 创建 GPUParticles2D/3D 节点、设置发射/处理参数、加载预设效果、设置粒子材质。运行时操作，仅影响当前执行上下文。如需持久化，请编辑 .tscn 文件。运行时操作，仅影响当前执行上下文。如需持久化，请编辑 .tscn 文件。 | 属性 | 值 | |------|-----| | 所属层 | headless | | 安全级别 | guarded | | 需要 Godot | 是 | | 需要编辑器 | 否 | | 只读 | 否 | | 长耗时 | 否 | ## Actions - `particles_create` - `particles_set_emission` - `particles_set_process` - `particles_load_preset` - `particles_set_material` ## Parameters | 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | `action` | enum (5 项) | ✓ | 操作类型 | | `project_path` | string | | Godot 项目目录路径（可选，默认使用 GODOT_PROJECT_PATH 环境变量或当前目录） | | `node_type` | enum: GPUParticles2D | GPUParticles3D | | 粒子节点类型（particles_create） | | `name` | string | | 节点名称（particles_create） | | `parent` | string | | 父节点路径（默认 root） | | `position` | object | | 位置。3D 用 {x,y,z}，2D 用 {x,y} | | `preset` | enum (6 项) | | 预设效果名称 | | `node_path` | string | | 粒子节点路径 | | `amount` | number | | 发射数量（正整数） | | `emission_shape` | enum (4 项) | | 发射形状 | | `emission_sphere_radius` | number | | 球体发射半径（emission_shape=sphere 时有效） | | `emission_box_extents` | object | | 盒体发射范围 {x,y,z}（emission_shape=box 时有效） | | `direction` | object | | 发射方向 {x,y,z} | | `spread` | number | | 扩散角度（0-180 度） | | `gravity` | object | | 重力 {x,y,z} | | `speed_scale` | number | | 速度缩放 | | `explosiveness` | number | | 爆发性（0-1） | | `randomness` | number | | 随机性（0-1） | | `lifetime` | number | | 粒子生命周期（秒） | | `damping` | number | | 阻尼 | | `material_type` | string | | 材质类型（ParticleProcessMaterial） | | `load_autoloads` | boolean | | 是否加载 Autoload 上下文（默认 true） | ## 风险分布 写 5 ---