📊 WhyTheyLeave
📊 Turn joins and leaves into real retention insight.
Overview
WhyTheyLeave records every join and leave on your server, capturing session length and activity such as blocks moved, broken, and placed, chat messages, commands, deaths, and interactions. It turns that raw data into server metrics, retention analysis, session-duration distributions, top-player leaderboards, live session views, and short-term trends, flagging quick leaves and rewarding engaged players. Built for administrators who want data-driven answers about player retention and long-term server health, with fully customizable messages and tunable thresholds.
Features
Join/Leave Tracking
Records every connection and departure with detailed per-session activity metrics.
Retention Analysis
Breaks players down by visit frequency and recent activity over the last 7 and 30 days.
Session Distributions
Buckets sessions by duration and flags critical quick-leaves versus engaged 2+ hour stays.
Top Players
Leaderboards by playtime, join count, or activity score with a configurable limit.
Live & Trends
View currently online sessions in real time plus 24-hour and 7-day player trends.
Commands
/wtl [subcommand]Subcommands: infos (server metrics), player <name> (per-player stats), top [time|joins|activity] [limit], retention, sessions, live, trends, reload, and reset confirm.
Permissions
whytheyleave.adminAllows access to all WhyTheyLeave commands.
Default: opInstallation
- 1Drop WhyTheyLeave.jar into your server's /plugins folder.
- 2Restart the server (built for Minecraft 1.21, Paper).
- 3Tracking starts automatically; customize messages and thresholds in config.yml.
Configuration
config.yml sets the auto-save interval, max sessions per player, quick/very-quick leave thresholds, an admin join message toggle, and a fully customizable set of color-coded messages.
🤖 WhyTheyLeave was created with Spaleforce AI.
Create your own for free