Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

docs(assets): a multi-selection edits import settings together

esengineda5e3cc66b73
diff --git a/docs/astro/src/content/docs/agents/mcp.mdx b/docs/astro/src/content/docs/agents/mcp.mdx
index 9c6b96a95..650b2399b 100644
--- a/docs/astro/src/content/docs/agents/mcp.mdx
+++ b/docs/astro/src/content/docs/agents/mcp.mdx
@@ -188,6 +188,8 @@ Some things live in **import settings**, not on a component — a texture's 9-sl
border is the one that bites: a `UIVisual` set to NineSlice reads its border from
texture metadata, so a frame or button authored without `set_import_settings`
stretches its corners. `get_import_settings` shows every knob with its default.
+`set_import_settings` takes an **array** of paths for the same patch onto a whole
+folder in one call — each asset keeps the settings the patch does not name.
</Aside>
## From the repository (contributors)
diff --git a/docs/astro/src/content/docs/assets/textures.mdx b/docs/astro/src/content/docs/assets/textures.mdx
index 0df4e09c5..49bce6fae 100644
--- a/docs/astro/src/content/docs/assets/textures.mdx
+++ b/docs/astro/src/content/docs/assets/textures.mdx
@@ -127,6 +127,19 @@ Browser — every sprite that uses the texture inherits them.
colour edges are.
</Aside>
+### Editing a whole folder at once
+
+Select several images (ctrl/cmd-click, shift-click, or Select All) and the inspector
+edits **all of them**. A setting they already agree on shows its value; one they
+disagree on shows a dash — type into it and every selected image takes that value.
+Save writes only the settings you touched, so the ones each image had its own answer
+for are left alone. Sprites and textures share a schema and batch together; a
+selection that mixes in an audio clip or a model says so instead, since there is no
+field they all have.
+
+The 9-slice border editor stays on a single selection — it draws one image, and there
+is no honest picture of forty.
+
### Per-platform overrides
Max Size, Compress and Compress Format can be overridden **per platform** — the tabs
diff --git a/docs/astro/src/content/docs/zh-cn/agents/mcp.mdx b/docs/astro/src/content/docs/zh-cn/agents/mcp.mdx
index 04f0565d8..9f98bfb67 100644
--- a/docs/astro/src/content/docs/zh-cn/agents/mcp.mdx
+++ b/docs/astro/src/content/docs/zh-cn/agents/mcp.mdx
@@ -174,6 +174,8 @@ claude mcp add estella --env ESTELLA_MCP_ALLOW_WRITES=1 -- \
`UIVisual` 设成 NineSlice 后,边框是从纹理元数据读的,所以没配
`set_import_settings` 就搭出来的边框和按钮,四角会被拉伸变形。
`get_import_settings` 会把每个选项连同默认值一起列出来。
+`set_import_settings` 的 path 可以传**数组**——一次调用把同一份 patch 打到整个文件夹上,
+每个资产保留 patch 没点名的设置。
</Aside>
## 从源码仓库使用(贡献者)
diff --git a/docs/astro/src/content/docs/zh-cn/assets/textures.mdx b/docs/astro/src/content/docs/zh-cn/assets/textures.mdx
index 4049f1fb3..9ebc77aeb 100644
--- a/docs/astro/src/content/docs/zh-cn/assets/textures.mdx
+++ b/docs/astro/src/content/docs/zh-cn/assets/textures.mdx
@@ -117,6 +117,15 @@ GPU 对象,所以分开缓存。除非你在喂一条本来就要求自下而
而块压缩的瑕疵恰恰出现在硬色边上。
</Aside>
+### 一次改一整个文件夹
+
+多选若干张图片(ctrl/cmd 点选、shift 点选,或者全选),Inspector 就在编辑**它们全部**。
+一项设置它们本来就一致,就显示那个值;不一致就显示一个横杠——往里填一个值,所选的每张图片
+都会取这个值。保存只写你动过的设置,各自不同的其它设置原样保留。精灵和纹理共用一套导入
+设置,可以一起批量改;选择里混进音频或模型则会直接说明——它们没有共同的字段。
+
+九宫格边框编辑器只在单选时出现:它画的是一张图,而四十张没有一张诚实的图可画。
+
### 按平台覆盖
Max Size、Compress、Compress Format 可以**按平台覆盖**——就是导入设置里 Default 旁边那排页签。