开场章节数据
把庭院个人序章绑定到已审核的结构、镜头、对话路线和任务。
开场描述文件绑定完整章节,不执行任意动作,也不创建另一套章节系统。坐标使用庭院统一的局部坐标系。
文件放在哪里
固定资源为 data/isekaiexpansion/story_chapters/remote_sky_garden.json。资源包优先级选择一份完整文件,不合并字段。场景和任务 ID 指向各自的数据资源,对话 ID 指向已注册的 Blabber 对话图。
最小示例
所有角色映射均必填。以下为内置描述文件,指纹只对对应的原生结构组合有效:
{
"schema": 4,
"bundle_digest": "32ee8e6e7871709822683e1602d2976398b0ac959d98e269927f94c754c38618",
"anchors": {
"reveal": {
"position": [
-0.5,
0,
159.5
],
"yaw": 180,
"radius": 16
},
"selene": {
"position": [
13.5,
24,
22.5
],
"yaw": 39.093859,
"radius": 10
},
"construction": {
"position": [
-0.5,
26,
-12.5
],
"yaw": 0,
"radius": 3
},
"portal": {
"position": [
37.5,
24,
37.5
],
"yaw": 83.659808,
"radius": 4
}
},
"guidance": {
"reveal": {
"enabled": true,
"color": "#B7E8E3",
"beam_height": 18,
"beam_radius": 0.85,
"visible_distance": 256,
"through_wall_distance": 128,
"billboard_height": 3.2
},
"selene": {
"enabled": true,
"color": "#B7E8E3",
"beam_height": 14,
"beam_radius": 0.7,
"visible_distance": 256,
"through_wall_distance": 128,
"billboard_height": 3.0
},
"construction": {
"enabled": true,
"color": "#D6C4FF",
"beam_height": 12,
"beam_radius": 0.8,
"visible_distance": 192,
"through_wall_distance": 96,
"billboard_height": 2.8
},
"portal": {
"enabled": true,
"color": "#B7E8E3",
"beam_height": 16,
"beam_radius": 1.0,
"visible_distance": 256,
"through_wall_distance": 128,
"billboard_height": 4.5
}
},
"scenes": {
"reveal": "isekaiexpansion:chapter_01/reveal",
"contact": "isekaiexpansion:chapter_01/contact",
"construction": "isekaiexpansion:chapter_01/construction",
"portal": "isekaiexpansion:chapter_01/portal",
"portal_return": "isekaiexpansion:chapter_01/portal_return"
},
"dialogues": {
"body_invitation": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/body_invitation",
"construction_approach": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/construction_approach",
"creation_resume": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/creation_resume",
"departure": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/departure",
"first_contact": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/first_contact",
"first_steps": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/first_steps",
"portal_delayed": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/portal_delayed",
"portal_ready": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/portal_ready",
"summoning": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/summoning",
"supplies_delayed": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/supplies_delayed",
"supplies_received": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/supplies_received",
"construction_wait": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/construction_wait",
"team_creation_wait": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/team_creation_wait",
"return_request": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/return_request",
"return_preparing": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/return_preparing",
"return_ready": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/return_ready",
"first_contact_team": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/first_contact_team",
"summoning_team": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/summoning_team",
"construction_approach_team": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/construction_approach_team",
"departure_team": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/departure_team",
"portal_ready_team": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/portal_ready_team",
"body_invitation_team": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/body_invitation_team",
"creation_choice": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/creation_choice",
"first_steps_team": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/first_steps_team",
"supplies_received_team": "isekaiexpansion:npc/unique/isekaiexpansion_goddess_selene/quest/chapter01/supplies_received_team"
},
"quests": [
"isekaiexpansion:chapter_01/look_around",
"isekaiexpansion:chapter_01/meet_selene",
"isekaiexpansion:chapter_01/construction_circle",
"isekaiexpansion:chapter_01/take_shape",
"isekaiexpansion:chapter_01/first_belongings",
"isekaiexpansion:chapter_01/way_down",
"isekaiexpansion:chapter_01/first_step"
]
}
字段
| 字段 | 类型 | 默认值 | 约定 |
|---|---|---|---|
schema | number | 必填 | 必须为 4,其他值拒绝。 |
bundle_digest | string | 必填 | 恰好 64 位小写十六进制字符,与已放置庭院的组合资源摘要一致。 |
anchors | object | 必填 | 恰好包含 reveal、selene、construction、portal。 |
anchors.<role>.position | number array | 必填 | 恰好 3 个有限局部坐标,单位格;加上庭院原点后,每个锚点须在边界内。 |
anchors.<role>.yaw | number | 必填 | 有限角度,单位度;用于演员/门方向,与场景触发器朝向分开。 |
anchors.<role>.radius | number | 必填 | 有限半径,0.25–64 格。 |
guidance | object | 必填 | 恰好包含 reveal、selene、construction、portal,分别设置各目的地的引导显示。 |
guidance.<role>.enabled | boolean | 必填 | 是否显示该目的地的引导;false 同时关闭光柱与标记,不改变剧情进度。 |
guidance.<role>.color | string | 必填 | RGB 颜色,格式为 #RRGGBB,恰好 6 位十六进制数字。 |
guidance.<role>.beam_height | number | 必填 | 光柱高度,有限数值,2–64 格。 |
guidance.<role>.beam_radius | number | 必填 | 光柱半宽,有限数值,0.15–4 格。 |
guidance.<role>.visible_distance | number | 必填 | 玩家到目的地的最大显示距离,有限数值,8–512 格。光柱与标记接近此距离时淡出。 |
guidance.<role>.through_wall_distance | number | 必填 | 标记与距离文字的穿墙显示距离,有限数值,0–visible_distance 格。0 关闭穿墙显示;光柱始终进行世界深度测试。 |
guidance.<role>.billboard_height | number | 必填 | 标记高于目的地的位置,有限数值,0.5–16 格。 |
scenes | object | 必填 | 恰好包含 reveal、contact、construction、portal、portal_return,5 个场景 ID 互不重复。 |
dialogues | object | 必填 | 恰好包含示例中的 25 个路线键,对话 ID 互不重复。 |
quests | identifier array | 必填 | 1–32 个互不重复、已经存在的个人主线任务。 |
场景、对话和任务 ID 均须显式写命名空间,最多 256 字符。根对象或锚点缺少字段、出现未知字段,或角色映射缺键、多键,均拒绝。空描述无效。
目的地引导
苏醒后,当前剧情队伍依次前往 reveal、selene、construction。构筑标记在身体创建与物资对话期间继续使用;传送门仪式完成且入口可用后,才显示 portal 标记。返庭队伍在自己的入口可用时获得该标记。排队中的其他队伍不会看到当前队伍的目的地。
距离按玩家到目的地的位置计算,四舍五入后显示为 X m,每格按一米计。传送门引导位于实际入口朝向的正前方 2 格,高度不变。在 through_wall_distance 范围内,只有标记和文字可以穿墙;超出后,通过视觉形状射线判断遮挡,忽略流体。光柱仍受世界深度遮挡,不绘制地面法阵。打开界面、播放过场、隐藏 HUD、显示调试信息、死亡、创造模式或旁观模式时,均隐藏引导。
即使关闭某个目的地,其引导字段仍须完整。缺少或多出字段、颜色格式错误、尺寸不是数字、数值非有限或超出范围,都会拒绝整份描述。只接受 schema 4,不保留旧格式读取或迁移逻辑。
镜头与对话约定
场景使用 local_yaw 触发器枢轴,锁定输入和移动,禁用 Escape 跳过。玩家为 triggering_player;除 reveal 外,瑟怜须用 nearest_type 选择,实体类型为 isekaiexpansion:goddess_selene。每段结束前恰有一个 isekaiexpansion:chapter_01/complete 信号;portal和portal_return场景各含一个 isekaiexpansion:chapter_01/open_portal,时间为第 92 刻(4.6 秒)。
portal用于首次离庭,portal_return用于瑟怜回到待机位置后的再次开门。两者均以portal位置为枢轴,并要求第0刻强制触发isekaiexpansion:story_portal的npc_body_emote动作。portal_return的首个摄影机节点必须位于第0刻,注视演员设为selene。内置重开版持续192刻(9.6秒),第96刻(4.8秒)切到入口,施法期间瑟怜留在原位。
对话路线用终点键表达决定,修改台词不改变这些门槛:
| 路线 | 推进终点 |
|---|---|
first_contact、summoning、construction_approach、supplies_received及其_team变体 | end;共享路线由发言人完成后,为准入的旁听队员记账 |
body_invitation、creation_resume | end_ready只允许该玩家在圆盘开始创建;end_wait保留已听邀请的记录 |
body_invitation_team | end;统一说明构筑,再分别打开个人决定 |
creation_choice | end_ready只允许该玩家在圆盘开始创建;end_wait暂缓 |
first_steps、first_steps_team | end_receive 表示确认收下。每名玩家完成角色创建后单独收到整套物资。 |
departure、departure_team、return_request | end_open;return_request在离庭后申请新的返程会话 |
portal_ready、portal_ready_team、supplies_delayed、portal_delayed、construction_wait、team_creation_wait、return_preparing、return_ready | 无;说明或重试对话 |
其他终点等待,不推进;强制关闭不完成路线。活动开场只允许瑟怜的当前剧情路线,不以日常内容兜底。中英文键在对话及过场语言分类中一起制作。
开发方块数据
内置isekaiexpansion:scene_trigger保留audience_mode/AudienceMode的triggering_player,用于个人重播记录。章节协调器为绑定的五段镜头提供固定队伍观众,并可在不清除重播记忆的情况下恢复遗漏检查点。再次开门由对话启动,无须新增触发方块。不要通过把方块改为team_nearby来授予个人事实。内置触发器朝北,演员和门的yaw由描述文件提供。
isekaiexpansion:story_barrier 不可见,按正在移动的玩家分别判断碰撞。创造、旁观及非玩家实体可穿过,方块实体没有刻逻辑。通过原生类型化方块实体数据制作以下 NBT:
| NBT 字段 | 类型 | 默认值 | 约定 |
|---|---|---|---|
BlockedWhen | compound | 无 | 缺失或非复合类型时不阻挡;有效复合谓词阻挡匹配的生存玩家。 |
BlockedWhen.requires | string list | 复合内必填 | 必须全部已记录,最多 64 个不重复命名空间 ID,每个最多 256 字符;空列表不要求事实。 |
BlockedWhen.excludes | string list | 复合内必填 | 均不可已记录;限制相同,与 requires 重叠时拒绝。 |
列表类型错误、重复 ID 或无效标识符拒绝。内置空气墙要求加入章节,并排除全景完成和旁路,因此玩家各自看完全景后通过。活动玩家从开场区域坠落会返回制作的出生平面,已完成事实保留。
校验
准入还检查场景定义、已注册对话、个人主线任务作用域、锚点边界及已放置结构指纹。资源拒绝或不可用时停用章节准入,普通角色创建与初始授予仍可用。不同指纹的原型存档不迁移,应使用新的匹配世界。
重载
描述重载先清除旧定义,再读取当前资源;替换数据无效时关闭可用状态,不保留过时定义。未完成玩家在服务端协调,旁路移除其仍活动的章节日志条目。内容变更后,现存场景和实体呈现仍需游戏内检查中断与重连。