# Player information

### Commands

| command                | description                             |
| ---------------------- | --------------------------------------- |
| /players               | Show the players overview selection GUI |
| /players \<playername> | Show the details of the given player    |

### Permissions

| Permission    | Description                            |
| ------------- | -------------------------------------- |
| staff.players | Permission to use the /players command |

### GUIs

#### Select overview

When executing the players command without parameters the following GUI will be shown:

![](/files/-MiEH0G8oCbLlc0Ccnzj)

From left to right we have:

| Description              | Permission needed                           |
| ------------------------ | ------------------------------------------- |
| Online players overview  | staff.player-view\.overview\.onlineplayers  |
| Offline players overview | staff.player-view\.overview\.offlineplayers |
| Staff members            | staff.player-view\.overview\.staff          |
| Miners GUI               | staff.player-view\.overview\.miners         |
| Protected players GUI    | staff.player-view\.overview\.protected      |

Each one of those will take you to a different overview:

#### player overview

![](/files/-MiEHnDHhNB422Vtzzge)

Hovering over the player head will show you some information of the player. What you get to see or not is based upon permissions explained in the [player information popup](/features/players-information.md#player-information-popup) section.

Clicking on a player takes you to his details screen

#### player details

The details screen contains an overview of a player's infraction, state and a set of actions the staff member can perform on the player

![](/files/lIXcW4KUqP188djEUk7g)

On to top row we have

* The player head with detailed info
* The reports overview
* the warnings overview
* The Kicks overview
* Mute indicator
* Ban indicator
* Ip ban indicator

On the bottom row we have:

| action                    | Permission needed                                                                      |
| ------------------------- | -------------------------------------------------------------------------------------- |
| Follow                    | staff.mode.follow                                                                      |
| Freeze                    | staff.freeze.freeze                                                                    |
| Cps                       | No permission                                                                          |
| Teleport to player        | staff.teleport.teleport-to-player                                                      |
| Teleport the player to me | staff.teleport.teleport-here                                                           |
| Check Inventory           | staff.inventory.inventory-interaction OR staff.inventory.inventory-interaction-offline |
| Check Enderchest          | No permission                                                                          |
| Back button               | No permission                                                                          |

What you get to see here is determined by the permissions you have and what modules are enabled or not.

### Player information popup

Whenever hovering over a player's head in the GUIs you will get to see detailed player information.

![](/files/-MiG_ddZK-OfpPGKGiBy)

The first section shows IP, game mode, food level and location of the player.\
The second section shows the state a player is in. Showing if the players is frozen, protected, under investigation, muted or vanished. So in the above case the player is all of these things.

#### permissions

| Description | Permission Needed |
| ----------- | ----------------- |
| IP address  | <p>               |

</p><p>staff.player-view.detail.ip
</p> |
| UUID                   | staff.player-view.detail.uuid               |
| Game Mode              | staff.player-view.detail.gamemode           |
| Food level             | staff.player-view.detail.food               |
| Location               | staff.player-view.detail.location           |
| Time played            | staff.player-view.detail.timeplayed         |
| Is frozen              | staff.player-view.detail.frozen             |
| Is protected           | staff.player-view.detail.protected          |
| Is under investigation | staff.player-view.detail.investigated       |
| Is muted               | staff.player-view.detail.muted              |
| Is vanished            | staff.player-view.detail.vanished           |

{% hint style="warning" %}
The above information is only available if the player is online. This is due to performance issues. Online players information is already retrieved and readily available. For offline players you want to check the "player details" GUI.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.staffplusplus.org/features/players-information.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.