Skip to content

Discord Logging

Discord Logging

Every annotation written, removed or cleared can be posted to Discord as an embed. It is intended for medical roleplay oversight: who documented what, on whom, for how long, and who took it off again.

Enable it

Create the webhook in Discord under Server Settings → Integrations → Webhooks → New Webhook → Copy Webhook URL, then paste it in.

config.lua
Config.Webhook = {
    Enabled  = false,
    Url      = '',
    Username = 'BUPA Status',
    Avatar   = '',

    Log = {
        Add    = true,   -- an annotation was written
        Remove = true,   -- a single annotation was deleted
        Clear  = true,   -- a character's annotations were wiped
    },

    class="hljs-literal">true,

    Colors = {
        Add    = 5990640,   -- blue
        Remove = 15680580,  -- red
        Clear  = 15680580,  -- red
    },

    Footer = 'BUPA Sync Status',
}

Nothing is sent while Enabled is false or Url is empty.

Field Purpose
Username / Avatar Name and picture the messages are posted under. Leave Avatar empty to use the webhook's own.
Log Turn individual actions off if you do not care about them.
OnlyOnOthers true logs only actions performed on another player — medic work. false also logs every note players write on themselves, which is chatty.
Colors Embed colour per action, as a decimal number. Pick one at spycolor.com and use the decimal value.
Footer Text under every embed. Empty hides the footer.

What each embed contains

Annotation added

Field Example
Written by The medic — name, server id and citizen id
On The patient, same format
Region The body part label
Note The annotation text, in a code block
Type Injury / Bandage / Note
Severity Minor / Moderate / Severe
Duration Time remaining, or Permanent
Locked Yes / No

Annotation removed logs who removed it, whose body it came off, the region, the text and whether it had been locked.

Annotations cleared logs who cleared it, from whom, how many entries actually went, and whether locked notes were kept.

Keep the webhook URL private. Anyone holding it can post in that channel.