State File

Spigot Sales Webhook uses a JSON state file to remember which buyer names have already been seen for each configured plugin.

State File Format

Default path:

scan:
  state-file: "data/seen-sales.json"

Example state:

{
  "initialized": true,
  "seenSalesByPlugin": {
    "Plugin Name": [
      "examplebuyer"
    ]
  }
}

Buyer keys are stored in lowercase form, so ExampleBuyer and examplebuyer are treated as the same buyer.

If the state file does not exist, the worker starts with empty state.

When notify-existing-on-first-run is false, the first successful scan:

This prevents old purchases from flooding Discord during setup.

Delete the configured state file if you want the worker to rebuild its baseline.

rm data/seen-sales.json

On Windows PowerShell:

Remove-Item data/seen-sales.json