# Infractions

Staff++ provides a command to show all infractions a player has. This gives you a nice history off the player actions and punishments in time. The infractions are ordered by date. Latest infractions are shown first.\
Currently infractions include: bans, mutes, warnings, kicks and it also shows an infraction when a player is reported by another player.

## Configuration

```yaml
infractions-module:
  # Whether or not the plugin will enable the infractions gui.
  enabled: true
  show-bans: true
  show-mutes: true
  show-warnings: true
  show-reported: true
  show-kicks: true
  # Configure the material which is shown inside the GUI 
  # for every type of infraction
  bans-gui-item: PAPER
  mutes-gui-item: PAPER
  warnings-gui-item: PAPER
  reported-gui-item: PAPER
  kicks-gui-item: PAPER
```

You can choose which infractions will be shown in the overview.

### Permissions

| Permission             | Description                            |
| ---------------------- | -------------------------------------- |
| staff.infractions.view | Permission to open the infraction guis |

### Commands

| Command                     | Description                                                                                                                                                                                                    |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/infractions <playername>` | Opens the infractions gui displaying all infractions of the given player                                                                                                                                       |
| `/infractions-top <type?>`  | Open the overview of players and their amount of infractions. Ordered by most to least infractions. The type parameter is optional. When given only the top of that specific type of infraction will be shown. |

### <br>

#### Player Infraction GUI

![](/files/-MSL12GzqebmtQ4K9U1h)

#### Top infraction GUI

![](/files/-MSL0q16y2pElley0tJX)


---

# 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/infractions.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.