故障排查

面板无法打开

确认游戏服务器正在运行、7DPanel Mod 已加载，且部署包包含 wwwroot/index.html。使用 data/config.json 中的主机和端口；默认客户端地址为 http://<服务器地址>:8088/。listenUrl 中的 + 是监听通配符，不是浏览器地址。若仍无法访问，请检查游戏服务器日志和宿主机防火墙。

登录失败或会话过期

使用已安装 Mod 的 data/config.json 中的当前用户名和密码。更改凭据后需要重启服务器。令牌刷新失败或 HTTP 401 会清除浏览器会话，此时重新登录。HTTP 403 表示当前请求被拒绝授权，而不是网络连接失败。

Steam 登录不可用

• 按钮禁用并提示地址不匹配时，将 publicBaseUrl 设置为页面显示的浏览器源站，重启游戏服务器后刷新。只修改前端地址不会修改回调。
• 没有可用的 Steam 入口时，检查 steamLoginEnabled、游戏注册状态及显式公开源站。仍可使用密码登录。
• 身份验证成功但拒绝访问时，确认玩家已加入过当前存档，且个人有效权限等级为 0。群组权限不足以获得资格。
• 外部验证失败时，检查游戏宿主机到 Steam 的出站 HTTPS 连接及所配置的 httpProxyUrl。已配置但不可达的代理不会回退到直连。

反向代理应让开始登录和回调使用同一浏览器源站，并原样转发 /oauth。重启后重新发起登录，未完成的尝试不会保留。参见面板连接设置。

游戏操作提示初始化中

API 可能先于游戏加载完毕开始响应。等待服务器就绪后刷新页面。可借助概览区分服务器仍在启动，还是单个数据面板出错。

找不到新数据

检查当前世界、存档以及页面筛选条件。玩家历史限定在当前世界和存档；备份记录列表则可能包含以前的存档。聊天消息发送后会异步保存到历史，可能略有延迟。先使用页面的刷新操作，再判断是否丢失。

无法在面板里恢复备份

这是预期行为：7DPanel 只记录供人工恢复的在线副本。按照备份中的步骤操作，并在替换游戏原生存档文件前停止游戏服务器。

商店商品缺失或购买结果不确定

商品缺失时，检查商店开关、商品启用状态、筛选及模组变更后原生定义是否仍已加载。管理目录保留定义不可用的商品供修复。交付异常时，打开订单详情，对照经济扣款、各动作结果和尝试证据。超时及部分交付可能意味着效果已生效；按商店中的步骤处理，不要反复购买或补发。

单个玩家的背包无法加载

损坏的存档背包会针对该玩家报错，不阻止无关查询。检查游戏日志及玩家原生存档文件，修复前保留备份。重置资料会删除数据且没有恢复接口，不应当作常规刷新操作。

玩家中心链接或登录码不可用

更新前端或 Mod 后应重连，以接收当前游戏界面。点击聊天输出链接前先打开聊天输入框。检查 publicBaseUrl、/player/* 前端回退及 /api、/oauth 代理路由。请求新码需要启用 7DPanel 聊天、公开源站可用且玩家在线。登录页会显示实际命令，登录选项查询失败时可重试。过期或已使用后应请求新码；六位短码两分钟内有效，只能使用一次。参见玩家中心。

购买或签到按钮不可用

阅读按钮旁的原因并刷新页面。检查经济开关、签到开关、账户查询错误、余额、商品冷却、每日额度及是否已在聊天领取奖励。两种操作都要求玩家在线。购买响应丢失后，应通过同一重试流程处理已保留的待确认请求，不要另发购买来绕过它。

传送记录为空或不可用

清除筛选并检查当前世界和存档。仅显示部署对应后端后记录的尝试，不包含控制台及其他 Mod 的传送。历史请求返回 404 时应部署匹配的前后端发布包。记录为空不能证明没有发生旅行。已接受记录不代表确认到达，参见传送。