MinecraftOTEL

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

Installation

1. Download MinecraftOTEL.jar from GitHub Releases.
2. Copy it into plugins/ (Paper or Velocity).
3. Attach the OpenTelemetry Java Agent to your JVM.
4. Start the server/proxy and verify metrics in your exporter.

Full guide and agent examples: docs/admin/installation.md

Feature Matrix (Monitoring Plugins)

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.

Dashboard Preview

For Server Admins

• 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

For Developers

• 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

Releases

GitHub releases include the built MinecraftOTEL.jar asset.