Skip to content
Pavel Erokhin edited this page Oct 19, 2026 · 2 revisions

minecraft-exporter reads a Paper server through WorldAPI and serves its metrics to Prometheus: performance, worlds, players and their lifetime statistics, deaths, advancements, and, with a token, the host and the console. It runs next to Prometheus, not inside the game, and costs the server a few HTTP requests per scrape. Moonlands, my hard survival server with friends, runs it with a monitoring token behind a private Grafana.

For server owners

  1. Installation: Docker, Docker Compose, or a binary.
  2. Configuration: every flag and environment variable, and the targets file.
  3. WorldAPI token: what a token opens, permission by permission, and how to keep it safe.
  4. Prometheus: the scrape config for one server or many.
  5. Grafana: the ready dashboard.
  6. Metrics: every metric with its labels and where it comes from.
  7. Troubleshooting: empty panels, missing metrics, errors.

For developers

Clone this wiki locally