Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
| Date uploaded | 3 days ago |
| Version | 1.0.1 |
| Download link | Aartyns-forcejoin-1.0.1.zip |
| Downloads | 36 |
| Dependency string | Aartyns-forcejoin-1.0.1 |
This mod requires the following mods to function
BepInEx-BepInExPack
BepInEx pack for Mono Unity games. Preconfigured and ready to use.
Preferred version: 5.4.2100cn_xc-LateJoinSimple
中途加入:让任何人在卡车 / 商店 / 关卡进行中随时加入你的房间。基于 Zichen 的 LateJoinNow,在其授权下接手修复、(新增商店外面,现在你可以走出商店探索)电池电量同步、撤离点锁定、虚空/模块同步修复、LateJoinNow 兼容。模组问题交流腾讯频道 #pd77525911。
Preferred version: 0.9.1README
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=... 覆盖即可,不必改工程文件。