立绘 (Character) 控制指南

// 基础显示：在左侧显示“角色A”
chars: "[角色A 左 lh1]"

// 属性继承：替换为 lh4，但自动保持在“左侧”位置
chars: "[角色A lh4]"

// 显式覆盖：移动到右侧并放大 10%
chars: "[角色A 右 10% lh3]"

// 多角色并存：不同标识符互不干扰，可同时显示
chars: "[角色A 左 lh1],[角色B 右 lh2]"

// 连续动作：标识符支持逗号分隔的状态序列
chars: "[角色A 左,中,右 lh1]"

// 通过名称消失：精准移除指定标识符对应的立绘
chars: "[消失 角色A]"

chars: "[中 lh01]" // 基础用法

chars: "[lh01]" // 简化写法 - 等同于 [中 lh01]

chars: "[左 lh01],[右 lh02]" // 同时显示两个立绘

chars: "[左,中,右 lh01]" // 连续动作：依次经过左、中、右

// 纯中文
chars: "[左 下 前 lh01]"

// 纯英文
chars: "[left down front lh01]"

// 中英文混合
chars: "[中 front lh01]"
chars: "[left 下 lh02]"

// 向下偏移
chars: "[中 下 lh01]"        // bottom: -25%
chars: "[middle downm lh01]" // bottom: -50%

// 向上偏移
chars: "[中 上 lh01]"        // bottom: 25%
chars: "[中 up lh01]"        // bottom: 25%（英文）
chars: "[中 中上 lh01]"      // bottom: 50%
chars: "[中 top lh01]"       // bottom: 65%（英文别名）

// 基础用法
chars: "[x:10% y:-5% lh01]"    // 向右10%，向下5%
chars: "[x:-20% y:15% lh02]"   // 向左20%，向上15%

// 仅指定一个轴
chars: "[x:30% lh01]"         // X轴精确，Y轴默认
chars: "[y:10% lh01]"         // Y轴精确，X轴居中

// 与其他修饰词组合
chars: "[x:15% y:-10% front 10% lh01]"  // 精确坐标 + 层级 + 缩放
chars: "[瞬 x:-25% y:20% lh01]"         // 瞬移 + 精确坐标

// 精确坐标优先于文字指令
chars: "[x:10% 左 lh01]"  // 使用 x:10%，忽略“左”

// lh01 在前，lh02 在后
chars: "[中 前 lh01],[中 后 lh02]"

chars: "[中 15% lh01]"  // 放大到 115%
chars: "[中 -20% lh01]" // 缩小到 80%
chars: "[中 0% lh01]"   // 保持 100%

// 渐入示例：支持与其他修饰词组合
chars: "[中 渐入 lh01]"        // 在中间位置渐入
chars: "[左 fadeIn lh02]"       // 在左侧渐入

// 渐出示例：建议单独使用，不要添加位置指令
chars: "[渐出 lh01]"            // 正确用法：直接渐出
chars: "[fadeOut lh02]"         // 英文写法

// 注意：不要在渐出时添加位置指令，否则会先闪到目标位置再消失
chars: "[左 渐出 lh01]"         // 不推荐：会先移动到左侧再渐出

// 批量渐出所有立绘
chars: "[渐出 all]"             // 所有立绘同时渐出
chars: "[fadeOut 全部]"         // 中英文混合

chars: "[瞬 左 lh01]"       // 瞬间移动，无动画
chars: "[instant right lh01]" // 英文写法

// 后退效果
chars: "[中 retreat lh01]"        // Y轴向上+10%，缩小10%，层级变后
chars: "[中 后退 lh01]"        // 中文等价

// 前进效果
chars: "[中 forward lh01]"     // Y轴向下-10%，放大10%，层级变前
chars: "[中 前进 lh01]"        // 中文等价

// 吓一跳
chars: "[中 scare lh01]"       // 放大7%再缩小7%，重复2次
chars: "[中 吓一跳 lh01]"      // 中文等价

// 发抖
chars: "[中 shake lh01]"       // 左右抖动3次
chars: "[中 发抖 lh01]"        // 中文等价

// 持续发抖与停止
chars: "[中 cshake lh01]"      // 开始持续发抖
chars: "[sshake lh01]"         // 停止发抖
chars: "[中 持续发抖 lh01]"    // 中文开始
chars: "[结束发抖 lh01]"       // 中文停止

// 点头效果
chars: "[中 nod lh01]"           // 执行一次点头动画
chars: "[中 点头 lh01]"          // 中文等价

// 基础连续移动
chars: "[左,中,右 lh01]"

// 多属性组合：每个片段内部使用空格分隔不同属性
chars: "[左 下,中 上,右 中下 lh01]"

// 示例解析：[左 下,右 上 后 瞬,中 y:+10% 10% lh01]
// Step 0: "左 下" -> 移动到左侧并向下偏移。
// Step 1: "右 上 后 瞬" -> 瞬间移动到右侧、向上偏移并置于底层。
// Step 2: "中 y:+10% 10%" -> 平滑移动到居中，Y轴+10%，缩放110%（层级保持“后”）。
chars: "[左 下,右 上 后 瞬,中 y:+10% 10% lh01]"

// 混合瞬移：左->瞬间右->平滑中->瞬间左左
chars: "[左,瞬,右,中,瞬,左左 lh01]"

// 片段内瞬移：瞬间切换到右侧上方底层
chars: "[左,右 上 后 瞬,中 lh01]"

// 精确坐标混合
chars: "[x:10%,左,x:-10% lh01]"

// 多属性同时变化
chars: "[左 下,中 上,右 中下 lh01]"

// 属性继承示例：Step 1 只改变了位置，层级和缩放保持 Step 0 的状态
chars: "[左 前 10%,右 lh01]" 
// Step 0: 左侧 + 顶层 + 放大10%
// Step 1: 右侧 + 顶层(继承) + 放大10%(继承)

// 带动作指令
chars: "[中 retreat,中 forward lh01]"

// 只取第一个水平位置 "左"，忽略后面的 "right"
chars: "[左 right lh01]"  // 结果：left = 25%

// 只取第一个垂直位置 "下"，忽略后面的 "downm"
chars: "[下 downm lh01]"  // 结果：bottom = -25%

// 复杂冲突：每类取第一个
chars: "[left right 下 downm front back 10% lh01]"
// 结果：left=25%(取left), bottom=-25%(取下), zIndex=11(取front), scale=110%

// 水平 + 垂直
chars: "[左 下 lh01]"

// 三属性组合：水平 + 垂直 + 缩放
chars: "[左 下 10% lh01]"

// 四属性组合：水平 + 垂直 + 层级 + 缩放
chars: "[右 中下 前 -15% lh01]"

// 完整组合：包含瞬移
chars: "[瞬 中 下下 20% 前 lh01]"

// 中英文混合组合
chars: "[left down front 10% lh01]"
chars: "[中 front 15% lh02]"
chars: "[instant right downm -10% lh03]"

// 精确坐标组合
chars: "[x:10% y:-5% lh01]"
chars: "[x:-15% y:10% front 10% lh02]"
chars: "[瞬 x:20% y:-10% lh03]"

// 移除单个立绘
chars: "[消失 lh01]"
chars: "[hide lh01]"
chars: "[remove lh01]"

// 同时移除多个立绘
chars: "[消失 lh01],[消失 lh02]"

// 中文指令
chars: "[消失 全部]"

// 英文指令 (hide)
chars: "[hide all]"

// 英文指令 (remove)
chars: "[remove all]"

// 实际应用场景：场景切换前清除所有立绘
chars: "[消失 all]"