NPC 剧情会面数据
按人物驻点关联个人剧情对话、终点和支线任务。
会面数据与驻点坐标分别维护,迁移人物不改变玩家的完成记录。
文件放在哪里
文件位于 data/<namespace>/npc_story_encounters/**/*.json,路径确定会面 ID,同路径由资源包优先级决定。独特 NPC 部署方块的 Deployment.Encounter 关联该 ID;匹配的人物类型才会接入。
最小示例
{
"character": "isekaiexpansion:mahoutsukai_evelina",
"locked_message": "message.isekaiexpansion.evelina_demo.await_body",
"steps": [
{
"dialogue": "isekaiexpansion:npc/unique/isekaiexpansion_mahoutsukai_evelina/quest/garden_demo/first_meeting",
"milestone": "isekaiexpansion:evelina_demo/introduced",
"requirements": {
"requires": [
"isekaiexpansion:chapter_01/body_built"
],
"excludes": []
},
"completion_ends": [
"end_intro"
],
"quest_after": "isekaiexpansion:evelina_demo/first_record"
},
{
"dialogue": "isekaiexpansion:npc/unique/isekaiexpansion_mahoutsukai_evelina/quest/garden_demo/first_record",
"milestone": "isekaiexpansion:evelina_demo/first_record",
"requirements": {
"requires": [
"isekaiexpansion:evelina_demo/introduced"
],
"excludes": []
},
"completion_ends": [
"end_complete"
]
}
]
}
字段
| 字段 | 类型 | 默认值 | 行为 |
|---|---|---|---|
character | identifier | Required | 可使用此会面的实体类型。 |
locked_message | string | Required | 下一步条件未满足时显示的翻译键,不得为空。 |
steps | array<object> | Required | 按顺序排列的 1–32 个阶段。 |
steps[].dialogue | identifier | Required | 本会面内唯一的对话 ID。 |
steps[].milestone | identifier | Required | 本会面内唯一的个人完成事实,已记录的阶段会跳过。 |
steps[].requirements | object | Required | 选择与完成时均检查的命名条件。 |
steps[].requirements.requires | array<identifier> | [] | 最多 64 个唯一 ID,每个至多 256 字符。首个阶段之后必须包含紧邻前一阶段的完成事实。 |
steps[].requirements.excludes | array<identifier> | [] | 数量和长度限制相同,不得与 requires 重叠。阶段不得要求或排除自身的完成事实。 |
steps[].completion_ends | array<string> | Required | 1–16 个不同的终点状态键,仅用小写字母、数字、下划线。在其他终点自然关闭不记录完成。 |
steps[].quest_after | identifier | Absent | 本阶段完成后接受的可选 side_story 任务,仍执行通常的接受条件。 |
校验
缺字段、非法标识符、未知字段、重复阶段标识及越界数量会拒绝该文件并记录错误。所有标识符必须显式带命名空间。对话缺失会拒绝开始;终点键必须在对应图中使用 end_dialogue。只有自然结束、实际人物与会话仍相符且距离不超过 12 格时才记录事实。强制关闭或走到未列入配置的终点不会完成。剧情会面优先于通常菜单,开场和主线优先于会面。全部阶段完成后恢复通常交互。
伊维莉娜庭院支线的初识对话,所有自然结束都到达end_intro,包括听完姓名后告辞。后续交谈中,讨论庭院或身体、留待下次、婉拒话题,都会到达end_complete。这些事实只记录交谈,不要求提交物品,也不表示得出了研究结果;结束后恢复普通菜单。初识后选择告辞,下次不会重新自我介绍。
重载
/reload 重新加载会面,清除待结算的会话,不清除已保存的个人里程碑。定义只在服务端选择,对话图通过已有对话协议发送。
当前庭院 demo 将 Evelina 放在局部方块 (-112, 24, 60),脚面 (-111.5, 24, 60.5),正南 yaw 0,STAY 驻留,无家园点,待机转头范围为左右各 40°。独立原生层 remote_sky_garden_evelina/demo-v1 绑定 isekaiexpansion:evelina_garden_demo。以后迁往都市时修改部署与内容版本,个人剧情事实不依赖坐标。五层原型采用新指纹,需要新建测试世界;不会改写已有存档。