Files
spigot-event-producer/design/user-stories/us-001-configure-event-producer.md
T
dmg c76ea5b434
CI / build (push) Successful in 3m35s
Release / release (push) Successful in 4m6s
docs(design): add user story knowledge bundle
2026-08-08 12:31:15 -04:00

1.2 KiB

type, title, description, status
type title description status
User Story US-001: Configure the event producer Allow a server operator to identify a Minecraft server and tune event capture and delivery safely. done

US-001: Configure the event producer

As a Minecraft server operator, I want to configure the producer for my server and ingest service so that emitted events are identifiable and fit my operating limits.

Acceptance criteria

  • A human-readable server name and stable server UUID can be configured.
  • When no server UUID is supplied, the plugin generates one and persists it for later starts.
  • The ingest URL, send interval, snapshot interval, HTTP timeout, batch limits, dispatch thresholds, statistic chunk size, and per-tick statistic budget are configurable.
  • Blank required values, non-positive limits, overlong server names, invalid UUIDs, and statistic chunks without sufficient batch headroom prevent initialization.
  • Initialization errors are logged and leave the plugin disabled rather than partially running.