开场章节运行时
用个人事实协调瑟怜、过场、肉体构筑、初始物资和离庭。
internal.story.opening 下的控制器只在真实效果完成后推进个人剧情。IsekaiCore 保存事实并负责初始授予。资源约定见开场章节数据。
职业行囊在打开与领取时均检查个人的 DEPARTED 事实。服务器只接受当前报价中的一个方案,并检查玩家仍持有原行囊,定义自打开后未重载。 行囊格式
它做什么
新的生存玩家以灵魂光球抵达庭院,遇见瑟怜、构筑肉体、领取物资并穿门离庭。加入章节要求资源完整,且指纹与已放置庭院一致。内容缺失或无效、超平坦及调试世界保留普通开局;已经创建角色或领过初始物资的玩家不会新加入章节。
api.story 下的 OpeningChapterAPI 提供 prepareArrival、canCreate、creationDeferred、awaitingBody和tutorialsDeferred。可能改变状态的调用须在服务端线程执行,这些门槛接口不用于跳过剧情。
加入章节时会记录成功玩家,或具体回退原因及任务加载修订号。首次任务重载被拒绝后,目录为空;生效数据包中的任一无效任务都可能阻止本章加入。外部任务文件也必须更新到当前格式,不为缺失 scope 添加兼容默认值。IsekaiCore 同时在 Cardinal Components 元数据中声明 isekaicore:story。
运行时模型
OpeningMilestone 在 isekaiexpansion:chapter_01/ 下定义因果前置条件。活动开场要求 enrolled,排除 bypassed、departed。IsekaiCore 的 StoryAPI.complete 先检查前置条件再记录事实;仅向本人同步的持久化约定已对照 Core 0.4.0-build72 核对。
| 事实 | 必须完成的效果 |
|---|---|
enrolled、awakened | 资源及灵魂形态可用;抵达自白持续 400 刻(20 秒)。 |
reveal、contact_ready | 会话镜头验证所有参与者的检查点并完成。 |
contact、briefing、approach | 精确绑定的对话到达指定终点。 |
construction_ready、creation_offered、creation_allowed | 全员到达圆盘并完成镜头;玩家已回答邀请,另在构筑点确认开始创建。 |
body_built | 角色创建报告 COMPLETE;只打开界面不授予完成记录。 |
supplies_accepted、supplies_received | 玩家在对话中确认收下物资。实际到账单独记录,以本人背包成功收到整批物资为准。 |
supplies_explained、departure_briefed | 物资说明与离庭决定完成。 |
portal_ready、departed | 仪式结束且门可用;本人实际穿门抵达。 |
边界恢复每个服务端刻检查;呈现和日志协调每 20 刻(1 秒)运行。日志复用个人任务引擎,补齐目标激活前的已有事实,也可在离庭后完成最后一项。旁路只放弃本人个人档案中仍活动的章节任务;终态协调按剧情及任务修订号缓存。
OpeningSessions让一个固定名单的队伍独占共用的临时瑟怜。准入时记录庭院内同队、存活、非创造、非旁观且仍需完成开场的成员;单人使用自己的队伍键。其他队伍排队,后来入场的玩家不会扩大正在演出的名单。离线、死亡、旁路、离庭或更换队伍的成员退出等待条件。名单为空,或6000刻(300秒)没有进展且未持有对话界面时释放会话;活动过场也会刷新计时。个人事实在释放和重连后保留。
同一时刻只有一位发言人持有瑟怜的Blabber对话。在准入名单中的队长优先,否则由发起者代理。8条_team路线面向全队;OpeningAudience把服务端实际台词和已接受的回答通过本地化字幕发给其他成员,并标注瑟怜或发言人的名字。旁听者不打开NPC对话界面,也不占用她的动画。共享流程从全队最早未完成的检查点开始,开谈时全员须在瑟怜12格内。共享段落结束后为当前名单记录相应事实,但不会替队友写入身体完成或物资到账。
body_invitation_team只说明一次构筑方法,再给每位尚未完成的玩家打开独立creation_choice。个人确认没有NPC目标,也不播放她的表情;只有该玩家在圆盘选择end_ready才允许创建,end_wait保留暂缓状态,再与瑟怜交谈即可重新打开。场景门槛等待全员位置、身体和各自实际授予完成。发言人断线、死亡或离庭后,从剩余名单选人接替;未完成的段落可重开,已完成检查点保留。其他队伍收到等待字幕,不能占用她的对话或动画。
服务端推进钩子由Blabber0.5.1-build43提供:DialogueAPI.current读取当前数据对话快照,onAdvance订阅已接受的选择。快照保留翻译文本及会话身份;回调在动作之后、终点关闭之前执行。监听异常单独隔离,返回的句柄可取消订阅。开场通过公共API接入,不使用Blabber mixin。
约定
对话优先级
活动开场和返程会话在送礼、普通菜单之前接管瑟怜交互,并在称呼、关系及日常内容之前选择剧情。当前路线暂不可用时拒绝交互。离庭完成后,仅当玩家和瑟怜都在庭院内,普通菜单才增加return_portal;点击时再次检查当前位置,随后进入return_request。接受end_open后,申请由庭院内已完成离庭的同队成员组成的返程会话。
其他匹配的活动主线交谈目标也优先于普通菜单和称呼介绍。QuestNpcBridge 使用已有触发索引,保留归属及目标条件检查;按主线优先、storyOrder、任务 ID、目标 ID 排序,任务交谈菜单共用此顺序。npc_talk 只在 Blabber 报告匹配会话真正启动后推进;开场使用终点里程碑。
OpeningDialogue 核对玩家、NPC UUID、对话 ID、会话 UUID、当前路线、终点和 12 格以内距离。强制关闭不授予事实,需要继续的操作放到后续服务端刻。统一的OpeningContinuationQueue将每个邀请绑定到预期路由;手动或自动开始都会消耗邀请,路由改变则丢弃旧请求。共用对话先为所有接收者记录检查点,再决定续接路由。选择等待后,玩家可以自由活动,直到再次交互或新的完成效果请求对话。首次接触完成后记录相识,供以后普通对话使用,不额外授予关系奖励。
NPC大脑在准确匹配的章节对话进行期间使用相同的12格距离限制。OpeningDialogueSession核对当前会话UUID、演员UUID及对话ID;换成与瑟怜的另一段对话时不会继承范围。普通NPC交互仍限制在4格内。接触镜头结束时玩家距瑟怜约9.22格,启用她的AI后也不能立即关闭自动开始的首次交谈;AI与表情动作计时保持启用。
过场、创建与授予
开场自白与对话续接等待当前连接呈现就绪。预热期间可以先完成入章、灵魂形态和坠落保护;抵达自白的计时只在就绪后开始。过场准入使用同一条件,重新连接后同样需要等待。
章节镜头锁定输入和移动,禁用 Escape 跳过,使用 local_yaw 触发器枢轴。玩家选择器为 triggering_player,瑟怜为 nearest_type。每段结束前恰有一个 isekaiexpansion:chapter_01/complete 信号;两种开门镜头都在第 92 刻(4.6 秒)发出 isekaiexpansion:chapter_01/open_portal。
包含瑟怜的四段场景均为玩家配置覆盖整段的face指令,目标为她,局部偏移为[0, 1.2, 0];行走期间由移动逻辑优先控制朝向。GoddessSelene.bindOpeningActor保持AI启用,使用STAY及生成位置的驻留锚点,闲置偏航范围为±40°。场景占用暂停自主决策,但保留表情动作计时,使她在制作动作之外恢复待机、眨眼和转头。瑟怜仍是剧情会话拥有的临时演员,不使用部署令牌。Atelier中的标记用于制作预览,本次修改无需重新导出庭院结构。
首次离庭选择portal,返程会话选择独立的portal_return。两者使用开门位置作枢轴,并在第0刻强制播放瑟怜的isekaiexpansion:story_portal。重开版持续192刻(9.6秒):首镜围绕她的待机位置构图,注视目标绑定实际演员,第96刻(4.8秒)切到已成形的入口。她留在原位施法,动画结束后恢复待机朝向。返程镜头缺少首镜演员注视目标,或任一开门镜头缺少起始施法动作时,准入会拒绝该场景。
服务端在信号处检查每名参与者的阶段、场景及演员位置;推进还要求播放成功完成,且验证过的名单仍包含在观众中。取消、替换、演员缺失或效果失败均可重试,共享演员占用权阻止同时控制。章节根据事实主动恢复,不依赖触发方块的重播记忆。
单人选择end_wait记录creation_offered,之后进入creation_resume。多人在共享邀请后记录creation_offered,各自独立确认只控制自己的creation_allowed。两种等待都不重放前往圆盘的说明。章节事实晚于Origins的WaitForNextLayerScreen抵达时,客户端在延后创建期间关闭这个没有操作入口的交接界面,让前端就绪继续进行;获准后仍使用角色创建原有的恢复看门狗。
MorphAPI.startInitial 用章节专属来源和已有照明效果直接进入灵魂形态,清理只移除该来源。BASE、TRAIT、ORIGINS 和 FATE 创建路径共用门槛;打开界面不等于肉体完成。创建器使用不含灵魂变身的外观预览实体。
每名玩家完成角色创建、起源选择和命运确认后,服务器会将 IsekaiCore 登记的整套初始物资放入本人的背包。若尚未到账,服务器每 20 刻(1 秒)重试一次。背包已满、重连或别的队伍先通关,都不会消耗本人的领取机会。全员确认收下且各自物资到账后,瑟怜才开始向全队说明用途。
恢复与离庭
活动章节中的生存玩家受到坠落和虚空伤害保护。庭院内的普通着地不会传送玩家。离开维度、位置非有限、低于庭院原点 8 格或超出水平边界外扩 4 格时恢复。恢复停止镜头、关闭界面、解除骑乘、返回出生平面并清零速度和坠落距离,保留完成事实。创造和旁观玩家不受此约束;出生平面不可用时,本次会话停用章节并尝试普通出生恢复。
门为4 × 4格,颜色#B7E8E3,普通碰撞处理禁用。通行要求属于固定会话名单、仪式已结束、持有portal_ready、存活且非旁观、接触门并由正面穿向背面,移动距离平方小于16。后来加入的玩家及外队成员不能穿越。落点逐人复验,只有实际抵达才记录departed;门保留给尚未通过的成员。已有portal_ready的会话可恢复已激活的入口,无须重播仪式。
离庭通过WorldGateAPI.findOneWayDestination在主世界查找出口。先尝试已登记的空频道世界门,包括已有配对的门,再搜索8192格内的天然世界门遗迹。每刻最多请求2个区块、判断1个地形候选,2400刻(120秒)后超时;目的地区块票保留到会话释放。落脚空间被堵时,在同一次搜索中排除该门。穷尽候选后等待200刻(10秒)重试并提示失败,不依赖庭院正下方存在陆地,也不使用未检查的落点。
该入口不会修改目标世界门的持久配对,也不建立返回庭院的反向通道。WorldGateAPI.findArrival复用普通世界门的干燥支撑与身体净空检查。首次离庭和后续返程共用此单向服务,返程不会再次发放初始物资。
教程资格会等待两段告别字幕结束。第二段在140刻(7秒)后发送,指定阅读时长为6500 ms。客户端还会等待带键字幕的实际计时结束,包含阅读时长配置的缩放,才显示可选引导提示。登录和打开物品栏都不会启动教程;提示与长按操作见教程系统。
目的地渲染
OpeningGuidance 根据固定队伍名单共同完成的阶段,生成个人 StoryGuidanceTarget,不会记录里程碑或完成任务。苏醒后依次选择 reveal、瑟怜、construction,并在创建身体与领取物资期间保留构筑目的地;仪式完成且入口可用后才选择 portal。返庭会话选择自己的可用入口。不在当前会话、排队、离庭、死亡、创造或旁观状态的玩家没有目标;播放过场或进行对话时,服务器清除显示快照。
StoryGuidanceSync 随章节每 20 ticks(1 秒)检查一次,通过 isekaiexpansion:story_guidance 发送变化;目标不变时,每 100 ticks(5 秒)续期。客户端有效期为 200 ticks(10 秒)。断线或停服清理发送状态,更换玩家实体后重新发送。无效重载、离庭、失去会话资格时,在下一次检查中清除引导;标记不写入存档。
StoryGuidanceRenderer 只绘制一个面向镜头的四边形,共 4 个顶点,带距离及视锥裁剪,镜头靠近时减弱光柱。托管 story_guidance GLSL 着色器生成向上渐隐的明亮光芯、升腾光丝、柔和光晕与漂浮光点,不使用地面法阵、粒子发射器或颜色图集。Iris 开关均使用同一自定义材质,不交给光影包的信标程序替换。
半透明世界绘制完成后、第一人称手部覆盖深度之前,渲染器保存世界投影、模型视图矩阵、雾参数与场景深度。StoryGuidanceDepth 只保留一张全分辨率的 32 位深度纹理,不分配颜色目标、不读回 CPU;窗口尺寸变化时重新分配存储,连续 120 次空闲渲染回调或断线、停机时释放。Satin 的世界后处理回调使用该快照将四边形绘入最终场景,并在提交期间使用 AcceleratedRendering 原生管线适配。跳过 Iris 阴影阶段,预乘发光混合保留目标 alpha,COLOR_MASK 禁止深度写入。
片元着色器把天空清空深度视为无遮挡,拒绝近处场景表面,并柔化交界;保存的雾参数衰减光柱,也适用于水下。它不写入场景深度,也不修改光影包的水体渲染目标,但此世界后处理发光阶段不会重现光影包的水面折射。着色器缺失、帧快照过期或尺寸不匹配时不绘制。传送门目的地使用实际入口的位置与朝向,沿正面法线前移 2 格、高度不变,使光柱与文字离开门平面。
标记与 X m 文字使用 RetainedOverlay、ClientWorldOverlayRenderer.projectWorld,与伤害数字在同一入口发布。ModernUI 在世界渲染完成后绘制深色底的菱形和排版文字,不进入 Iris 世界泛光;传入 UI 线程的只有屏幕快照。超过配置的穿墙距离后,客户端每 tick 使用视觉形状射线检查墙体并忽略流体,不读取天空、水体或第一人称深度缓冲。界面、HUD/调试隐藏、过场、无效玩家状态和维度不匹配都会隐藏标记。
扩展方式
所属服务确认效果成功后再记录事实。持久化使用 StoryAPI,信号和完成使用 SceneAPI,日志投影使用任务引擎;不把临时演员或会话 ID 保存为章节事实。
同步更新描述文件、原生开发层、镜头信号和对话终点。原型结构包指纹变化后需要新的匹配世界,不提供旧进度或结构包迁移。
验证
- 运行
gradlew.bat -I tools/story/guidance.gradle checkStoryGuidance checkStoryGuidanceGpu,检查格式与样式、网络往返、队伍阶段、入口偏移,以及隐藏 OpenGL 上下文中的实际着色器与深度复制代码。覆盖天空、前后景深度、雾、手部覆盖深度、alpha/深度保留、缩放与释放。合成预览写入build/story-verification/guidance-preview.png,不等于游戏内光影包验收。 - 游戏内对照原版 Fast/Fancy/Fabulous、Iris 开关、Sodium 与 AcceleratedRendering,检查墙体、天空、光柱前后的水面、水下雾、强泛光包、GUI 缩放、资源重载、换维度与重连。确认文字清晰且不进入世界泛光,只有标记能在配置距离内穿墙。
- 运行
gradlew.bat -I tools/story/chapter-content.gradle checkChapterContent checkNpcDialogueRange,验证生产解析器、指纹、恢复边界、对话排序、精确会话身份,以及接触镜头指定站位的NPC距离检查。 - 运行
gradlew.bat -I tools/story/chapter-runtime.gradle checkChapterRuntime -PchapterPackData=<absolute-data-directory>,传入实例的数据目录(例如kubejs/data),检查合并任务目录、章节启用条件、Core 组件声明、Fabric 注册后的对话及网络编解码和原生方块实体 NBT。省略该参数只检查模组内置数据。 外部目录检查要求运行环境包含所有被引用的内容模组;开发环境缺少这些模组时,还须在目标实例执行/reload并核对任务加载结果。 - 运行
gradlew.bat -I tools/story/portal-admission.gradle checkOpeningPortal,验证穿越准入。 - 游戏中测试不同阶段的两名玩家、同队和非队长、首次交互、对话中断、重连、创建、满背包及他人的门。
- 分别拒绝创建、补给和离庭,等待后再交互,确认每个自动邀请只启动一次。创建完成后在庭院台阶跑动着地,不应触发恢复传送。
- 在多个阶段跳崖,确认返回出生点,事实保留,无残留锁或重复装备;用缺失资源和超平坦验证普通开局。
- 游戏中完整审看镜头与动画。数据和坐标检查不代表视觉及多人验收。