Plugin disponible

Plugin Minecraft Java

Documentation Paper (téléchargement SpigotMC) : installation, config.yml, permissions, exemples d’events, signaux runtime et FAQ BETA.

Installation

Paper 1.21.x · Java 21+.

  1. Créez un serveur dans ObsidianMetrics et copiez sa clé X-Server-Key.
  2. Placez le fichier .jar dans plugins/.
  3. Redémarrez le serveur pour générer plugins/ObsidianMetrics/config.yml.
  4. Renseignez api_url et secret_key, puis redémarrez ou lancez /gamestats reload.
  5. Vérifiez le statut dans Paramètres → État du plugin.

Vous avez déjà téléchargé le .jar depuis SpigotMC ?

Créez votre clé serveur maintenant : l’assistant préremplit Minecraft Java, génère la clé et vous donne un blocconfig.yml prêt à coller.

Créer ma clé serveur

Configuration

Exemple minimal config.yml.

gamestats:
  api_url: "https://obsidianmetrics.fr/api"
  secret_key: "coller-la-cle-serveur"
  setup_url: "https://obsidianmetrics.fr/register?source=plugin_setup"
  setup_id: ""

  track_chat: true
  track_player_death: true
  track_player_advancement: true
  track_performance: true
  performance_interval_seconds: 30

  events:
    player_join: true
    player_quit: true
    player_death: true
    player_respawn: true
    player_kill: true
    player_kick: true
    player_advancement: true
    chat: true
    block_break: false
    block_place: false

Permissions Minecraft

Commandes admin/debug du plugin.

  • obsidianmetrics.admin — /gamestats reload, /gamestats status, /gamestats link et /gamestats setup <clé>.
  • obsidianmetrics.debug — réservé aux diagnostics avancés à venir.
  • obsidianmetrics.silent — exclure un joueur des résumés si vous l’implémentez côté serveur.

Exemples d’events

Payloads minimaux acceptés.

POST /api/ingest
X-Server-Key: <cle>

{
  "eventId": "evt-01",
  "playerId": "uuid-joueur",
  "playerName": "Steve",
  "sessionId": "session-01",
  "occurredAt": "2026-05-22T08:00:00.000Z",
  "eventType": "PLAYER_JOIN",
  "payload": { "displayName": "Steve", "isFirstJoin": false },
  "recentSummary": "Steve vient de rejoindre le serveur"
}
POST /api/ingest/signal
X-Server-Key: <cle>

{
  "signalType": "RUNTIME_PING",
  "occurredAt": "2026-05-22T08:00:30.000Z",
  "payload": {
    "plugin_version": "1.0.0-beta",
    "tps_1m": 19.96,
    "mspt": 32.4,
    "memory_used_mb": 1536,
    "memory_max_mb": 4096,
    "online_count": 12
  }
}

FAQ

Questions fréquentes beta testers.

Le plugin reste “pas connecté”.

Vérifiez l’URL API, la clé et l’envoi d’un RUNTIME_PING.

Les events arrivent mais pas dans les graphiques.

Les signaux techniques ne comptent pas comme événements gameplay. Utilisez /api/ingest avec un playerId stable.

Peut-on tester sans installer ?

Oui, utilisez le preview public pour voir une reproduction statique du dashboard.