常见问题
安装与启动
面板启动后打不开
- 确认面板进程仍在运行。
- 确认访问地址与端口正确，默认
http://127.0.0.1:18233。 - 确认访问范围设置允许当前来源。
- 查看
logs/中是否有端口占用或权限错误。
端口被占用
面板端口、守护进程端口或插件端口可能被其他程序占用。修改面板端口后重启；插件端口会自动顺延。
忘记初始账号
初始账号在首次启动日志中输出。若日志已丢失，可停止面板后按维护工具说明重置管理员账号。
实例
实例启动后立即退出
查看实例日志。常见原因是服务端路径错误、内存不足、配置损坏或模组冲突。
导入实例后找不到世界
确认所选目录包含 Worlds 目录。若服务端目录结构不同，可手动填写世界目录路径。
实例状态显示异常
守护进程与实例通信中断时会显示离线。等待自动重连，或重启面板与守护进程。
玩家
玩家列表为空
- 确认插件已加载并连接。
- 确认实例正在运行。
- 确认
PlayerEntities目录存在。 - 查看面板日志中的目录解析结果。
背包不显示
玩家处于创造模式时，面板会隐藏背包卡片。切换为生存模式后重新打开玩家详情。
操作失败或超时
确认账号具备玩家管理权限，实例插件在线，且玩家仍在线。离线玩家部分操作不可用。
AI 助手
助手无法调用某个功能
在工具清单中确认该工具的开关与权限。默认关闭的工具需要手动开启。
助手反复尝试错误方式
工具被拒绝时会返回原因。若助手仍重复尝试，可在对话中明确要求它先说明缺少哪个工具。
审批被拒绝
查看拒绝理由，调整请求或改为人工审批。
网络与实时数据
远程访问时数据刷新很慢
- 反向代理需关闭响应缓冲（
proxy_buffering off或flush_interval -1）。 - 确保 HTTPS 终结层未对
text/event-stream做压缩或缓存。 - 确认客户端与面板之间没有额外的代理层。
页面加载慢
首次加载会下载前端资源，后续由浏览器缓存。若持续缓慢，检查网络链路与代理配置。
升级与数据
升级后需要重新登录
升级会保留会话文件；若安装脚本重置了会话，需要重新登录。这是预期行为。
升级后插件提示版本不一致
在实例详情页重新安装插件并重启实例。
备份可以跨版本恢复吗
可以。备份是实例目录的完整打包，与面板版本无关。
反馈问题
提交 Issue 时请附上：
- 面板与插件版本。
- 操作系统与服务端类型。
- 相关日志片段。
- 复现步骤与预期结果。
仓库地址：Gitee 公开仓库