mineGrafana — Real-Time Minecraft Server Monitoring with Grafana
Monitor your Minecraft server like a pro. mineGrafana is a lightweight yet powerful monitoring plugin that exposes Prometheus-compatible metrics from your Paper and Velocity servers — making it easy to build beautiful, real-time Grafana dashboards with zero hassle.
![[IMG]](//proxy.spigotmc.org/14a279985f66e3490e5bcede39fba49a044aefdf/68747470733a2f2f692e6962622e636f2f4d357359686d52362f696d6167652e706e67)
Features
Performance Metrics Track TPS (current, 1m/5m/15m averages), MSPT (avg/min/max/95th percentile), CPU usage, memory (heap used/max/free), and garbage collection stats in real time.
World & Entity Metrics (Paper only) Monitor loaded chunks, entity counts (per-world and per-type), tile entities, redstone components (hoppers, comparators, repeaters), and world folder disk usage.
Per-Plugin CPU Profiling (Paper only) Stack-sampled thread profiling breaks down CPU usage per plugin — instantly identify which plugin is causing lag.
Flame Graph Profiler (Paper only) Generate interactive HTML flame graphs in-game with /mg profile start. Supports async-profiler on Linux and JFR on Windows/macOS.
Proxy Metrics (Velocity only) Track total player count, per-server player distribution, server online/offline status, and per-player ping across your entire network.
Auto-Provision Grafana Dashboards Set your Grafana API key in config.yml and dashboards are created automatically on server start — no manual import needed.
️ Quick Setup
This plugin is fully open source. github.com/devvelvet/mineGrafana
Built with Kotlin, Micrometer, and Spring Boot embedded Netty. MIT Licensed.
Monitor your Minecraft server like a pro. mineGrafana is a lightweight yet powerful monitoring plugin that exposes Prometheus-compatible metrics from your Paper and Velocity servers — making it easy to build beautiful, real-time Grafana dashboards with zero hassle.
Features
Performance Metrics Track TPS (current, 1m/5m/15m averages), MSPT (avg/min/max/95th percentile), CPU usage, memory (heap used/max/free), and garbage collection stats in real time.
World & Entity Metrics (Paper only) Monitor loaded chunks, entity counts (per-world and per-type), tile entities, redstone components (hoppers, comparators, repeaters), and world folder disk usage.
Per-Plugin CPU Profiling (Paper only) Stack-sampled thread profiling breaks down CPU usage per plugin — instantly identify which plugin is causing lag.
Flame Graph Profiler (Paper only) Generate interactive HTML flame graphs in-game with /mg profile start. Supports async-profiler on Linux and JFR on Windows/macOS.
Proxy Metrics (Velocity only) Track total player count, per-server player distribution, server online/offline status, and per-player ping across your entire network.
Auto-Provision Grafana Dashboards Set your Grafana API key in config.yml and dashboards are created automatically on server start — no manual import needed.
️ Quick Setup
- Drop the JAR into your plugins/ folder
- Set your server-id and port in config.yml
- Add the endpoint to your prometheus.yml
- Import or auto-provision the Grafana dashboard
- Done — metrics start flowing immediately
- Paper 1.21+ or Velocity 3.4+
- Prometheus + Grafana (any recent version)
- JDK 21+
This plugin is fully open source. github.com/devvelvet/mineGrafana
Built with Kotlin, Micrometer, and Spring Boot embedded Netty. MIT Licensed.
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
mineGrafana is a free Minecraft Java mod. Compatible with Minecraft 1.21. Downloaded 43 times (via Spigot). Download it and open it directly in the game.