Help Center
Guides and reference for getting the most out of clan.me, from connecting your server to understanding your analytics.
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.
Poller mode vs plugin mode: what each one gives you
A side-by-side comparison of what clan.me tracks from standard server list polling versus the full data set available with the plugin installed.
How clan.me polls your server
The Minecraft server list ping protocol, what data it returns, and how clan.me uses it to build your public page and uptime history.
Your server's public listing page
What appears on your clan.me listing page, how your URL slug is generated, and how to edit your server's details.
Player opt-out: what is stored and how to remove your data
What player data clan.me collects from public server pings, and how players can opt out and have their data removed.
TPS and MSPT: what they measure and what to watch for
What TPS and MSPT tell you about your Minecraft server's performance and how to interpret the numbers in your clan.me analytics dashboard.
Heap memory and Java GC: why your server runs out of breath
What the JVM heap is, how garbage collection pauses affect TPS, and how to size your server's memory correctly.
Entity count: why mob farms and item piles kill performance
What counts as an entity, why high entity counts hurt TPS, and how clan.me's per-world tracking helps you find the culprit.
How the server health score works
What the 0 to 100 health score measures, how it's calculated from TPS, memory, uptime, and entity load, and how to interpret it.
Loaded chunks and why they matter
What a loaded chunk is, the difference between view distance and simulation distance, and how chunk count affects memory and performance.
Getting started with alerts
An overview of clan.me's 8 alert types, the 4 delivery channels, and the recommended configuration for a new server.
The TPS drop alert
What triggers the TPS drop alert, what the notification email contains, and how to set a threshold appropriate for your server.
The memory pressure alert
What triggers the memory pressure alert, what the notification contains, and what to do when it fires.
The entity spike alert
What triggers the entity spike alert, what the notification contains, and the most common causes of sudden entity count spikes.
The offline alert
What triggers the offline alert, how it differs from a missed poll, and what context the alert email includes.
The weekly retention digest
What the Monday retention email contains, how to read the new and returning player numbers, and why it's the most important weekly signal for your server.
Setting up webhook alerts
What a webhook alert delivers, how the JSON payload is structured, and how to integrate it with Discord, Slack, or a custom monitoring tool.
In-game operator alerts
How in-game alerts work, which alert types support in-game delivery, and what permission level is required to receive them.
How session tracking works
How clan.me defines a player session, how sessions are detected in plugin mode versus poller mode, and what session data appears in the dashboard.
New vs returning players: how clan.me categorises them
How clan.me decides whether a player is new or returning, and why the split is a more useful growth signal than raw player count.
The just-spotted feed
What the just-spotted feed shows on your server's public listing page, how it refreshes, and how opted-out players appear.
Player profile pages
What a player profile page shows, how to find a player's profile, and how opt-out affects what's visible.
Reading your retention numbers
How clan.me calculates retention, what a healthy retention rate looks like, and how to use week-over-week changes to track server health over time.
The peak hour heatmap
How the peak hour heatmap is built from 30 days of player data, how to read the colour scale, and practical uses for scheduling events and maintenance.
Unique players: daily, weekly, and monthly explained
What DAU, WAU, and MAU mean for your Minecraft server, how they differ from session counts, and what the D/W/MAU ratio tells you about your community.
Plugin monitoring: tracking what's installed and what's outdated
How clan.me tracks your installed plugins, how outdated versions are detected, and how to use the plugin list in your dashboard.
Server config snapshot
What settings clan.me captures in the server config snapshot, when it updates, and how config history helps you track accidental changes.