MCMetrics Plugin Documentation

The MCMetrics plugin tracks data about player sessions, server playercounts, and more.

Permissions

• mcmetrics.admin: Grants access to all MCMetrics commands.

Commands

Below is a list of all available commands and their usage.

General Commands

• /mcmetrics help

  • Description: Shows the help message with all available commands.

• /mcmetrics setup <server_id> <server_key>

  • Description: Configure the plugin with your server ID and key from the MCMetrics dashboard.

• /mcmetrics reload

  • Description: Reloads the MCMetrics configuration file.

• /mcmetrics status

  • Description: Shows the current status of the plugin, including active sessions and API statistics.

Player & Session Commands

• /mcmetrics info <player name or uuid>

  • Description: Shows detailed information about a player's current session, including custom events and payments.

• /mcmetrics ignore <player name or uuid> --silent

  • Description: Stops tracking the current session for a specific player. The session data will not be uploaded.

Data Tracking Commands

• /mcmetrics payment <platform> <player name/uuid> <transaction_id> <amount> <currency>

  • Description: Manually records a payment for a player.
  • Example: /mcmetrics payment tebex Notch 12345 9.99 USD

• /mcmetrics customevent <player name/uuid> <event_type> [key1=value1 key2=value2 ...]

  • Description: Records a custom event for a player with optional metadata.
  • Example: /mcmetrics customevent Notch level_up new_level=10

• /mcmetrics customevents

  • Description: Lists all active custom event listeners that are configured to trigger from console messages.

A/B Testing Commands

• /mcmetrics abtests

  • Description: Lists all active A/B tests fetched from the MCMetrics server.

• /mcmetrics abtest <test name> <player name/uuid>

  • Description: Manually triggers a command-based A/B test for a specific online player.