Connect your Minecraft server to clan.me

clan.me gives your server a hosted analytics dashboard, proactive alerts, and a public status page. Everything is powered by the clan.me plugin: TPS, MSPT, memory, player sessions, and retention data your server admin panel will never show you. Setup takes about five minutes.

How it works

The clan.me plugin sends a heartbeat from your server to clan.me every minute, an outbound HTTPS request containing your server's performance metrics, player sessions, and config snapshot. No inbound ports need to be opened and nothing polls your server. Those heartbeats power your analytics dashboard, all eight alert types, and your public status page at clan.me/minecraft/your-server-name.

Step 1: Add your server

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

• Your server's hostname or IP address
• Your port (usually 25565)

clan.me checks your server once to pre-fill details like the version, MOTD, and icon, then creates your server page and generates your plugin token. The page fills with real data as soon as the plugin starts sending heartbeats.

Step 2: Install the plugin

Go to clan.me/download to get the JAR for your server software, then drop it into your plugins/ folder and restart. Paper or Spigot 1.21 or newer is required. Folia is not yet supported.

Step 3: Pair the plugin

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

# clan.me Plugin Configuration
plugin_token: "paste-your-token-here"

Find your token on the Owner Dashboard under your server's settings. Paste it in, save the file, and restart your server so the plugin picks up the new token. Within about a minute you'll see a confirmation in the console 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.

For a full breakdown of every setting in config.yml, see the Plugin config.yml reference.

Running a BungeeCord or Velocity network? Connect your lobby the same way above, then see Monitoring a network for how backends, tokens, and alerts work across your whole setup.