clan.me
Concepts

Connect your Minecraft server to clan.me

Step-by-step guide to getting your server listed on clan.me and unlocking the full analytics dashboard with the clan.me plugin.

Updated 7 June 2026

clan.me gives your server a hosted analytics dashboard, a public listing page, and a live player feed, with no setup required for the basics. The clan.me plugin unlocks the full picture: TPS, MSPT, memory, player sessions, and retention data your server admin panel will never show you.

How it works

clan.me tracks your server in two modes:

  • Poller mode (automatic): clan.me polls your server's status every few minutes using the standard Minecraft server list ping protocol. Player counts, uptime, and version are tracked with no installation required. Your dashboard goes live within minutes of submitting.
  • Plugin mode (full analytics): install the clan.me Paper plugin and your server sends a heartbeat to clan.me every minute. This unlocks TPS, MSPT, heap memory, session tracking, player retention, and the full analytics dashboard.

Step 1: Submit your server

Go to the Owner Dashboard and submit your server's address. You'll need:

  • Your server's hostname or IP address
  • Your query port (same as the main port by default, usually 25565)

Within a few minutes, clan.me's poller will reach your server and create your public listing page at clan.me/minecraft/your-server-name. Player counts, uptime percentage, and version data will start populating immediately.

Make sure query is enabled

In your server's server.properties, check that enable-query=true and that query.port matches the port you submitted. Most Paper servers have this enabled by default.

Step 2: Install the plugin

Download the clan.me plugin from Modrinth or Hangar. Drop the .jar into your server's plugins/ folder and restart.

The plugin requires Paper 1.20.4 or newer. Folia is not yet supported.

Step 3: Pair the plugin

After the first restart, the plugin creates a plugins/ClanMe/config.yml file. Open it and paste in your plugin token:

# clan.me plugin configuration
token: "paste-your-token-here"

Find your token on the Owner Dashboard under your server's settings. Paste it in, save the file, and run /clanme reload in-game or restart the server. You should see a confirmation in console within 60 seconds as the first heartbeat is sent.

What's next

Once paired, the dashboard populates over the next few hours as data accumulates:

  • TPS and MSPT over time, the performance history you've never had before
  • New vs returning player ratios, session lengths, and retention trends
  • Proactive alerts when TPS drops, memory spikes, or your player count hits a new peak

Set up alerts from the Alerts tab in your dashboard so you're notified before players feel performance issues.

← Back to Help Center
Connect your Minecraft server to clan.me — clan.me Help