R.E.P.O.
You are viewing a potentially older version of this package. View Latest Version
Install with App

Details

Date Uploaded
Downloads
238
Size
34KB

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:

  1. LevelGenerator.PrefabsLoad 里 "couldn't load prefab..." / "missing asset bundle for prefab..." —— 本机 Resources 和已加载 AssetBundle 里都没有房主要求的那个 prefab。
  2. MultiplayerPool.InstantiateNew → InstantiateFailed —— 只有"多人 && 非房主 && 关卡未生成"时才踢,房主缺 prefab 不会踢。
  3. MultiplayerPool.SpareTake 抛 "module copy is not ready..." / SparesCollect 抛 "module copy did not finish correctly..." —— 房主下发了模块路径,本机异步预拷贝还没完成。
  4. 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 丢弃无关消息,不是本次失败原因。

安装

  1. 先装好 BepInEx 5(BepInExPack 5.4.21 及以上)。游戏目录里还没有 BepInEx 的,先裸启动一次游戏让它生成目录结构。
  2. 把 ForceJoin.dll 放进游戏目录下 BepInEx\plugins\ 里的任意子目录,例如 plugins\ForceJoin\。 完整路径形如 <你的 Steam 库>\steamapps\common\REPO\BepInEx\plugins\ForceJoin\,盘符和库位置取决于你自己的安装,不需要与开发机一致。
  3. 客机侧安装即可生效,房主装不装都一样,两端不需要装同一个模组。
  4. 除 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 路径与断开原因

验证方法

  1. 启动游戏,看 BepInEx\LogOutput.log 是否出现: [ForceJoin] 已加载 v1.0.0,补丁 8 个成功 / 0 个失败。 若显示"补丁 N 个失败",说明某个目标方法签名没对上。
  2. 尝试中途加入房间,然后检索日志:
    • [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=... 覆盖即可,不必改工程文件。

Thunderstore development is made possible with ads. Please consider making an exception to your adblock.