角色管理

角色模块用于创建角色并管理立绘、差分表情、距离与位置、显示尺寸和默认属性。剧本通过角色配置引用立绘素材。

​

界面布局

• 左侧：「全局设置」（距离与位置、属性模板）和角色列表。角色列表支持按住整行拖动排序，顺序会反映到剧本编辑器的角色选单中。
• 中间：所选角色的详情，分「表情资源」「立绘皮肤」「显示名」「角色属性」四个页签。
• 右侧：角色预览与资源引用。预览可以切换表情、背景、距离和位置，按项目分辨率实时显示。

​

创建角色

​

批量导入立绘

将多张图片拖到角色列表后，Studio 会打开「创建新角色」对话框。

• 角色名：根据文件名推断，可以手动修改
• 默认立绘：从导入图片中选择
• 表情名：点击缩略图旁的铅笔图标修改

确认后，Studio 会创建角色，并将其余图片添加为差分表情。支持 png、jpg、jpeg 和 webp。

​

角色显示名

角色主名称用于 Studio 内识别角色。除此之外，可以在角色详情中创建多个显示名方案，让同一角色在不同对白中使用别名、称呼或由变量决定的名字。 在连续对白中按 Tab 打开扩展菜单，或在对白检查器中选择显示名方案。显示名只影响玩家看到的名牌和历史记录，不会改变角色主名称或立绘引用。 重命名显示名方案或它引用的角色属性时，Studio 会迁移项目中的对白引用。删除仍被对白使用的方案前，先检查提示中的影响范围。

​

差分表情

每句连续对白可以选择独立的差分表情。 添加方式：

• 单个添加：点击「+ 添加表情」，输入名称并上传图片
• 批量添加：将多张图片拖入当前角色的表情区域，确认自动生成的表情名

管理操作：

• ⌘/Ctrl + 点击：逐个多选
• Shift + 点击：范围选择
• 双击表情名：重命名；Enter 保存，Esc 取消
• 拖动所选表情：调整顺序
• 选择一个或多个表情后删除：批量删除

​

动态立绘与序列帧

选择一个表情后，可以在「呈现方式」中切换普通图片、序列帧、Spine 或 Live2D：

• 序列帧：从项目图片或角色已有表情添加帧，设置 1～60 FPS 和循环播放；
• Spine：选择已导入的 Spine 3.8 / 4.3 模型、动作、皮肤和循环方式；
• Live2D：选择已导入模型的动作组、Live2D 表情和循环方式。

动态表情与普通表情一样用于对白、显示立绘和表情切换。模型导入、第三方授权、构建行为和常见问题见动态图像与动态立绘。 在当前表情的「舞台显示」中可以打开「左右翻转」。该设置只影响舞台立绘方向，不修改原图或模型，也不影响对白头像；Spine 与 Live2D 会在编辑器中实时预览翻转结果。

​

缩略图裁剪

缩略图裁剪决定剧本编辑器中对白左侧的头像范围。可以手动裁剪，也可以使用「套用其他表情」复制已有设置。 裁剪只影响 Studio 编辑器中的头像，不影响游戏画面或原始立绘。

​

对白头像

对白头像显示在游戏对话框中，与剧本编辑器使用的缩略图裁剪相互独立。先在角色详情左侧打开「对白头像」总开关，再为每个表情决定头像来源。 选择一个表情后，在「对白头像」区可以：

• 点击「选择图片」，改用项目中的独立头像；
• 点击「调整裁剪」，设置头像框显示的区域；
• 点击「恢复默认裁剪」，回到整张图片；
• 点击「恢复跟随立绘」，移除独立图片并重新跟随表情立绘。

Studio 会自动生成轻量头像资源，减少游戏运行时重复裁切和解码。生成失败时会继续使用原图，不会清除头像配置。 关闭角色的「对白头像」总开关只会停止显示，不会删除各表情已经设置的独立图片与裁剪；重新开启后可以继续使用。

​

立绘皮肤

角色有多套外观时（换装、受伤、季节等），可以为同一套表情配置多套立绘资源。剧本里只写表情，需要切换外观时在剧本中锁定使用哪一套皮肤。入口在角色详情的「立绘皮肤」页签。

​

添加皮肤

• 点击「添加皮肤」手动新建，起个名字，比如「制服」「泳装」「受伤」。
• 素材名自带规律时（如「制服微笑」「泳装微笑」），点击「从表情名识别」可一键归组：Studio 会扫描表情名的公共前缀或后缀，给出可能的分法候选。采用后自动建好各套皮肤，并把「制服微笑」等表情折叠为基名「微笑」。

​

管理皮肤

• 每套皮肤显示为一枚标签：双击重命名，星形按钮设为默认，垃圾桶按钮删除。
• 重命名会同步更新剧本中锁定该皮肤的引用。
• 删除不会改动剧本：剧本中锁定它的位置会显示错误提示，由你决定如何处理。

​

立绘矩阵

「立绘配图」区的矩阵中，行是表情、列是各套皮肤，逐格配图：

• 点击空格子选择图片；点击已配格子更换图片。
• 右键格子可以更换或「清除这一格」，清除只解除该格的对应关系，表情和默认图不受影响。
• 矩阵上方会提示缺图数量。某套皮肤下的表情缺图时，画面回落到表情默认图，不会空白。

​

在剧本中锁定皮肤

• 对白 Block：点击角色名行的表情标签打开 Tab 菜单，在「皮肤」分组中选择。选择会按对白组连带生效——同一角色连续的对白一起改，换角色后自动回到「自动」。
• 显示立绘 Block：在检查器的「皮肤」下拉中选择，只对当前 Block 生效。
• 锁定后角色名行会出现带锁图标的皮肤名标签；保持「自动」时使用默认那套皮肤。皮肤被删除后，引用它的标签会变红提示。

​

距离与位置方案

进入「全局设置 → 距离与位置」。新项目默认提供三套距离： 每套距离都有自己的一组位置。也就是说，“远·左侧”和“近·左侧”可以使用不同坐标，避免角色改变景别后仍被迫沿用同一个站位。

​

管理距离和位置

• 点击距离名称切换方案，双击名称可以重命名。
• 点击“新增距离方案”创建新的景别；每个项目至少保留一套距离。
• 在“方案内位置”中选择、重命名、新增或删除站位；每套距离至少保留一个位置。
• 使用 X、Y 参数精确调整坐标，范围允许超出画布，适合从画面外入场。
• “当前距离尺寸”控制该距离相对角色基准尺寸的倍率。
• “坐标锚点”可以选择中心点或左上角。
• 把常用组合设为默认后，新建对白或显示立绘会优先使用这组距离与位置。

删除距离后，剧本中引用它的内容会回落到默认距离；删除某个位置只影响当前距离方案。执行删除前先检查已有剧本引用。

​

全局方案与角色独立方案

默认情况下，所有角色继承项目的全局距离、位置、基准尺寸和锚点。某个角色需要特殊构图时，在“配置对象”中选择“为指定角色创建独立方案”。 独立方案创建时会完整复制当前全局配置，之后可以单独修改，不影响其他角色。例如，让体型较小的角色在“中景”使用更大的基准尺寸，或者为坐姿角色重新校准所有站位。 删除角色独立方案后，该角色重新继承全局方案；独立方案中的修改不会保留。

​

在舞台预览中调整

选择距离和位置后，可以直接在舞台预览中编辑当前组合：

• 拖动立绘改变位置；
• 按住 Shift 拖动时锁定横轴或纵轴；
• 拖动缩放手柄改变当前距离尺寸；
• 鼠标停在立绘上滚动滚轮也可以缩放；
• 数值面板和舞台操作使用同一套坐标与尺寸，修改会相互同步。

上图的舞台右上角会显示操作提示，顶部和左下角会同步显示当前 X、Y 坐标与尺寸，方便拖动后继续精确校准。

​

立绘尺寸如何计算

立绘基准尺寸使用“立绘高度占画面高度的比例”，因此切换项目分辨率时仍保持相同的画面占比：

• 100% 表示立绘高度等于画面高度；
• 50% 约为画面高度的一半；
• 超过 100% 时超出画布的部分会被裁掉，适合半身近景；
• 宽度按素材宽高比自动计算，不会拉伸变形。

最终显示尺寸会在基准尺寸上叠加当前距离的倍率。角色拥有独立方案时使用角色基准尺寸，否则使用全局基准尺寸；表情自身的尺寸校准仍会保留，再叠加距离倍率。

​

从旧项目升级

旧项目的立绘尺寸使用「相对素材原始尺寸的百分比或固定像素」，切换分辨率时立绘大小会变乱。打开这类项目后，前往 设置 → 维护任务，点击「升级立绘尺寸」一键升级：

• 换算以「画面不能变」为原则，升级后画面保持原样；
• 升级前会自动创建历史快照，可整体回退；
• 个别读不到素材尺寸的立绘会保持原样，不做强行转换。

旧项目只有单层站位时，Studio 会把原位置无损展开到远、中、近三套距离，并以“中 / 100%”作为默认组合，原有剧本画面保持不变。

​

图形覆盖

图形覆盖用于在立绘上叠加其他图层。开启「覆盖默认尺寸」后，可以单独设置覆盖图层的显示尺寸。

​

角色属性

右侧面板显示角色属性和资源引用次数。角色属性由变量管理器定义；此处只能覆盖当前角色的默认值。 修改角色立绘后，所有引用该角色的剧本位置会使用新配置。