1.5 KiB
1.5 KiB
type, title, description, status
| type | title | description | status |
|---|---|---|---|
| User Story | US-004: Capture periodic player snapshots | Periodically capture player location and comprehensive Bukkit statistics without monopolizing a server tick. | done |
US-004: Capture periodic player snapshots
As a server analyst, I want periodic player location and statistic snapshots so that I can analyze movement and gameplay progression over time.
Acceptance criteria
- Each configured interval captures every online player's world identity, coordinates, orientation, game mode, and biome.
- Every Bukkit untyped, block, item, and entity statistic combination accepted by Bukkit is captured, including zero values.
- Invalid statistic subtype combinations are skipped without stopping the snapshot.
- Statistic reads are spread across ticks according to a configurable operation budget and run through Bukkit scheduling.
- A player is not queued for a second statistic capture while an earlier capture remains queued or active.
- Statistics are partitioned by category and configured JSON size, with shared snapshot metadata and one-based part information.
- Empty statistic categories still emit an explicit part.
- Offline players are removed safely from queued or active capture work.