Kzeroko KTM2

开场章节数据

把庭院个人序章绑定到已审核的结构、镜头、对话路线和任务。

更新于 2026/11/13 8 分钟阅读

开场描述文件绑定完整章节,不执行任意动作,也不创建另一套章节系统。坐标使用庭院统一的局部坐标系。

文件放在哪里

固定资源为 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"
  ]
}

字段

字段类型默认值约定
schemanumber必填必须为 4,其他值拒绝。
bundle_digeststring必填恰好 64 位小写十六进制字符,与已放置庭院的组合资源摘要一致。
anchorsobject必填恰好包含 reveal、selene、construction、portal。
anchors.<role>.positionnumber array必填恰好 3 个有限局部坐标,单位格;加上庭院原点后,每个锚点须在边界内。
anchors.<role>.yawnumber必填有限角度,单位度;用于演员/门方向,与场景触发器朝向分开。
anchors.<role>.radiusnumber必填有限半径,0.25–64 格。
guidanceobject必填恰好包含 reveal、selene、construction、portal,分别设置各目的地的引导显示。
guidance.<role>.enabledboolean必填是否显示该目的地的引导;false 同时关闭光柱与标记,不改变剧情进度。
guidance.<role>.colorstring必填RGB 颜色,格式为 #RRGGBB,恰好 6 位十六进制数字。
guidance.<role>.beam_heightnumber必填光柱高度,有限数值,2–64 格。
guidance.<role>.beam_radiusnumber必填光柱半宽,有限数值,0.15–4 格。
guidance.<role>.visible_distancenumber必填玩家到目的地的最大显示距离,有限数值,8–512 格。光柱与标记接近此距离时淡出。
guidance.<role>.through_wall_distancenumber必填标记与距离文字的穿墙显示距离,有限数值,0–visible_distance 格。0 关闭穿墙显示;光柱始终进行世界深度测试。
guidance.<role>.billboard_heightnumber必填标记高于目的地的位置,有限数值,0.5–16 格。
scenesobject必填恰好包含 reveal、contact、construction、portal、portal_return,5 个场景 ID 互不重复。
dialoguesobject必填恰好包含示例中的 25 个路线键,对话 ID 互不重复。
questsidentifier 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_resumeend_ready只允许该玩家在圆盘开始创建;end_wait保留已听邀请的记录
body_invitation_teamend;统一说明构筑,再分别打开个人决定
creation_choiceend_ready只允许该玩家在圆盘开始创建;end_wait暂缓
first_steps、first_steps_teamend_receive 表示确认收下。每名玩家完成角色创建后单独收到整套物资。
departure、departure_team、return_requestend_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 字段类型默认值约定
BlockedWhencompound无缺失或非复合类型时不阻挡;有效复合谓词阻挡匹配的生存玩家。
BlockedWhen.requiresstring list复合内必填必须全部已记录,最多 64 个不重复命名空间 ID,每个最多 256 字符;空列表不要求事实。
BlockedWhen.excludesstring list复合内必填均不可已记录;限制相同,与 requires 重叠时拒绝。

列表类型错误、重复 ID 或无效标识符拒绝。内置空气墙要求加入章节,并排除全景完成和旁路,因此玩家各自看完全景后通过。活动玩家从开场区域坠落会返回制作的出生平面,已完成事实保留。

校验

准入还检查场景定义、已注册对话、个人主线任务作用域、锚点边界及已放置结构指纹。资源拒绝或不可用时停用章节准入,普通角色创建与初始授予仍可用。不同指纹的原型存档不迁移,应使用新的匹配世界。

重载

描述重载先清除旧定义,再读取当前资源;替换数据无效时关闭可用状态,不保留过时定义。未完成玩家在服务端协调,旁路移除其仍活动的章节日志条目。内容变更后,现存场景和实体呈现仍需游戏内检查中断与重连。

相关页面