# Chat module

### Introduction

The chat module allows you to manage certain chat functionalities. Most of these are still the old Staff+ ones. 

### Configuration

```yaml
############################################################
# +------------------------------------------------------+ #
# |                    Staff Chat                        | #
# +------------------------------------------------------+ #
############################################################

# Requires "permissions.staff-chat" permission.
staff-chat-module:
    # Whether or not the plugin will use "/sc" features.
    enabled: true
    # Whether or not the plugin synchronises staff chat across the bungee network
    bungee: true

    # The string that can be used at the beginning of a message to make it appear in staff chat.
    # If you have "@" as your string, typing "@hey guys" would send "hey guys" to staff chat.
    # Leave blank to disable.

    channels:
        -   command: sc
            handle: "@"
            name: staffchat
            prefix: '&dStaffChat &8»'
            message-format: '&b%player% &8» &7%message%'
            permission: staff.staffchat
            sound: "NONE"
```

### Phrase detection actions

You can execute actions whenever certain phrases are detected

```yaml
  detection:
    phrase-groups:
      - phrases:
            - admin
            - mod
        actions: []
```

Commands listed here should be in the [Staff ++ command format](/general-information/other/configuring-commands.md)

#### Placeholders

<table><thead><tr><th width="265.0007983677815">placeholder</th><th>description</th></tr></thead><tbody><tr><td>%player%</td><td>The name of the player that triggered the phrase detection</td></tr><tr><td>%phrases%</td><td>The configured phrases that were detected</td></tr></tbody></table>

#### Targets

<table><thead><tr><th width="353">target value</th><th>description</th></tr></thead><tbody><tr><td>player</td><td>The player that triggered the phrase detection</td></tr></tbody></table>

#### Executors <a href="#undefined" id="undefined"></a>

<table><thead><tr><th width="351.47558770343585">executor value</th><th>description</th></tr></thead><tbody><tr><td>player</td><td>The player that triggered the phrase detection</td></tr></tbody></table>


---

# 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/chat-module.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.