# asset

> 参数化 3D shape 生成（11 shape）+ 路径阵列 + batch + undo + save 预制件。create/path/batch/undo/save 经 editor 持久化（视口可见、可 undo）；list_shapes/list_materials 静态返回。

| 属性 | 值 |
|------|-----|
| 所属层 | editor |
| 安全级别 | guarded |
| 需要 Godot | 是 |
| 需要编辑器 | 是 |
| 只读 | 否 |
| 长耗时 | 否 |

## Actions

- `create`
- `path`
- `batch`
- `undo`
- `save`
- `list_shapes`
- `list_materials`

## Parameters

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `action` | enum (7 项) | ✓ | 操作类型 |
| `project_path` | string |  | Godot 项目目录 |
| `shape` | enum (11 项) |  | create/path: shape 名（见 list_shapes） |
| `params` | object |  | shape 参数（见 list_shapes 默认值） |
| `material` | string,object,null |  | 预设名 / PBR dict（color(hex),alpha,emissive,metallic,roughness）/ res://.tres / null |
| `name` | string |  | 节点名（碰撞自增 _001） |
| `parent` | string |  | 父节点路径（绝对 /Root/X 或相对 X/Y） |
| `position` | array |  | [x,y,z] |
| `rotation` | array |  | [x,y,z] 弧度 |
| `scale` | array |  | [x,y,z] |
| `items` | array |  | batch: [{shape,params,material,name,...}] ≤64 |
| `path` | array |  | path: [[x,y,z],...] ≥2 点（与 path_node 互斥） |
| `path_node` | string |  | path: 场景 Path3D 节点路径（与 path 互斥） |
| `mode` | enum: discrete | continuous |  | path 采样模式 |
| `spacing` | number |  | path discrete: 等间距（与 count 互斥） |
| `count` | number |  | path discrete: 等数量（与 spacing 互斥） |
| `align` | enum: none | path | normal |  | path 朝向（默认 path） |
| `align_vertices` | boolean |  | path continuous+spacing: 折线顶点段边界对齐 |
| `node_path` | string |  | save: 要存的子树节点路径 |
| `resource_path` | string |  | save: res://xxx.tscn 输出路径 |

## 风险分布

读 2 / 写 5

---
<!-- AUTO-GENERATED by scripts/gen-tool-docs.mjs from capability-matrix.json v0.32.21. DO NOT edit manually; re-run npm run gen:tool-docs after tool changes. -->