2.4 KiB
2.4 KiB
name, description
| name | description |
|---|---|
| yarn-dialogue-role-config | Use when 配置对话角色、新增 role、添加 Yarn 角色、character.csv、为模块配置角色、对话 speaker. Guides adding entries to character.csv and using the Key in Yarn dialogue files. |
Yarn 对话角色配置
为项目新增对话角色时，需要同时配置 character.csv 和在 Yarn 文件中使用对应的 speaker。
1. character.csv 新增一行
路径：Assets/StreamingAssets/Config/character.csv
CSV 列（从左到右）：
| 列 | 说明 | 示例 |
|---|---|---|
| Key | 必填，Yarn 中作为 speaker 的 key，需与 Yarn 内完全一致 | SaleModule |
| Cn | 显示名，支持 <br> 换行 |
销售型<br>销售语言处理模块 |
| (第3列) | 英文/备用名，可空 | |
| DialogViewType | 显示位置：Default、Screen、OldBox、CenterText、CenterOption 等 |
Default 或 Screen |
| Role | 人物角色：Player、MainActor、Aside |
Aside |
| NameColor | 名称颜色，如 #F56C6C，可空 |
|
| HeadPicPath | 头像路径，可空 | |
| VoicePath | 语音路径，如 VO/voice_XX，可空 |
|
| BubbleIdx | 气泡序号，默认 0 |
参考现有行格式，插入到合适位置（如与其他模块角色放一起）。
2. Yarn 中使用
对话行格式：Key: 对话内容
SaleModule: 已与销售模块建立连接！
SaleModule: 信号接受正常，信号来源：
Key 必须与 character.csv 中的 Key 完全一致，否则会按 key 原样显示或找不到配置。
3. 修改 Yarn 时的注意
- 遵循
.cursor/rules/yarn-localization.mdc：不要动#line:及哈希值 - 可改：对话内容、 speaker key、节点标题
- 不可改：
#line:xxxxxxxx整段 - 新增行：不手动写
#line，由 YARN Spinner 自动生成
4. 完整示例
为「销售模块」新增专用角色：
character.csv 新增：
SaleModule,销售型<br>销售语言处理模块,Sales type sales language processing module,Screen,Aside,#F56C6C,,,
Yarn 中替换/使用：
SaleModule: 已与销售模块建立连接！
SaleModule: 信号接受正常，信号来源：
SaleModule: 情绪模块，逻辑模块
5. 本地化
修改 speaker 后，*_zh-Hans.asset 等本地化文件中的旧 key 可能仍存在。可：
- 在 Unity 中重新导入 Yarn 项目的 String Table
- 或手动更新对应条目中的角色名