Discord Logging

Keep your staff team in the loop by mirroring PhantomBans activity to Discord.

PhantomBans posts clean embeds to Discord using webhooks. You can send each kind of event to its own channel, so bans, reports, and appeals each land where they belong.

Set it up

Create a webhook in Discord

In your Discord server, open a channel’s settings, go to Integrations, and create a webhook. Copy its URL.

Paste it into the config

In config.yml, find the discord section and paste the URL into the event you want, then set that event’s enabled to true.

Reload

Run /phantombans reload (or restart) and the embeds start flowing.

Events you can send

Event	Posts when
`bans`	A player is banned
`mutes`	A player is muted
`kicks`	A player is kicked
`warns`	A player is warned
`unbans`	A ban is lifted
`reports`	A player files a report
`staff-notes`	A staff note is added
`audit-log`	A staff action is recorded
`appeals`	A player appeals
`senior-review`	An appeal is escalated

Each event has its own switch and its own webhook URL:


discord:
  enabled: true
  logo-url: "https://arrowtan.cc/logo.png"
  webhooks:
    bans:
      enabled: true
      url: "https://discord.com/api/webhooks/..."
      silent-punishments: false

Silent punishments

Each punishment webhook has a silent-punishments switch:

false: silent (-s) punishments are not posted to Discord, keeping them quiet everywhere.
true: post them to Discord anyway, so your staff log stays complete even though the server saw nothing.

Pick the behaviour that fits your team. Many servers keep silent-punishments: false for bans so a silent ban stays truly hidden, but true for unbans so the staff log is never missing a record.

A webhook URL is a key to post in your channel. Keep config.yml private and never share these URLs.