# Staff Chat

### Configuration

```yaml
# 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

  channels:
    - name: staffchat
      # What command will be used to send message to this channel
      command: sc
      permission: staff.staffchat
      prefix: '&dStaffChat &8»'
      message-format: '&b%player% &8» &7%message%'
      # 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.
      handle: '@'
      sound: ENTITY_EXPERIENCE_ORB_PICKUP
    - name: adminchat
      command: ac
      permission: staff.staffchat
      prefix: '&dAdminChat &8»'
      message-format: '&b%player% &8» &7%message%'
      handle: $
```

### Channels

You now have the flexibility to define multiple staff chat channels, with each channel having its own configurable command. Furthermore, you can specify the required permissions for accessing each channel.

#### Mute **Functionality**

When setting up a staff channel, an additional command for muting that channel is automatically created. For instance, if you configure a command `sc` for a channel, a corresponding `sc-mute` command is also generated. To gain access to the mute command, users must possess the necessary permissions for the channel, denoted by `.mute` appended to the configured permission. In the example mentioned, this permission would be `staff.staffchat.mute`.

#### Sound control

While configuring a staff channel, another command is introduced to manage notification sounds, allowing users to enable or disable them for the specific channel. Just like the mute command, to access the sound command, users must have the appropriate permissions for the channel, marked by `.sound` added to the configured permission. In the example given, this permission would be `staff.staffchat.sound`.

### Discord Integration

For seamless communication, staff chat can be seamlessly integrated with a Discord channel through the use of the [discord integration plugin](/integrations/discord-integration/staff-chat.md). This integration enables bidirectional communication between your staff chat and a preconfigured Discord channel.


---

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