Trace Bullet
- By
Export Minecraft server metrics — TPS, player count, chunk count, and entity count — to any OTLP-compatible observability backend via OpenTelemetry.
File Details
Trace Bullet 0.1.0
- R
- Jun 13, 2026
- 281.73 KB
- 6
- 26.1.2
- NeoForge
File Name
tracebullet-0.1.0.jar
Supported Versions
- 26.1.2
Curse Maven Snippet
🎉 Initial Release
⚠️ Pre-release: This is the first public release of TraceBullet and should be considered beta quality. There may be unknown bugs or rough edges. Please report any issues on the issue tracker.
📊 Metrics
| Metric | Description |
|---|---|
| TPS | Server ticks per second |
| Tick Time | Server tick duration as a histogram (5–500 ms buckets) |
| Player Count | Online player count; player latency as a histogram |
| Chunks | Loaded and force-loaded chunk counts per dimension; chunk load/unload event counters; newly generated chunk counter |
| Entities | Living entity, block entity, and item entity counts with type and chunk position dimensions |
| World Save Duration | Histogram of world save time per dimension |
| Scheduled Ticks | Pending block and flsion |
| JVM | Heap memory (used/committed/max), GC collection count and pause time, CPU load, thread count |
⚙️ Configuration
- OTLP endpoint URL, service name override, and custom key-value attributes
- Optional authentication header for the metric export endpoint
- Per-metric enable/disable flags (all enabled by default)
- Thread pool size (defaults to 25% of available processors)
📈 Observability
- Bundled Prometheus/Grafana dashboard (
prometheus-dashboard.json) included in the release