# Discord Integration

## Introduction

Discord integration lets Staff++ notify certain events to your discord server using discord webhooks.

To Enable integration you need to install a separate **plugin:** <https://www.spigotmc.org/resources/staff-discord-integration.83871/>

## Configuration

The configuration of the discord integration plugin is fairly simple.

```yaml
StaffPlusPlusDiscord:
    templatePack: "default" # Choose from template packs "default" or "videndum"
    updateTemplates: true
    
    # REPORTS
    # The discord webhook url. This can be found in you discord server settings
    webhookUrl: ""
    # Trigger a discord message when some player opens a new report
    notifyOpen: true
    # Trigger a discord message when a staff member for some reason decides to not handle a report and he unassigns himself
    notifyReopen: true
    # Trigger a discord message when a staff member assigns himself to an open report
    notifyAccept: true
    # Trigger a discord message when a staff member rejects a report
    notifyReject: true
    # Trigger a discord message when a staff member resolves a report
    notifyResolve: true

    warnings:
        webhookUrl: ""
        notifyCleared: true
        notifyCreate: true
        notifyThresholdReached: true
        appeals:
            webhookUrl: ""
            notifyCreate: false
            notifyApproved: false
            notifyRejected: false
    bans:
        webhookUrl: ""
        ban: false
        unban: false
    kicks:
        webhookUrl: ""
        kick: false
    mutes:
        webhookUrl: ""
        mute: false
        unmute: false
    altDetect:
        webhookUrl: ""
        # Levels that should be notified to discord, leave empty to disable all notifications. Should be semi-colon separated
        # possible values: POSITIVE, FAIRLY_POSITIVE, POSSIBLE, NOT_LIKELY
        # example value: POSITIVE;FAIRLY_POSITIVE
        enabledTrustLevels: ""
    xray:
        webhookUrl: ""
        # Ores that should be notified to discord, leave empty to disable all notifications. Should be semi-colon separated
        # possible values: any bukkit material
        # example value: DIAMOND;REDSTONE
        enabledOres: ""
    staffmode:
        webhookUrl: ""
        # Trigger a discord message whenever a staffmember enters staffmode
        notify-enter: false
        # Trigger a discord message whenever a staffmember enters staffmode
        notify-exit: false
    chat:
        webhookUrl: ""
        # Trigger a discord message whenever a a player sends a chat message containing predefined words/phrases
        phrase-detection: false
    staffchat:
        sync: false
        message-format: "&9&l(discord) &7%text%"
```

Make sure you create a webhook on your discord server. This can be done by following this guide: <https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks> Once you created the webhook paste it inside the configuration file.

#### commands

| Command\`                    | Description                                                                            |
| ---------------------------- | -------------------------------------------------------------------------------------- |
| /staffplusplusdiscord reload | Reload the entire configuration, this includes the discord templates and webhook urls. |

#### permissions

| Permission                  | Description                     |
| --------------------------- | ------------------------------- |
| staffplusplusdiscord.reload | Allows using the reload command |

### Examples:

{% hint style="info" %}
All discord templates can be [customized](/master/integrations/discord-integration/customize-discord-templates.md).&#x20;
{% endhint %}

#### Report

![](/files/-MPQwUu2TYTKNSyORCoy)

#### Warning

![](/files/-MPQwYWcT4Kopb3YXN7D)


---

# 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/master/integrations/discord-integration.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.