中途加入 Simple / LateJoinSimple

REPO 游戏交流 QQ 群：573485890

版权声明

原作：中途立即加入 / LateJoinNow，作者 （Zichen）。
本模组：LateJoinSimple 在获得原作者许可的前提下，基于 LateJoinNow 1.1.0 接手修复与继续维护的版本，由 cn_xc 维护，非原作官方发行。
原作声明照录：

本模组为独家原创作品，禁止未经授权进行代码复制、二次打包移植或转载，违者将依法进行维权投诉。
未经原作者与维护者许可，请勿复制、二次打包、移植或转载本模组代码。

⚠️ 测试版说明（v0.3.0）

这是一个公开测试版。作者这边没有人可以稳定双端联机测试，所以先放出来，希望大家帮忙验证：

中途加入主流程已实测可用（排队 → 场景 / 物品 / 宝物 / 状态同步 → 落地动画 → 移动检测通过）。
联机细节仍可能存在未知问题，欢迎反馈。
反馈请附日志：BepInEx/LogOutput.log（或 BepInEx 控制台），并说明是房主端还是加入者端。
本版相关修复：不再销毁带铰链的门（原版会销毁，可能导致加入者看到「只有门框、门没了」）。
本版新增：房间可见性同步（需双端都装）——房主把本局已探索的房间发给中途加入者，修的是游戏内地图（DirtFinder）上的房间揭示；并新增光照守卫，拦截光照系统异常以免整片房间不发亮。
本版新增：虚空修复（针对加入者这边的缺墙 / 门框里没有门 / 虚空房间）——WallDoorRefresh（默认开）：房主连接到达后重算每个模块的墙与门道具；LevelPointRelink（默认开）：按几何补链接关卡连接点；RoomConnectionRebuild（默认关，实验）：另按关卡布局推算补建房间连接；NavMeshRebuildOnJoin（默认关）：补建过连接后在本机重建一次导航网格。

✨ 功能

随时中途加入：朋友可以在卡车 / 商店 / 关卡进行中加入你的房间，三个场景可分别用配置控制。
房主权威：场景同步全部由房主执行，加入者只接收，避免状态污染。
同步内容：地图模块（墙体 / 内饰连接）、贵重物品价格与发现状态、物品属性，以及 22 项场景状态（撤离点、门禁、升级台、各类陷阱与宝物等）。
房间信息 HUD（仅房主可见）：左下角显示房间类型（含「可加入 / 已锁定」）、房间名称、当前人数；字号与透明度可调。
中途加入进度显示：等待连接 / 排队中 / 加载中 / 已中途加入。
公开房名自动前缀：创建公开房时自动加 [中途加入-小菜] 前缀。
切关冷却保护：切换场景时自动临时锁房，防止过渡阶段有人撞入。
双端协同优化：房主与加入者都装本模组时自动启用（加载更快、外观与语音自动刷新），HUD 中该玩家显示「（优化）」。
虚空兜底：地图分帧重发 + 20 秒移动检测，尽量避免加入者卡在虚空。
房间可见性同步（需双端都装）：房主把本局已探索的房间发给中途加入者，让你的游戏内地图（DirtFinder）与团队一致（与「缺墙」不是同一条线）。
光照守卫：拦截光照系统的异常，避免中途加入时房间整片发黑。
虚空修复（实验，默认全部关闭）：WallDoorRefresh（默认关）仅在连接确实变化时重算墙 / 门道具；LevelPointRelink（默认关）按几何补链接关卡连接点；RoomConnectionRebuild（默认关）按关卡布局推算补建房间连接；NavMeshRebuildOnJoin（默认关）在补建过连接后于本机重建一次导航网格。默认状态下本模组不会改动任何墙 / 门 / 通路的开关，与原始行为一致。
冲突自检：检测到其它「中途加入」类模组时弹窗警告。

📦 安装

确保已安装 BepInExPack。
将 LateJoinSimple.dll 放入 BepInEx/plugins。
启动游戏，模组会自动生成配置文件。

强烈建议：房主与加入者都装本模组（协同模式），可避免单端模式的已知问题（见下）。

⚙️ 配置

配置文件位置：BepInEx/config/cn_xc.LateJoinSimple.cfg

配置项	默认值	说明
`ModEnabled`	`true`	关闭后整个模组全部功能失效
`PublicRoomNamePrefix`	`true`	创建公开房时自动加 `[中途加入-小菜]` 前缀
`TeleportToHostOnJoin`	`false`	加入后传送到房主位置；房主死亡则传送到最近的存活玩家
`CoopMode`	`true`	双端都装同版本时启用协同优化
`AllowJoinInTruck`	`true`	卡车阶段允许中途加入
`AllowJoinInShop`	`true`	商店阶段允许中途加入
`AllowJoinInLevel`	`true`	关卡进行中允许中途加入
`HudEnabled`	`true`	左下角显示房间信息框（仅房主）
`ShowJoinStatus`	`true`	显示中途加入玩家的进度
`ShowPlayerCount`	`true`	HUD 显示当前 / 最大人数
`ShowRoomType`	`true`	HUD 显示房间类型（公开 / 私人 / 单人）
`ShowRoomName`	`true`	HUD 显示房间名称
`HudFontSize`	`16`	HUD 字号（10–28）
`HudOpacity`	`80`	HUD 文字透明度 %（20–100）
`VerboseLog`	`false`	输出详细调试日志（排查问题时可开）
`ShowConflictWarning`	`true`	检测到同类模组时弹窗警告
`模组版本号`	当前版本	只读，勿改：用于配置升级时自动重置
`NavMeshRebuildOnJoin`	`false`	仅在本地补建过房间连接后，于本机重建一次导航网格（不广播）
`RoomConnectionRebuild`	`false`	【实验】客机按关卡布局本地补建房间连接；出现墙体异常请关掉
`LevelPointRelink`	`false`	【实验】按几何补链接关卡连接点（可能给本不通行的位置补上连接，逐关观察后再常开）
`WallDoorRefresh`	`false`	【实验】仅在连接确实变化时重算墙 / 门道具（连接未变绝不翻开关）

⚠️ 已知问题

单端模式的「虚空门」（承自原版，尚未修复）

触发条件：只有房主装了本模组，加入者是原版。切换到下一个场景后会恢复正常。

虚空门：场景中用于阻隔区域的门可能变成虚空状态（门框还在、门没了）。原版 LateJoinNow 文档即记载此限制。
快捷栏限制：加入者可能无法把武器拿出 / 收进快捷栏。
部分建筑不可见：加入者可能看不到部分装饰性建筑，一般不影响玩法。

规避办法：让加入者也一起安装本模组（协同模式）。协同模式下这些问题不会出现。

其它

过渡期禁入：最后一个提取点完成 → 下一关加载完成前，模组会临时拒绝新玩家加入，这是设计行为。
网络要求：房主未开加速器时，加入者可能连接超时或卡在加载界面。
人数上限：建议与 MorePlayersSimple 搭配；房间人数上限的修改只在创建房间前生效。

❓ 常见问题

Q：这个能和 Zichen 的 LateJoinNow 一起装吗？ A：不能。两者 GUID 与房间属性键都不同，同时启用会出现重复 RPC 与缓存清理，导致卡加载 / 地图异常。请只保留一个。

Q：加入者的门框里没有门怎么办？ A：这是单端模式的已知问题（见上）。让加入者也装上本模组即可避免。

Q：怎么判断是不是协同模式？ A：HUD 里玩家名后显示「（优化）」即表示协同模式生效。

Q：改了配置没生效？ A：配置在启动时读取。模组检测到版本变化会自动把配置重置为默认值。

🙏 致谢

（ Zichen） —— 原作「中途立即加入 / LateJoinNow」的作者。本模组的全部核心逻辑、场景同步思路与踩坑经验均来自其 1.1.0 版本，并在其授权下继续维护。
本 README 中的功能说明与「已知局限」记录同样来自原作文档。

QQ群：573485890