Sends punishment and staff events to Discord through incoming webhooks. There is no bot
and no JDA dependency — the plugin posts JSON over HTTPS, so all you need is a webhook URL
from a channel's integration settings.
Message templates accept %player%, %uuid%, %staff%, %reason%, %duration%,
%date%, %id%, %server%, %scope% and %type%. Leaving a webhook URL empty disables
that notification silently.
|
|
| On disk |
plugins/UltimateDonutSmp2/discord.yml |
| Player-facing text |
Not translated. Edit this file directly. |
| Reload |
/ultimatedonutsmp2 reload |
| Section |
Type |
Contents |
WEBHOOKS |
section |
6 keys |
| Option path |
Type |
Accepted values |
Default |
What it does |
WEBHOOKS.ENABLED |
boolean |
true, false
|
true |
Turns the WEBHOOKS section on or off. |
WEBHOOKS.URL |
string |
Any text |
https://discord.com/api/webhooks/your_webhook_here |
Url. |
WEBHOOKS.AVATAR_API |
string |
Any text |
https://visage.surgeplay.com/face/128/%uuid_no_dash% |
Avatar api. |
WEBHOOKS.MODEL_API |
string |
Any text |
https://visage.surgeplay.com/full/384/%uuid_no_dash% |
Model api. |
WEBHOOKS.BUST_API |
string |
Any text |
https://visage.surgeplay.com/bust/384/%uuid_no_dash% |
Bust api. |
Each entry under WEBHOOKS.MESSAGES is keyed by a name you choose, and every entry accepts the same options:
| Entry key |
TITLE |
BAN |
Player Banned - %player% |
MUTE |
Player Muted - %player% |
WARN |
Player Warned - %player% |
KICK |
Player Kicked - %player% |
BLACKLIST |
PLAYER BLACKLISTED - %player% |
| Key |
Type |
Accepted values |
Required? |
What it does |
AUTHOR_NAME |
string |
Any text |
Required |
Author name. |
COLOR |
string |
Any text |
Required |
Color. |
DESCRIPTION |
string |
Any text |
Required |
Description. |
ENABLED |
boolean |
true, false
|
Required |
Turns the BAN section on or off. |
FOOTER |
string |
Any text |
Required |
Footer. |
THUMBNAIL |
string |
Any text |
Required |
Thumbnail. |
TITLE |
string |
Any text |
Required |
Title text. Supports & colours and &#RRGGBB hex. |
Default WEBHOOKS block as shipped
# Configuration section for Webhooks.
WEBHOOKS:
# Determines whether Enabled is enabled or disabled. Available options: true, false
ENABLED: true
# The text or value for Url. Available options: Any valid string text
URL: https://discord.com/api/webhooks/your_webhook_here
# The text or value for Avatar Api. Available options: Any valid string text
AVATAR_API: https://visage.surgeplay.com/face/128/%uuid_no_dash%
# The text or value for Model Api. Available options: Any valid string text
MODEL_API: https://visage.surgeplay.com/full/384/%uuid_no_dash%
# The text or value for Bust Api. Available options: Any valid string text
BUST_API: https://visage.surgeplay.com/bust/384/%uuid_no_dash%
MESSAGES:
# Configuration section for Ban.
BAN:
# Determines whether Enabled is enabled or disabled. Available options: true, false
ENABLED: true
TITLE: Player Banned - %player%
# The text or value for Color. Available options: Any valid string text
COLOR: '#FF0000'
# The text or value for Description. Available options: Any valid string text
DESCRIPTION: |-
:hammer: **Punishment Type:** Ban
**Player:**
%player%
**Staff:**
%staff%
**Reason:**
||%reason%||
**Duration:**
%duration%
**Date:**
%date%
**ID:** `%id%`
# The text or value for Thumbnail. Available options: Any valid string text
THUMBNAIL: '%skin_bust%'
# The text or value for Author Name. Available options: Any valid string text
AUTHOR_NAME: Ban System
# The text or value for Footer. Available options: Any valid string text
FOOTER: Punishment issued via server
# Configuration section for Mute.
MUTE:
# ... section continues, see the file on disk for the full block
Defaults above match the file shipped in the jar.