玩家管理
玩家管理依赖游戏插件。插件未安装或未连接时，页面会提示「暂无玩家」。
玩家列表
「玩家」页面分为在线与离线两部分：
- 在线玩家：来自服务端内存快照，包含名称、GUID、血量、模式与所在位置。
- 离线玩家：来自
PlayerEntities存档目录，可查看与编辑基础数据。
列表通过 SSE 实时更新，无需手动刷新。若无数据变化，页面不会重绘。
常用操作
| 操作 | 说明 |
|---|---|
| 踢出 | 断开玩家连接，玩家可重新加入 |
| 封禁 | 记录封禁并拒绝加入 |
| 击杀 | 使玩家死亡并触发重生流程 |
| 治疗 | 将血量恢复到满值 |
| 设置血量 | 按比例设置当前血量 |
| 游戏模式 | 切换创造、生存、冒险等模式 |
| 无敌 | 开关伤害免疫 |
| 清空背包 | 移除背包内全部物品 |
| 传送 | 传送到指定坐标 |
| 回出生点 | 传送到世界出生点 |
| 设置出生点 | 将玩家当前位置设为出生点 |
| 管理员 | 授予或移除管理员权限 |
| 体温/疲劳 | 调整生存状态数值 |
| 睡觉/唤醒 | 切换睡眠状态 |
所有操作都会写入审计日志，记录操 作者、目标玩家与结果。
背包
背包面板显示玩家当前的生存模式物品栏，支持查看与编辑槽位内容。
当玩家处于创造模式时，创造物品栏不属于正常背包数据，面板会隐藏整个背包卡片，避免展示不完整的物品信息。切换回生存模式后重新打开玩家详情即可看到背包。
离线玩家
离线玩家数据来自存档文件。可执行的操作包括：
- 查看名称、GUID 与最后更新时间。
- 编辑基础属性与出生点。
- 查看背包内容。
直接修改存档前，请先确认实例已停止或该玩家不在线，避免写入冲突。
白名单与权限
- 白名单用于限制可加入的玩家。
- 管理员权限对应游戏内管理员命令。
- 面板账号权限与游戏内权限相互独立，需分别配置。
数据来源与排查
如果「全部玩家」长期为空：
- 确认插件已加载，实例日志出现插件启动信息。
- 确认实例处于运行状态。
- 确认服务端存档目录中存在
PlayerEntities。 - 查看面板日志中
offline dir resolved一行，确认解析到的实际目录。
仍无法解决时，可在 Gitee 仓库提交 Issue，并附上面板日志与实例目录结构。