传送
传送是跨客户端、服务器、场景流送和关卡编辑器的完整项目。文档覆盖现行技术方案、策划配置规则、控制器两次重构记录(2026-09-07 结构拆分、2026-10-12 流程命令化与 V2 拆分)、编辑器 Action(行为)、过场序列时序与传送点功能。
项目总览
技术方案文档
策划侧阅读文档
重构 · 结构拆分
重构 · 流程命令化
编辑器专栏
同图安全等待
统一安全落位设计(延期)
流送与 WP · 代码实现
V2 表现 · Seq2 → Seq3 衔接
传送点
程序 / 技术
技术方案文档
完整说明同关卡传送、跨关卡传送、流送等待、多人栅栏、遮罩和过场序列。
同关卡跨关卡
策划 / 配置
策划侧阅读文档
只保留策划需要知道的选择规则、配置方式、画面表现、固定时长和限制,可独立分享。
可独立发送不展示本站导航
程序 / 重构(一)
重构 · 结构拆分
2026-09-07:把 TeleportController 从单文件拆为门面与六个子职责(表现、地面探测、同场景流程、过场序列、Seq3 绑定、转场编排),控制器从 3526 行收敛到 467 行。
2026-09-073526 → 467 行6 个子职责
程序 / 重构(二)
重构 · 流程命令化
2026-10-12:把传送表现从「大段回调」改为分阶段命令驱动,并把 4371 行的 V2 单体拆为流程 / 组装器 / 命令 / 协作类。
2026-10-1240 文件V2 单体拆分
编辑器 / Action
编辑器专栏
汇总 15 项传送关联 Action 的用途、参数、可用行为树 Context(上下文)、执行端和限制。
4 组行为多人落点
程序 / 同图收尾
同图安全等待
同图传送收尾从「满 15 秒就算完成」改为「落点地面确认可站」;不再设客户端退出上限,改每 100 秒红色告警,异常分支只记日志、不再退回登录。
每 100 秒告警实机未验证
程序 / 延期重构
统一安全落位设计
完整统一方案保留、暂不实施。2026-09-23 决定当前仅在现有落位后等站稳、Idle 和 Mesh 观察再撤普通黑屏;网络接管、目标预加载、跨图、Seq3 / V2 不改,全链单次权威提交仍待重构。
延期重构/暂不实施当前仅撤罩条件补丁实机待验收
程序 / 流送实现
流送与 WP · 代码实现
从八个代码文件出发,看一次加载或传送在流送线上排了哪些命令:控制器、命令组装、两盏灯、临时流送源、WP 命令链与三段式预加载。
8 个文件两盏灯三段式预加载
功能 / 传送点
传送点
说明传送点解锁存档、场景表现、地图标记、最近点检索与发起传送的完整链路。
解锁状态地图标记
V2 表现
传送 V2 流程的表现问题与过场时序,按「现象 → 阶段 → 耗时」组织;出问题时先在这里定位到段,再去对时间。
文档结构
| 文档 | 同关卡 | 跨关卡 | 适合谁看 |
|---|---|---|---|
| 技术方案文档 | 无缝传送、流送与贴地检查 | 完整加载、过场序列与场景切换 | 客户端、服务器、编辑器开发 |
| 策划侧阅读文档 | 何时使用、落点和表现怎么配 | 何时使用、关卡和进出表现怎么配 | 关卡策划、任务策划 |
| 重构 · 结构拆分 | 同场景状态、流送与落地探测拆出独立对象 | 过场序列、角色绑定与转场编排拆出独立对象 | 客户端开发、代码评审 |
| 重构 · 流程命令化 | 传送表现改为分阶段命令驱动 | V2 单体拆为流程 / 组装器 / 命令 / 协作类 | 客户端开发、代码评审 |
| 编辑器专栏 | 设置位置、出生位置与传送点解锁 | 跨关卡、进出副本与复活流程关联行为 | 关卡策划、编辑器与服务器开发 |
| 同图安全等待 | 地面确认才解锁与发 LoadDone,不设客户端退出上限 | 异常只记日志不退登;跨图 / 复活 / Bail 交接保留 | 客户端开发、卡 Loading 排查 |
| 统一安全落位设计(延期重构/暂不实施) | 完整三模式与坠落方案延期;当前仅现有落位后等站稳 / Idle / Mesh 观察再撤普通黑屏 | 跨图安全门与交接保留为未来设计;当前不改跨图、Seq3 / V2 | 客户端开发、后续重构参考;当前补丁需实机验收 |
| 流送与 WP · 代码实现 | 跟随灯 / 目标灯、临时流送源、命令链的加载与落地 | 三段式预加载(预加载 → 完成 → 还原 / 取消)与 DataLayer | 客户端开发、流送问题排查 |
| 传送 › V2 表现 › Seq2 → Seq3 衔接问题 | Seq2 循环退出与切场阶段顺序 | 换装 / binding 编译等待与落地收尾耗时 | 客户端开发、过场表现排查 |
| 传送点 | 解锁状态、场景表现与最近点检索 | 发起请求后交由传送主流程处理 | 客户端开发、关卡配置人员 |