> For the complete documentation index, see [llms.txt](https://wiki.staffplusplus.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.staffplusplus.org/master/features/investigate.md).

# Investigate

## Configuration

```yaml
investigations-module:
    enabled: true
    allow-offline-investigation: false
    # How many investigations can be conducted on one player at a time.
    # By default only one investigation can be ongoing for one player
    max-concurrent-investigations: 1
    # When enabled investigations will automatically be paused 
    # when the player under investigation leaves the server.
    automatic-pause: true
    notifications:
        investigated:
            # Player under investigation has a constant message in his action bar. 
            title-message-enabled: true
            # Player under investigation has a constant message in his action bar.
            chat-message-enabled: true
    # Run commands whenever an investigation open/pauses/isConcluded        
    start-investigation-commands: []
    conclude-investigation-commands: []
    pause-investigation-commands: []
```

## Commands

| command                               | description                                                                                                 |
| ------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| /investigate \<player>                | Open/resume an investigation                                                                                |
| /pause-investigation                  | Pause your currently ongoing investigation                                                                  |
| /conclude-investigation               | Conclude your investigation. This closes the investigation                                                  |
| /manage-investigations \<playername?> | Opens up the overview of all investigations or all investigation for a player if the playername is provided |
| /inote \<notemessage>                 | Add a note to your current investigation                                                                    |

## Permissions

| permission                                    | Description                                       |
| --------------------------------------------- | ------------------------------------------------- |
| staff.investigation.manage.investigate        | allows the use of /investigate                    |
| staff.investigation.manage.notifications      | Get all staff notifications for investigations    |
| staff.investigation.manage.view               | Allow viewing all investigations                  |
| staff.investigation.manage.link-evidence      | Allow linking evidence to investigations          |
| staff.investigation.manage.add-note           | Allow adding notes to investigations              |
| staff.investigation.manage.delete-note        | Allow deleting your own notes from investigations |
| staff.investigation.manage.delete-note-others | Allow deleting any note from investigations       |

## Manage investigation

Staff members can view an overview of all investigations.

![Investigations](/files/-MXZeVSqhu-RLiTnKp02)

![Player under investigation](/files/-MXZldJTZWAEbulipIuk)

## Linking evidence

Staff++ allows you to link certain infractions to an investigation.

Currently following infractions can be linked to investigations:

* Reports
* Mutes
* Bans
* Warnings

Developers can also link any other kind of evidence using the [Developer API](/master/developers/api-guide.md)

![Link report as evidence](/files/-MXZc6hyBOZQx41Xnidf)

![Confirmation evidence linked](/files/-MXZcNaJWCC-u5KqlsbM)

![Investigation manage screen](/files/-MXZcdAmDtm94AdSu3P3)

![Evidence overview](/files/-MXZcn77BaDDjSZDbOJW)

## Taking notes

Players can add notes to an investigation.

![Go to notes](/files/-MXZe1wvEqhA98QfF9pO)

![Notes overview](/files/-MXZe6XYpjxw9K8Z0Hrc)