跳转到内容

在故事之间复用角色

读者卡让 Rowan 在一个故事中拥有角色身份。单独注册的 storyorbit.character/1 角色保存不可变的角色修订,可以在不同故事中出现。选角将两者连接起来。完成温室故事的九课练习并不需要这项功能。

角色文档包含 protocol、UUID 形式的 character_id、正整数 revision、default_language、localizations、关系 stages、assets 与 portrait。支持的本地化键是 en 和 zh,不是文档路径中的 zh-cn。每种语言提供名称、介绍、问候、人格与说话风格。初始关系阶段没有升级前提。静态肖像使用图片。作者制作的空闲、说话与反应 APNG 可以通过明确绑定与 VN 立绘 performance 共用;原有肖像 MP4 仍可用于聊天。角色关系阶段与故事状态仍然独立,选角不会授予隐藏故事素材的访问权。

通过服务的角色流程注册获授权的角色修订后,可以在 0.4 或 0.5 Pack 中加入选角。下面是片段,不是完整 Pack;需要用已注册身份替换示意 UUID 和修订号,同时保留 Pack 中 Rowan 的角色读者卡。

{
"id": "rowan_greenhouse",
"actor_id": "rowan",
"character_id": "00000000-0000-4000-8000-000000000001",
"character_revision": 1,
"entry_ids": ["arrival"],
"when": { "op": "literal", "value": true },
"knowledge": [{
"id": "first_visit",
"text": "访客在温室闭馆前到来。",
"when": { "op": "literal", "value": true }
}],
"deeds": [{
"id": "shared_care",
"when": { "op": "gte", "path": "/trust", "value": 2 }
}]
}

将它放进 character_castings。知识与行动记录由公开状态控制,不要把尚未揭晓的秘密放入始终可见的知识。若使用 player_actor_id,它必须对应范围内另一个不同的角色卡。上方 UUID 仅为示意,不代表存在可用的已注册角色。本地结构校验无法确认归属、可用性或权限。

查询 0.4 选角参考中的完整字段与嵌套类型;VN Pack 可查看 0.5。通过服务检查语义,然后私下测试预期关系与行动记录。固定角色修订号;更新角色不会悄悄替换每个已经选用它的故事。