BackroomsCompat
Backrooms 兼容补丁:修复关卡因缺少 LevelPathTruck 导致生成失败/退回主菜单、中途加入因缺预制体整关失败、以及部分门音效缺失导致的每帧空引用刷屏。Edited · Nov 17, 2026
BackroomsCompat
让 Rogue-Backrooms 在当前版本的游戏里能正常进入的兼容补丁。
✅ 实测可用的模组配置
房主实测环境(当前实装 7 个)
| # | 模组 | 版本 | 说明 |
|---|---|---|---|
| 1 | BepInExPack | 5.4.2305 | 前置 |
| 2 | Rogue-Backrooms | 1.1.9 | 地图本体 |
| 3 | BackroomsCompat | 0.1.0 | 本补丁(必装) |
| 4 | Zehs-REPOLib | 4.4.0 | 低于 4.2.0 必崩 |
| 5 | cn_xc-LateJoinSimple | 0.9.3 | 中途加入用,双方版本必须一致 |
| 6 | cn_xc-MoreUIPanel | 0.2.0 | LJS 的硬依赖 |
客机(中途加入者)必须做到
| 要求 | 说明 |
|---|---|
| 装同一套会往关卡放东西的模组 | 至少:Backrooms + LevelGeneration + REPOLib(同版本) |
| 也装 BackroomsCompat | 补丁是本地 Harmony,不会自动同步 |
| 也装 LJS + MoreUIPanel(同版本) | 否则协同关闭、地图各生成各的 |
| 不要装房主没有的模组 | 例如 GameTools:会导致对象不一致,并带出 SingularityGroup.HotReload 报错 |
| REPOLib 版本一致 | 4.0.3 与 4.4.0 混用会直接 missing prefab |
解决什么问题
当前版本的游戏在生成关卡时,EnemyDirector.FirstSpawnPointAdd 会直接取 LevelGenerator.Instance.LevelPathTruck.transform:
Vector3.Distance(item.transform.position, LevelPathTruck.transform.position);
而 Backrooms 是自定义关卡,没有卡车路径点(LevelPathTruck == null),于是:
NullReferenceException → level loading failed → leaving to the menu
单人也会这样
第三处修复:中途加入不再整关失败
中途加入时,房主的「实例化关卡模块」RPC 可能比客机本地加载完更早到达,于是 MultiplayerPool 找不到预制体 → InstantiateFailed 抛异常 → 整个关卡生成失败、退回主菜单(表现就是「一时能进一时不能进」)。
补丁把「抛异常终止关卡」降级为「跳过这个对象 + 记一条日志」:
[Warning:BackroomsCompat] [跳过缺失对象] 客机本地还没有这个预制体,已跳过而不是终止关卡:Level/Level - Backrooms/…
关卡仍会继续进入(客机可能缺少量物件),而不是全员被踢回主菜单。
该行为只在 Backrooms 关卡生效;其它关卡保持游戏原生逻辑(缺预制体仍然会失败)。
另一处修复:空音源刷屏
Backrooms 里部分铰链门的 Sound.Source 是空的/已销毁,Sound.PlayLoop 每帧访问 Source.clip 会抛空引用(实测一局 3400+ 次,日志被撑到 2.4 MB)。
补丁会在这类调用前直接跳过 → 正常音效不受影响,报错归零。
已实测
[Warning:BackroomsCompat] 关卡缺少 LevelPathTruck,已用兜底刷新点:Top
出现这行日志、且关卡正常生成完毕,就说明补丁生效了(实测可进入 Backrooms)。
怎么修
在 EnemyDirector.FirstSpawnPointAdd 前面加一层判断:
LevelPathTruck存在 → 走游戏原生逻辑(原版关卡完全不受影响)- 不存在(Backrooms 这类自定义关卡)→ 用任意可用的
LevelPoint兜底作为首刷点,跳过原生逻辑,避免空引用
日志会打印一次:
关卡缺少 LevelPathTruck,已用兜底刷新点:xxx
安装
把 BackroomsCompat.dll 放进 BepInEx/plugins/(或任意子目录),确保同时装了 Rogue-Backrooms。
依赖
| 依赖 | 说明 |
|---|---|
| BepInEx 5.4.x | 必需 |
| Rogue-Backrooms 1.1.9 | 被兼容的目标模组 |
说明
- 只影响「缺少 LevelPathTruck」的关卡,原版关卡逻辑不变
- 敌人首刷点会退化为「就近任选一个可用点」,对玩法影响很小
