You are viewing a potentially older version of this package. View Latest Version
LateJoinSimple
中途加入：让朋友在卡车 / 商店 / 关卡进行中随时加入你的房间。基于Zichen的 LateJoinNow，在其授权下接手修复。中途加入 Simple / LateJoinSimple
REPO 游戏交流 QQ 群：573485890
版权声明
-
原作：中途立即加入 / LateJoinNow，作者 （Zichen）。
-
本模组：
LateJoinSimple在获得原作者许可的前提下，基于 LateJoinNow 1.1.0 接手修复与继续维护的版本，由 cn_xc 维护，非原作官方发行。 -
原作声明照录：
本模组为独家原创作品，禁止未经授权进行代码复制、二次打包移植或转载，违者将依法进行维权投诉。
-
未经原作者与维护者许可，请勿复制、二次打包、移植或转载本模组代码。
⚠️ 测试版说明（v0.1.1）
这是一个公开测试版。作者这边没有人可以稳定双端联机测试，所以先放出来，希望大家帮忙验证：
- 中途加入主流程已实测可用（排队 → 场景 / 物品 / 宝物 / 状态同步 → 落地动画 → 移动检测通过）。
- 联机细节仍可能存在未知问题，欢迎反馈。
- 反馈请附日志：
BepInEx/LogOutput.log（或 BepInEx 控制台），并说明是房主端还是加入者端。 - 本版相关修复：不再销毁带铰链的门（原版会销毁，可能导致加入者看到「只有门框、门没了」）。
✨ 功能
- 随时中途加入：朋友可以在卡车 / 商店 / 关卡进行中加入你的房间，三个场景可分别用配置控制。
- 房主权威：场景同步全部由房主执行，加入者只接收，避免状态污染。
- 同步内容：地图模块（墙体 / 内饰连接）、贵重物品价格与发现状态、物品属性，以及 22 项场景状态（撤离点、门禁、升级台、各类陷阱与宝物等）。
- 房间信息 HUD（仅房主可见）：左下角显示房间类型（含「可加入 / 已锁定」）、房间名称、当前人数；字号与透明度可调。
- 中途加入进度显示：等待连接 / 排队中 / 加载中 / 已中途加入。
- 公开房名自动前缀：创建公开房时自动加
[中途加入-小菜]前缀。 - 切关冷却保护：切换场景时自动临时锁房，防止过渡阶段有人撞入。
- 双端协同优化：房主与加入者都装本模组时自动启用（加载更快、外观与语音自动刷新），HUD 中该玩家显示「（优化）」。
- 虚空兜底：地图分帧重发 + 20 秒移动检测，尽量避免加入者卡在虚空。
- 冲突自检：检测到其它「中途加入」类模组时弹窗警告。
📦 安装
- 确保已安装 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 |
检测到同类模组时弹窗警告 |
⚠️ 已知问题
单端模式的「虚空门」（承自原版，尚未修复）
触发条件：只有房主装了本模组，加入者是原版。切换到下一个场景后会恢复正常。
- 虚空门：场景中用于阻隔区域的门可能变成虚空状态（门框还在、门没了）。原版 LateJoinNow 文档即记载此限制。
- 快捷栏限制：加入者可能无法把武器拿出 / 收进快捷栏。
- 部分建筑不可见：加入者可能看不到部分装饰性建筑，一般不影响玩法。
规避办法：让加入者也一起安装本模组（协同模式）。协同模式下这些问题不会出现。
其它
- 过渡期禁入：最后一个提取点完成 → 下一关加载完成前，模组会临时拒绝新玩家加入，这是设计行为。
- 网络要求：房主未开加速器时，加入者可能连接超时或卡在加载界面。
- 人数上限：建议与 MorePlayersSimple 搭配；房间人数上限的修改只在创建房间前生效。
❓ 常见问题
Q：这个能和 Zichen 的 LateJoinNow 一起装吗？ A：不能。两者 GUID 与房间属性键都不同，同时启用会出现重复 RPC 与缓存清理，导致卡加载 / 地图异常。请只保留一个。
Q：加入者的门框里没有门怎么办？ A：这是单端模式的已知问题（见上）。让加入者也装上本模组即可避免。
Q：怎么判断是不是协同模式？ A：HUD 里玩家名后显示「（优化）」即表示协同模式生效。
Q：改了配置没生效？ A：配置在启动时读取。模组检测到版本变化会自动把配置重置为默认值。
🙏 致谢
- （ Zichen） —— 原作「中途立即加入 / LateJoinNow」的作者。本模组的全部核心逻辑、场景同步思路与踩坑经验均来自其 1.1.0 版本，并在其授权下继续维护。
- 本 README 中的功能说明与「已知局限」记录同样来自原作文档。
QQ群：573485890