From 678a68ebc5a5e38ecbb1564130b93f9981f3d9ec Mon Sep 17 00:00:00 2001
From: fltLi <ddsk_06294219mr@qq.com>
Date: Sat, 2 May 2026 10:55:12 +0800
Subject: [PATCH] docs: note `changeFigure` figure side priority

---
 src/script-reference/commands/changeFigure.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/script-reference/commands/changeFigure.md b/src/script-reference/commands/changeFigure.md
index 259af389..1fd6fbec 100644
--- a/src/script-reference/commands/changeFigure.md
+++ b/src/script-reference/commands/changeFigure.md
@@ -117,6 +117,10 @@ changeFigure:1/open_eyes.png -left;
 此参数仅在立绘出场，或替换立绘时生效。如果需要修改在场立绘的坐标，请使用 `setTransform`、`setAnimation`、`setTempAnimation` 等命令。
 :::
 
+::: warning
+`right` 参数优先级大于 `left`，两者同时出现时立绘将设置在右侧。
+:::
+
 ```webgal
 changeFigure:1/open_eyes.png -right;
 ```