
forcejoin
China 解决中途加入卡加载问题,强行加入游戏(在允许的情况下)适用于大部分问题 提升90%成功率,首次需自行配置!ForceJoin — 强行加入房间(客机侧 prefab 兜底)
R.E.P.O. / BepInEx 5 / HarmonyX。仅客机侧生效,房主装不装都一样。
当前版本 1.0.1。相比 1.0.0 修掉了一个致命缺陷(补丁一个都挂不上,见下节),并新增「模块同步停滞强行放行」。
v1.0.1 修复:1.0.0 其实一个补丁都没挂上
1.0.0 的日志会出现:
[ForceJoin] 已加载 v1.0.0,补丁 0 个成功 / 0 个失败。
0 个成功 / 0 个失败 不是"没事可做",而是一个补丁都没挂上,模组等于空壳。
原因在 Awake 里的类型筛选:
if (!type.IsClass || type.IsAbstract) continue; // ← 1.0.0 的写法
C# 的 static class 在 IL 里是 abstract sealed,反射读到的 IsAbstract 恒为 true,
而 8 个补丁类全部写成 internal static class,于是被这行整体过滤掉,循环一次也没进。
1.0.1 改为不判 IsAbstract,只按"Harmony 标注"筛选,并保留逐类 try/catch 统计失败数。
正确日志(1.0.1):
[ForceJoin] 已加载 v1.0.1,补丁 8 个成功 / 0 个失败。
[ForceJoin] 模块同步看门狗已启动。
卡加载真正的卡点:ModulesSpawned 永远不会自增
反编译 LevelGenerator 确认,关卡生成结束后会卡在下面这个循环:
while ((SemiFunc.IsMultiplayer() && !moduleAmountReceived) || ModulesSpawned < ModulesSpawnedTarget)
{
State = LevelState.ModuleSpawnLocal;
yield return new WaitForSeconds(0.1f);
}
而 ModulesSpawned 全游戏只有一处自增,在 Module.ConnectionSetup() 里:
LevelGenerator.Instance.ModulesSpawned++;
ConnectionSetup() 由 Module.ModuleConnectionSet() 发起的 ModuleConnectionSetRPC 触发,
该 RPC 用的是 RpcTarget.All(非 Buffered)。这意味着:
- 房主生成关卡时,已经连上的客机能收到 RPC,计数正常增长;
- 中途加入的客机加入时,这些 RPC 早就发完了,且不会补发 —— 客机
ModulesSpawned永远是 0, 于是永久卡在加载界面。典型日志:ModulesSpawned=0/目标 20,伴随大量Received RPC "ModuleConnectionSetRPC" ... but this PhotonView does not exist!。
1.0.1 新增 ForceJoinModuleSpawn 看门狗处理这一段(仅客机、仅模块同步阶段、仅未生成完成时动作):
- 停滞 2 秒后,给本地所有
SetupDone == false的Module补跑一次ConnectionSetup(), 让ModulesSpawned按本地实际模块数正常增长; - 停滞超过
ForceGraceSeconds(默认 8 秒)仍不达标,直接把ModulesSpawned顶到ModulesSpawnedTarget放行;若连房主的ModuleAmountRPC都没收到,则跳过数量检查。
强行放行的代价:房主在关卡内中途加入时,客机本就拿不到连接数据, 补进来的模块边角/门/坠落面可能不完整。这是原版协议决定的,不是模组能补全的。
为什么要写它
《R.E.P.O.》里"加入不了房间"在本机日志上实际有两种完全不同的形态:
| 形态 | 日志特征 | 原版行为 |
|---|---|---|
| 卡加载 | 长时间停在加载界面,NetworkManager.StuckInLoading() 25 秒后可由玩家按 Back 手动退出 |
不自动踢 |
| 生成失败 | Joined room 成功后几秒内 Leave to Main Menu |
强制踢 |
生成失败的唯一入口是 LevelGenerator.GenerationFailed(Exception),它内部调
NetworkManager.TriggerLeavePhotonRoomForcedStuckInLoading() 把客机送回主菜单。
而触发它的常见原因(反编译确认)是客机侧拿不到房主下发的 prefab:
LevelGenerator.PrefabsLoad里"couldn't load prefab..."/"missing asset bundle for prefab..."—— 本机Resources和已加载 AssetBundle 里都没有房主要求的那个 prefab。MultiplayerPool.InstantiateNew→InstantiateFailed—— 只有"多人 && 非房主 && 关卡未生成"时才踢,房主缺 prefab 不会踢。MultiplayerPool.SpareTake抛"module copy is not ready..."/SparesCollect抛"module copy did not finish correctly..."—— 房主下发了模块路径,本机异步预拷贝还没完成。LevelGenerator.SpawnModule里"couldn't spawn module ..."。
本模组把这 4 条全部堵住。
做了什么
| 补丁目标 | 行为 |
|---|---|
LevelGenerator.PrefabsLoadRPC (Prefix) |
房主下发整批路径时,先确保 MultiplayerPool.ResourceCache 每个 path 都有对象:真资源优先(Resources → 已加载 AssetBundle),实在没有就塞一个 inactive 空占位 prefab(带 PhotonView,ViewID=0,DontDestroyOnLoad)。这样 PrefabsLoad 永远不会抛。 |
MultiplayerPool.Instantiate (Prefix) |
任何一次网络实例化前再确认一遍,覆盖不走 PrefabsLoadRPC 的零散实例化。 |
MultiplayerPool.InstantiateNew (Postfix) |
万一仍返回 null,用占位实例顶上,避免 PUN 报 Failed to network-Instantiate 后下游 transform/GetComponent 空引用。 |
MultiplayerPool.SpareTake (Finalizer) |
吞掉"模块副本未就绪",返回 null,让 Instantiate 回落到现场实例化,而不是中断关卡生成。 |
MultiplayerPool.SpareAddAsync (Finalizer) |
吞掉预拷贝失败。 |
MultiplayerPool.InstantiateFailed (Prefix, return false) |
拦截"缺 prefab 就踢人"这最后一步。 |
NetworkManager.OnDisconnected (Prefix) |
只打日志,记录断开原因,方便区分"被踢"和"房主关房/超时"。 |
LevelGenerator.GenerationFailed (Prefix) |
默认关闭(SwallowGenerationFailed=false)。开启后会吞掉生成失败,人不会被踢,但协程已被打断,关卡会停在半成品状态,只用于诊断。 |
覆盖不到的部分(重要)
- 房间层问题客户端无解:房间已关、满员、密码变更、房主退出、Photon 区域/版本不匹配 —— 这些在你还没
Joined room之前就失败了,任何客户端模组都改不了。 - 关卡模块(Module)prefab 缺失救不回来:如果双方游戏本体 mod 的关卡集不一致(比如房主装了自定义地图/关卡模组),缺的是一整格房间的模块 prefab。占位后
SpawnModule拿到的是一格空壳,LevelGrid[x,y].module有值但房间里什么都没有 —— 结果是地图缺一段,可能走不通/掉出地图。这不是被踢,但也进不了图。 - 装饰/道具/敌人类 prefab 缺失能救:这类占位后只是少个物体,游戏照跑,下一关重新生成时会按当时下发的内容重新同步 —— 也就是你说的"数据不同会在下一关自动同步"。
- 占位物不会跟随对端的 RPC:形如
Received RPC "XXX" for viewID N but this PhotonView does not exist!的警告仍会出现,那是 PUN 丢弃无关消息,不是本次失败原因。
安装
- 先装好 BepInEx 5(BepInExPack 5.4.21 及以上)。游戏目录里还没有 BepInEx 的,先裸启动一次游戏让它生成目录结构。
- 把
ForceJoin.dll放进游戏目录下BepInEx\plugins\里的任意子目录,例如plugins\ForceJoin\。 完整路径形如<你的 Steam 库>\steamapps\common\REPO\BepInEx\plugins\ForceJoin\,盘符和库位置取决于你自己的安装,不需要与开发机一致。 - 客机侧安装即可生效,房主装不装都一样,两端不需要装同一个模组。
- 除 BepInEx 外没有其它前置模组依赖,插件子目录名字可以随意取。
跨机器通用性
- DLL 内没有任何硬编码路径,也不读写本机文件;不依赖开发机的目录、盘符或 Steam 库位置。
- 配置文件由 BepInEx 自己在
<游戏目录>\BepInEx\config\Aartyns.REPO.ForceJoin.cfg生成,路径随游戏安装位置变化,与模组无关。 - 只依赖 BepInEx 与游戏本体程序集(
Assembly-CSharp、Photon*、UnityEngine.*),不引用任何第三方模组。 - prefab 路径全部来自房主运行时下发,模组自身不带资源文件,因此把 dll 复制到任何一台机器行为一致。
配置(首次运行自动生成 BepInEx\config\Aartyns.REPO.ForceJoin.cfg)
| 键 | 默认 | 说明 |
|---|---|---|
FillMissingPrefabs |
true | 缺失 prefab 用占位补齐 |
SuppressInstantiateKick |
true | 拦截 InstantiateFailed 踢人 + 模块副本异常 |
SwallowGenerationFailed |
false | 吞掉 GenerationFailed(危险,仅诊断) |
Verbose |
true | 打印补齐的 prefab 路径与断开原因 |
ForceModuleSpawn |
true | 客机模块同步停滞时补跑 ConnectionSetup 并强行放行,解决中途加入卡加载的主开关 |
ForceGraceSeconds |
8 | 模块同步停滞多少秒后强行放行,房间大时可调大 |
验证方法
- 启动游戏,看
BepInEx\LogOutput.log是否出现:[ForceJoin] 已加载 v1.0.1,补丁 8 个成功 / 0 个失败。必须是 8 个;若显示0 个成功 / 0 个失败,说明跑的还是 1.0.0 旧 dll,没替换成功。 若显示"补丁 N 个失败",说明某个目标方法签名没对上。 - 尝试中途加入房间,然后检索日志:
[ForceJoin] 本机 N 个 Module 未完成连接初始化(房主 RPC 未补发),已补跑 ConnectionSetup→ 命中本次修复的场景;[ForceJoin] 模块同步停滞 X 秒,ModulesSpawned A/B,已强制顶到目标数放行。→ 强行放行已生效,应能进关卡;[ForceJoin] 本机缺少 prefab,已用占位补齐: xxx→ 命中本模组要解决的场景,且已被兜住;- 完全没有
[ForceJoin]补齐记录但仍被送回菜单 → 失败不在 prefab 分支,需要换方向查(房间层 / LJN 版本冲突 / 超时类模组踢人); [ForceJoin] 连接断开,原因: xxx→ 看DisconnectCause具体值定位。
构建
dotnet build ForceJoin.csproj -c Release
# 游戏目录不在默认位置时覆盖 RepoDir:
dotnet build ForceJoin.csproj -c Release -p:RepoDir="E:\SteamLibrary\steamapps\common\REPO"
工程从 $(RepoDir) 读取游戏程序集(REPO_Data\Managed\*.dll 与 BepInEx\core\*.dll,Private=false,不拷贝依赖)。RepoDir 的默认值是开发机路径,换机器编译时用 -p:RepoDir=... 覆盖即可,不必改工程文件。