# Examine players

The examine command allows Staff members to open a GUI containing the specified player's information.<br>

## Configuration

The current configuration section is part of the `staff-mode` section. This will probably change in the future as the examine mode can also be accessed through commands and thus is not mode specific.\
\
Now the configuration of the examine mode and staff-mode GUI kind of overlap

```yaml
 staff-mode:
  # When clicked, this will open the inventory of the player that the staff is looking at.
  examine-module:
    enabled: true
    slot: 8
    item: CHEST

    # The name of the compass item.
    name: "&bExamine"

    # The lore of the compass item.
    # Lines are separated by commas.
    lore: "&7Inspects the inventory of the player that was clicked."

    # The title of the examine GUI.
    title: "&bExamine inventory"

    # The configuration of the final line of the examine GUI.
    # Set the slot of a node to zero to disable it.
    # Remember that the maximum amount of allowed items within this line is nine!
    info-line:
      # Food and hunger information.
      food: 1

      # IP address information.
      ip-address: 2

      # Ping information.
      # Currently not working
      ping: 3

      # Gamemode and flight information.
      gamemode: 4

      # Infractions information.
      infractions: 5

      # Location information and teleport button.
      location: 6

      # Player "notes" button.
      notes: 7

      # Freeze button
      freeze: 8

      # Warn button.
      warn: 9
```

## Permissions

| Permission                                  | Description                                                                                                                                    |
| ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| staff.examine                               | Permission to use the /examine command                                                                                                         |
| staff.examine.view-inventory                | <p>Permission to view the examined player's inventory </p><p>when the player is online</p>                                                     |
| staff.examine.view-inventory-offline        | <p>Permission to view the examined player's </p><p>when the player is offline </p>                                                             |
| staff.examine.inventory-interaction         | <p>Permission to interact with the examined </p><p>player's inventory when the player is online. </p><p>Meaning adding and removing items.</p> |
| staff.examine.inventory-interaction-offline | <p>Permission to interact with the examined </p><p>player's inventory when the player is online. </p><p>Meaning adding and removing items.</p> |
| staff.staffplus.hideip                      | <p>If a player has this permission, </p><p>then his ip won't be shown </p><p>when examined by a staff member.</p>                              |


---

# 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/master/features/examine-players.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.