Trace Bullet
No reviews yet
Export Minecraft server metrics — TPS, player count, chunk count, and entity count — to any OTLP-compatible observability backend via OpenTelemetry.
Neoforge is a fork of the Minecraft Forge available for versions 1.20.1+ of Minecraft. Many Forge mods are compatible with Neoforge and vice versa.
Community voices
Reviews
Click once to include, again to exclude, again to clear
No reviews yet. Be the first to review this project!
Get it on
Available Platforms
CurseForge
Modrinth
Compatibility
Supported Environments
About
Project Details
For authors
Embed Badge
If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.
Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.
Identifiers
Platform IDs
About
Description
Instrument your Minecraft server with OpenTelemetry and export real-time metrics to any OTLP-compatible observability platform.
What It Does
TraceBullet runs alongside your server and continuously collects performance and gameplay metrics, exporting them via OTLP so you can visualize trends, set up alerts, and catch problems before your players notice.Metrics Collected
| Metric | Description |
|---|---|
| TPS | Tick time histogram — see how your server performs across the full distribution, not just the average |
| Player Count | Online player count over time |
| Chunk Count | Loaded chunk count per dimension |
| Entity Count | Entity count per dimension |
| World Save Duration | Histogram of how long each world save takes per dimension |
| Scheduled Tick Queue | Pending block and fluid tick queue size per dimension — a leading indicator of lag |
| Chunk Generation | Count of newly generated chunks per dimension, distinguishing expensive generation from cheap disk loads |
Setup
- Drop the mod JAR into your
mods/folder (no other mods required — OpenTelemetry is bundled) - Start the server once to generate the config file
- Set your OTLP endpoint URL and service name in the config
- Point your observability stack at the endpoint and start collecting
Configuration
All options are available in the NeoForge mod config (tracebullet-common.toml):
- OTLP endpoint URL
- Service name
- Custom resource attributes
- Per-metric enable/disable toggles
- Thread pool sizing
Wiki
Find a getting start guide, a list of all metrics and configuration on the wiki:https://github.com/korti11/tracebullet/wiki
Instrument your Minecraft server with OpenTelemetry and export real-time metrics to any OTLP-compatible observability platform.
What It Does
TraceBullet runs alongside your server and continuously collects performance and gameplay metrics, exporting them via OTLP so you can visualize trends, set up alerts, and catch problems before your players notice.
Metrics Collected
| Metric | Description |
|---|---|
| TPS | Tick time histogram — see how your server performs across the full distribution, not just the average |
| Player Count | Online player count over time |
| Chunk Count | Loaded chunk count per dimension |
| Entity Count | Entity count per dimension |
| World Save Duration | Histogram of how long each world save takes per dimension |
| Scheduled Tick Queue | Pending block and fluid tick queue size per dimension — a leading indicator of lag |
| Chunk Generation | Count of newly generated chunks per dimension, distinguishing expensive generation from cheap disk loads |
Setup
- Drop the mod JAR into your
mods/folder (no other mods required — OpenTelemetry is bundled) - Start the server once to generate the config file
- Set your OTLP endpoint URL and service name in the config
- Point your observability stack at the endpoint and start collecting
A **Grafana dashboard** is included in each release for a ready-to-use starting point.
Configuration
All options are available in the NeoForge mod config (tracebullet-common.toml):
- OTLP endpoint URL
- Service name
- Custom resource attributes
- Per-metric enable/disable toggles
- Thread pool sizing
Wiki
Find a getting start guide, a list of all metrics and configuration on the wiki:
https://github.com/korti11/tracebullet/wiki
Screenshots
Gallery
-
Grafana Dashboard 4.png Grafana Dashboard 4.png -
Grafana Dashboard 3.png Grafana Dashboard 3.png -
Grafana Dashboard 2.png Grafana Dashboard 2.png -
Grafana Dashboard 1.png Grafana Dashboard 1.png -
logo.png logo.png
-
Trace Bullet Logo -
Grafana Prometheus Dashboard -
Grafana Prometheus Dashboard -
Grafana Prometheus Dashboard -
Grafana Prometheus Dashboard
Versions
Files
Relations
Project Relations
More like this
Similar Mods
Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.
On ModDex
Community snapshot
By the numbers
Statistics
Want to reach Minecraft players?
We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!
Get in touchGet it on
Available Platforms
On ModDex
Community snapshot
By the numbers