中途随时加入 / LateJoinNow

REPO 游戏交流 QQ 群：824639225

支持 R.E.P.O. v0.4。

功能说明

让朋友在游戏进行中也能加入你的房间，不必等卡车阶段或回到大厅。支持三个游戏场景：卡车、商店、关卡，每个场景都可以单独控制是否允许中途加入。

主机端额外提供：

新玩家加入时弹一次菜单提示，告知你谁进了房
屏幕左下角小信息框：当前场景允许加入时显示房间类型、房间名称、当前人数，纯文字（无背景），字号和透明度可调
公开房名自动加 [游戏中] 前缀，让其他玩家在服务器列表里一眼看出这个房间支持中途加入
切换场景时自动关闭房间 5 秒，避免陌生人正撞上加载窗口造成卡死；5 秒后自动恢复

兼容性提示

请不要与其他任何中途加入类的模组同时启用。本模组的实现更先进、状态同步更完整，与其他同类模组共用会因为重复的 RPC 重发与缓存清理产生冲突，导致玩家卡加载、地图错乱、无法操作等奇怪问题。

已知限制

LateJoinNow 当前为单端模式——只主机装 mod，朋友不需要装任何东西。这种模式下：

✅ 朋友能加入主机正在进行的关卡
✅ 朋友能正常操作（移动、互动、捡道具）
✅ 中途加入的玩家可以同步当前的所有状态
⚠️ 加载界面停留较长（约 10 秒）
⚠️ 部分场景下地图存在房间不可达
- 原因：客户端原版 LevelPoint 连接图算法对实例化顺序敏感，延迟方案无法完美解决
- 表现：朋友能进游戏但部分房间走不进去；继续打到下一关时新关卡完全正常
- 彻底解决需要双端都装 mod（已规划，后续版本提供）

版权声明

本模组为独家原创作品，禁止未经授权复制、移植或转载任何相关代码，违者将进行投诉处理。

配置说明

分组	配置项	默认值	说明
A.全局设置	模组启用	开启	总开关，关闭后模组完全失效
A.全局设置	公开房名加前缀	开启	创建自定义名字的公开房时，服务器列表里的房间名自动加上"[游戏中]"前缀
A.全局设置	公开房显示在公共列表	开启	公共房随中途加入开放时也出现在公共列表，可被陌生人随机加入；关闭则只接受邀请加入
A.全局设置	新玩家加入弹窗通知	开启	每次有玩家中途加入，主机收到一次菜单弹窗提示
B.场景白名单	允许在卡车阶段加入	开启	玩家在卡车里休整时是否允许中途加入
B.场景白名单	允许在商店阶段加入	开启	商店阶段是否允许中途加入
B.场景白名单	允许在关卡进行中加入	开启	普通关卡（搜刮、跑路过程中）是否允许中途加入
C.房间信息显示	启用房间信息HUD	开启	当前场景允许中途加入时，左下角显示一个小信息框
C.房间信息显示	显示房间类型	开启	第 1 行：公开服务器 / 私人服务器 / 匹配房间 / 单人模式
C.房间信息显示	显示房间名称	开启	第 2 行：公开/匹配显示房间名，私人显示"仅限好友加入"，单机显示"无"
C.房间信息显示	显示房间人数	开启	第 3 行：当前人数 / 最大人数（例如 3/6）
C.房间信息显示	字体大小	16	HUD 文字大小，10–28
C.房间信息显示	文字透明度/%	80	HUD 文字整体透明度，20–100
D.调试	详细日志	开启	测试阶段建议保持开启。开启后会在 BepInEx 控制台输出更多关键路径日志（关卡切换、玩家加入、缓存清理、Hook 触发等），便于排查问题。正式发布前会改为默认关闭

Configuration

Friends can join your room at any point during the game — no need to wait for the truck phase or return to the lobby. Supports three scenes: Truck, Shop, and Level. Each scene can be toggled independently.

Additional host-side features:

A popup notification whenever a new player joins, telling you who just came in
A small info box in the bottom-left corner showing room type, room name, and current player count — plain text, no background, font size and opacity adjustable
Public room names automatically get a [In Game] prefix so other players can tell at a glance that this room supports mid-game joining
When switching scenes, the room is automatically closed for 5 seconds to prevent strangers from joining during loading; it reopens automatically after 5 seconds

Compatibility

Do not enable this mod alongside any other late-join mod. This mod uses a more advanced implementation with more complete state syncing; running multiple late-join mods together causes conflicts in RPC resends and cache cleanup, leading to stuck loading screens, broken maps, frozen players, and other strange issues.

Known Limitations

LateJoinNow currently runs in host-only mode — only the host needs the mod, friends do not need to install anything. In this mode:

✅ Friends can join a level already in progress
✅ Friends can move, interact, and pick up items normally
✅ Late joiners automatically sync all current game state
⚠️ Loading screen stays up for a while (around 10 seconds)
⚠️ In some scenes, certain rooms may be unreachable on the map
- Cause: the vanilla LevelPoint pathfinding algorithm is sensitive to instantiation order; the delay-based workaround cannot fully solve this
- Effect: friends can enter the game but some rooms may be inaccessible; the next level will be completely normal
- A full fix requires both host and client to have the mod (planned for a future version)

Copyright Notice

This mod is an exclusive original work. Copying, porting, or redistributing any part of the source code without permission is strictly prohibited. Violations will be reported.

Settings

Group	Setting	Default	Description
A. Global	Mod Enabled	On	Master toggle — disabling this turns off all features with zero performance cost
A. Global	Public Room Name Prefix	On	Adds "[In Game]" prefix to custom-named public rooms in the server list, so others know this room supports mid-game joining
A. Global	Show Public Room in List	On	Keep public rooms visible in the public server list while late join is active; turn off to accept invite-only
A. Global	Player Join Notification Popup	On	Show a menu popup to the host whenever a player joins mid-game
B. Scene Whitelist	Allow Join in Truck (Lobby)	On	Allow joining while players are resting in the truck
B. Scene Whitelist	Allow Join in Shop	On	Allow joining during the shop phase
B. Scene Whitelist	Allow Join in Level	On	Allow joining during a regular run level (looting, escaping)
C. Room Info HUD	Enable Room Info HUD	On	Show a small info box at the bottom-left of the screen when late join is allowed in the current scene
C. Room Info HUD	Show Room Type	On	Line 1: Public Server / Private Server / Matchmaking / Singleplayer
C. Room Info HUD	Show Room Name	On	Line 2: room name for public/matchmaking; "Friends Only" for private; "N/A" for singleplayer
C. Room Info HUD	Show Player Count	On	Line 3: current / max players (e.g. 3/6)
C. Room Info HUD	Font Size	16	HUD text size, range 10–28
C. Room Info HUD	Text Opacity / %	80	HUD text opacity, range 20–100
D. Debug	Verbose Log	On	Recommended during testing. Outputs detailed logs (scene changes, joins, cache clears, hook triggers) to the BepInEx console. Will default to off in stable releases