Player Management
Player management requires the game plugin. If the plugin is missing or disconnected, the page reports that no players are available.
Player lists
The Players page contains online and offline sections:
- Online: live server snapshots with name, GUID, health, game mode and position.
- Offline: records from the
PlayerEntitiessave directory.
The list updates through SSE. The page does not redraw when nothing changed.
Common actions
| Action | Description |
|---|---|
| Kick | Disconnect a player; they may rejoin |
| Ban | Record a ban and reject future joins |
| Kill | Kill the player and trigger respawn |
| Heal | Restore full health |
| Set health | Set health as a ratio |
| Game mode | Switch between creative, survival, adventure and others |
| Invulnerable | Toggle damage immunity |
| Clear inventory | Remove all inventory items |
| Teleport | Move to specific coordinates |
| Back to spawn | Teleport to the world spawn |
| Set spawn | Use the current position as spawn |
| Administrator | Grant or revoke admin rights |
| Temperature / fatigue | Adjust survival stats |
| Sleep / wake | Toggle sleep state |
All actions are written to the audit log with operator, target and result.
Inventory
The inventory panel displays the current survival-mode inventory and allows editing slots.
When a player is in creative mode, the creative inventory is not a regular backpack. The panel hides the entire inventory card to avoid showing incomplete data. Switch back to survival mode and reopen the player details.
Offline players
Offline data comes from save files. Available actions include:
- View name, GUID and last update time.
- Edit basic attributes and spawn position.
- View inventory contents.
Stop the instance or ensure the player is offline before editing saves directly.
Whitelist and permissions
- The whitelist restricts who may join.
- Game administrator rights map to in-game admin commands.
- Panel account permissions and in-game permissions are independent.
Data source and troubleshooting
If the all-players list stays empty:
- Confirm the plugin is loaded (check the instance log).
- Confirm the instance is running.
- Confirm the server save directory contains
PlayerEntities. - Check the
offline dir resolvedline in the panel log for the actual path.
If the problem persists, open an issue on Gitee with panel logs and the instance directory layout.