
You are viewing a potentially older version of this package. View Latest Version
forcejoin
China 解决中途加入卡加载问题,强行加入游戏(在允许的情况下)适用于大部分问题 提升90%成功率,首次需自行配置!ForceJoin — 强行加入房间(客机侧 prefab 兜底)
R.E.P.O. / BepInEx 5 / HarmonyX。仅客机侧生效,房主装不装都一样。
为什么要写它
《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 路径与断开原因 |
验证方法
- 启动游戏,看
BepInEx\LogOutput.log是否出现:[ForceJoin] 已加载 v1.0.0,补丁 8 个成功 / 0 个失败。若显示"补丁 N 个失败",说明某个目标方法签名没对上。 - 尝试中途加入房间,然后检索日志:
[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=... 覆盖即可,不必改工程文件。