Connect Your
Server
To clanme
clanme gives your server a live analytics dashboard, with player retention, TPS trends, session lengths, peak hours, and uptime history. Get proactive email alerts for server downtime, lag spikes, and performance issues, all tracked automatically from the moment you connect.
Connect your server
+ Access your dashboardTPS + MSPT
Performance tracking
60-second resolution
30 days
Analytics history
Hourly chart data
Sessions
True play sessions
Login, logout, length
Retention
New vs returning
Weekly breakdown
What you get
Analytics built for server owners
Do your players actually come back?
New vs returning breakdown, session length distribution, and weekly retention rates, tracked automatically. Most server admins are guessing. After the first week, you won't be.
Stop diagnosing lag by feel
TPS history, MSPT, entity counts per world, and memory usage, logged every 60 seconds. When something goes wrong you'll see exactly when it started and which world it came from.
Know your peak hours before they happen
30-day hourly breakdowns show exactly when your server is busiest. Schedule maintenance, plan events, and staff your best hours, based on data, not guesswork.
Give players somewhere to check
Every connected server gets a public analytics page, with uptime record, peak hours, and live player count. Drop the link in your Discord and let your track record speak for itself.
Getting started
Up and running in three steps
Register your server
Submit your server address to create your analytics page and receive your unique server token.
Drop the .jar in your plugins folder
Available on Modrinth, Hangar, and SpigotMC. No ports to open, no firewall changes. Heartbeats go outbound only.
Add your token to config.yml and restart
# plugins/clanme/config.yml
server-token: your-token-here
Full analytics suite live within 60 seconds of first boot.
Everything the plugin unlocks
- TPS & MSPT over time
- Memory & CPU trends
- Entity counts per world
- True player sessions
- Retention analytics
- Death events
- Chat message rate
- Server config snapshot
- Server owner account
Proactive alerts
Know before your players do
When the plugin detects a problem, you get an email with the server context already included: which world, which plugin just loaded, what the memory pressure was at that moment. Go straight to the fix instead of starting from scratch.
Server offline
No heartbeat received for 5 minutes
Email includes: Last known TPS, player count, and memory % before silence
TPS drop
5-minute TPS falls below your threshold (default 16.0)
Email includes: Current TPS, which world has the highest entity count, player count, memory %
Memory pressure
Heap usage crosses 85% of your server's max
Email includes: Heap used and max in MB, GC pressure %, entity count, player count
Entity spike
Any world's entity count spikes to 3× its normal level
Email includes: World name, entity count vs 7-day average, current TPS, player count
Plugin correlation
TPS drops within 5 minutes of a new plugin loading
Email includes: Plugin name and version, TPS before and after, entity count and memory snapshot
Death spike
Deaths per hour cross 3× your server's normal rate
Email includes: Deaths this hour vs 30-day baseline, current player count, TPS
Weekly retention digest
Every Monday: new players this week, the percentage who came back for a second session, and the same week last month for comparison. The slowest-burning signal and the most important one. A 5% new-player return rate is almost always an onboarding problem, not an acquisition problem.
The plugin sends outbound heartbeats only, capturing server performance metrics and never storing chat content, only message rate. Player names and UUIDs are linked to public Mojang profiles; players may opt out at clan.me/optout.
Common questions
What versions does the plugin support?
The plugin targets Paper 1.20+ at launch. Spigot compatibility is planned.
Does the plugin require open ports?
No. The plugin sends outbound heartbeats only, a POST to clan.me every 30 seconds. Nothing needs to reach your server from outside. Your firewall and network config stay exactly as they are.
How far back does analytics data go?
Raw ping data is kept for 30 days. Hourly aggregates used for charts are kept indefinitely. The longer your server is connected, the richer your trend data becomes.
Is player data GDPR compliant?
Yes. Player names and UUIDs are linked to public Mojang profiles. Players can opt out at clan.me/optout for full erasure. See our Privacy Policy for the full Article 17 detail.
Is any of this paid?
No. All analytics features are free. We may introduce optional paid features later, existing free functionality will stay free.
Can I keep my analytics page private?
Yes. Use your edit token to control your page's visibility. Analytics continue running regardless of whether your page is publicly accessible.
Full analytics, live in 60 seconds.
Install the plugin and get TPS trends, player retention, session analytics, proactive email alerts, and 30 days of chart history, all free. Launching soon for Paper 1.20+.
Connect your server
+ Access your dashboard