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.0 |
| Download link | Aartyns-forcejoin-1.0.0.zip |
| Downloads | 21 |
| Dependency string | Aartyns-forcejoin-1.0.0 |
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。仅客机侧生效,房主装不装都一样。
为什么要写它
《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=... 覆盖即可,不必改工程文件。