13 副本挑战：房间、冷却、区域保护与复活币
副本挑战是玩家组队进入指定挑战区域的玩法。
核心流程是：
房主发起并扣费 -> 其他玩家免费加入 -> 房主再次点击开始 -> 玩家被传送进副本 -> 完成或失败 -> 进入冷却示例视频预留
这里后续可放“创建副本并让玩家发起挑战”的视频，例如：/mp4/newwebdoc/13-challenge-flow.mp4
一、后台入口
后台 -> 挑战设置
玩家前端 -> 挑战后台管理副本配置，玩家前端发起或加入副本。
二、副本配置字段
| 字段 | 说明 |
|---|---|
| 挑战名 | 玩家看到的副本名称 |
| 挑战介绍 | 副本说明 |
| 图片 | 玩家前端卡片图 |
| 挑战扣款 | 房主发起时扣商城币 |
| 地点坐标 | 副本中心坐标 |
| 挑战范围 | 判断玩家是否在副本范围内 |
| 人数限制 | 房间最多人数 |
| 挑战代码内容 | 阶段执行的 RCON 代码或聊天提示 |
只有房主发起时扣款，加入挑战的人不扣款。
挑战代码常见格式：
关卡数,命令内容,是否添加玩家ID例如：
1,#teleport X=100 Y=100 Z=100,true
2,副本第二阶段开始,false是否添加玩家ID 为 true 时，系统会把参与玩家的 SteamID 追加到命令后面。适合传送、给物品、扣款、设置状态等需要目标玩家的命令。
三、创建和加入房间
玩家点击副本：
- 如果副本空闲：该玩家成为房主，并扣除挑战费用。
- 如果副本已被发起：其他玩家可加入。
- 如果玩家是房主并再次点击：开始副本。
如果房间设置了密码，加入玩家必须输入正确密码。
副本开始前，会通过聊天类型发送提醒，而不是 RCON 命令。
密码只用于加入房间，不会在玩家列表中明文展示。管理排查时只需要确认玩家输入是否正确，不建议把密码公开到世界聊天。
四、冷却机制
副本结束后，参与玩家进入冷却。
冷却配置通常包括：
- 房间开启超时秒
- 玩家完成冷却秒
- 玩家失败冷却秒
- 冷却价格
付费清冷却是按副本清除：只要有一名玩家支付，就会清除该副本当前有效冷却，其他玩家也可加入。
如果玩家说“别人清了冷却但我还不能进”，管理需要刷新页面并确认冷却记录是否已删除。
五、区域保护
副本挑战状态下，非副本玩家进入副本区域附近会受到保护规则影响。
可以理解为：
- 进入挑战范围外的警告带：发送警告提醒。
- 进入挑战范围更近的保护带：传送到副本区域外。
如果后台关闭区域保护，则不执行这套拦截。
区域保护用于防止路人干扰正在挑战的玩家。
副本区域保护与“区域规则/区域岛”不是同一套配置。副本保护只围绕正在挑战的副本生效。
如果玩家说“我路过被传走”，通常是副本正在进行且他不是参与者。
六、开始、失败和完成
副本正式开始时：
- 发送开始提醒。
- 记录玩家进入副本前坐标。
- 传送参与玩家到副本区域。
- 执行挑战阶段代码。
失败常见原因：
- 房主超时未开始。
- 玩家离开副本范围。
- 副本内无人存活。
完成后：
- 发送完成提醒。
- 发放奖励。
- 玩家获得复活币。
- 玩家可在世界频道发送
@使用复活币原地复活。
副本检测不是实时毫秒级，它依赖后台循环、在线玩家坐标和 RCON 队列。玩家刚离开范围或刚完成目标时，可能需要等待一小段时间才看到结果。
七、常见玩家问题
问：为什么我发起副本扣钱了，队友没扣？
答：这是正常逻辑。副本只扣房主发起费用，加入玩家免费。
问：为什么我加入不了加密副本？
答：需要输入房主设置的房间密码。
问：为什么我靠近副本被传走？
答：副本正在挑战中，非参与玩家进入保护范围会被传送出去，避免干扰挑战。
问：为什么提示冷却？
答：你最近完成或失败过该副本。可以等待冷却结束，或使用付费清冷却入口。
问：为什么我清了冷却，队友也能进？
答：当前设计是按副本清冷却。只要有人为这个副本支付清冷却，当前有效冷却会一起清掉，方便队伍继续挑战。
问：为什么副本开始后没有马上执行下一步？
答：副本状态、玩家坐标、RCON 发送都有后台轮询间隔。正常情况下稍等几秒即可，不建议重复点击。
八、管理排障检查表
- 副本状态是否卡在已发起。
- 房主是否在线。
- 人数限制是否已满。
- 房间密码是否正确。
- 冷却记录是否仍存在。
- 冷却价格是否大于 0。
- 区域保护开关是否按预期。
- 挑战坐标和范围是否配置正确。
- 挑战代码是否区分命令和聊天。
- RCON 队列是否正常发送。
- 在线玩家数据是否正常同步。
- 副本名称是否被修改过。运行中的副本不建议改名。
- 后台强制重置是否清理了房间、成员、密码、状态和冷却。