OpenTelemetry-first metrics for Paper servers and Velocity proxies.
Download MinecraftOTEL.jar from GitHub Releases (no version in the filename), drop it into your
plugins/ folder, and attach the OpenTelemetry Java Agent. That's it.
Jump to: Installation | Admins | Developers
- Download
MinecraftOTEL.jarfrom GitHub Releases. - Copy it into
plugins/(Paper or Velocity). - Attach the OpenTelemetry Java Agent to your JVM.
- Start the server/proxy and verify metrics in your exporter.
Full guide and agent examples: docs/admin/installation.md
High-level overview only. Verify details in each project's docs. * = partial or varies by platform/fork.
| Feature | MinecraftOTEL | Unified Metrics | Spark | Prometheus Exporter |
|---|---|---|---|---|
| OpenTelemetry native (OTLP via Java Agent) | ✅ | ❌ | ❌ | ❌ |
| Prometheus scrape endpoint | ❌ | * | ❌ | ✅ |
| Paper support | ✅ | * | * | * |
| Velocity support | ✅ | * | * | ❌ |
| Custom metrics API | ✅ | * | ❌ | ❌ |
| Profiling | * | ❌ | ✅ | ❌ |
| Dashboards included | * | ❌ | ❌ | ❌ |
| Built-in UI | ❌ | ❌ | ✅ | ❌ |
| CloudNet service labels | ✅ | ❌ | ❌ | ❌ |
Docs:
- MinecraftOTEL: Admins, Devs
- Unified Metrics: https://github.com/plan-player-analytics/UnifiedMetrics
- Spark: https://spark.lucko.me/
- Prometheus Exporter: https://github.com/slok/minecraft-prometheus-exporter
If you use different projects with the same names, swap the doc links accordingly.
- Installation and Java Agent setup: docs/admin/installation.md
- Configuration and dashboard notes: docs/admin/configuration.md
- Metrics reference: docs/admin/metrics.md
- CloudNet service monitoring: docs/admin/cloudnet.md
- API usage and third-party integrations: docs/development/integrations.md
- Platform implementation guide: docs/development/platform-extension.md
- Branching model: docs/development/branching-model.md
- Building from source: docs/development/building.md
GitHub releases include the built MinecraftOTEL.jar asset.