For the complete documentation index, see llms.txt. This page is also available as Markdown.

Discord Log

Blackmarket can post rich, categorized embeds to a Discord webhook. Logging is configured at the top of server/discord_log.lua.

Setup

local config = {
    enabled = false,          -- turn logging on
    webhook = 'WEBHOOK_HERE', -- your Discord webhook URL
    botName = 'Blackmarket',  -- username shown on the embeds
    categories = {            -- toggle whole categories on/off
        admin    = true,
        economy  = true,
        police   = true,
        social   = true,
        security = true,
    },
}
  1. Create a webhook in Discord → Channel Settings → Integrations → Webhooks.

  2. Paste its URL into webhook.

  3. Set enabled = true.

  4. Restart the resource.

You can point each category at a different channel by duplicating the webhook logic, but the simplest setup is one webhook with the categories you care about left true.

Categories & events

Each embed is color-coded by category. Turn off a category by setting it to false.

Category
Color
Logged events

ADMIN

red

Every admin-panel action (create/delete warehouse, transfer ownership, eject, vault adjust, stock/van wipe, force-respawn van, edit coords/storefront, NPC force start/stop, member add/edit/remove).

ECONOMY

blue

Supply order placed/cancelled, drop picked up, order offloaded, replacement van ordered, van sale opened/closed, customer purchase, NPC vendor purchase, vault deposit/withdraw.

POLICE

orange

Van searched, van cargo seized, van destroyed.

SOCIAL

green

Member added, member permissions updated, member removed.

SECURITY

purple

Anti-abuse signals: customer refund lost on mid-purchase disconnect, vault deposit lost on disconnect, permission-denied attempts.

Every embed includes the warehouse (#id + owner) and the actor (name + identifier) when they apply, plus event-specific fields (amounts, item lists, ETAs, coordinates…).