# 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: []
    # When set to true, staff mode will be enabled when starting an investigation.
    # When disabling staff mode during an investigation, your investigation will be paused.
    enforce-staff-mode: true
    # Optional property, if set, enforce a specific staff mode during investigations.
    staff-mode: Investigator
```

## Commands

| command                               | description                                                                                                       |
| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| /investigate \<player?>               | Open/resume an investigation. If no player name is given you will start an investigation with an "Unknown" player |
| /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](/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)


---

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