How the server health score works

The server health score is a single number between 0 and 100 that summarises how well your server is performing across all the dimensions clan.me tracks. It updates every minute with each heartbeat.

What it measures

The score combines four inputs, each weighted to reflect how much it affects the player experience:

• TPS stability, the heaviest weight: based on your 5-minute average TPS relative to 20.0. A server holding 19.8 TPS scores near 100 on this component; a server at 15 TPS scores around 50
• Uptime percentage: your rolling 24-hour uptime. A server offline for 2 hours out of 24 scores around 92 on this component
• Memory headroom: the inverse of heap usage as a percentage of max. A server using 40% of its heap scores 60 here; one using 80% scores 20
• Entity load: current entity count relative to your 7-day average. Normal entity levels score 100; three times the average scores much lower

How it's calculated

The four component scores are combined with different weights. TPS stability carries the most weight because it is the most direct measure of player-facing performance. Uptime and memory headroom carry equal moderate weight. Entity load carries a lighter weight because elevated entity counts are sometimes deliberate, as in large mob farms, and don't always directly translate to player-reported lag.

The final score is rounded to the nearest integer and clipped to the 0 to 100 range. A brief TPS spike will affect it, but a stable recovery brings it back within minutes.

Interpreting the score

The health score is most useful as a trend, not a snapshot. A score of 72 trending down from 90 over the past week is more concerning than a score of 65 that has been stable for a month.