MCStat 1.2.2

AFK time that an AFK setup cannot fake. Riding a vehicle, drifting in a water stream or bubble column, jumping in place and a camera that twitches a few degrees no longer count as activity, and neither does clicking without moving (auto-clickers at farms). Walking to another block on foot, looking around, inventory clicks, chat and commands still do. MCStat subtracts AFK time from playtime and activity points, so this keeps rankings honest. Replace the jar to update.

File	Platform
McStat-Spigot-1.2.2.jar	Bukkit / Spigot / Paper / Purpur / Pufferfish / Folia (Minecraft 1.13+)
McStat-Velocity-1.2.2.jar	Velocity 3.x
McStat-BungeeCord-1.2.2.jar	BungeeCord / Waterfall
McStat-Plugin-Source-1.2.2.tar.gz	Source (Maven)

Full 1.2.0 notes: https://github.com/mcstatorg/MCStat-Plugin/releases/tag/v1.2.0

MCStat 1.2.1

Console and in-game wording now uses the same words as the MCStat dashboard in Hungarian, Swedish, Polish and Greek. No behaviour changes; replace the jar to update.

File	Platform
McStat-Spigot-1.2.1.jar	Bukkit / Spigot / Paper / Purpur / Pufferfish / Folia (Minecraft 1.13+)
McStat-Velocity-1.2.1.jar	Velocity 3.x
McStat-BungeeCord-1.2.1.jar	BungeeCord / Waterfall
McStat-Plugin-Source-1.2.1.tar.gz	Source (Maven)

Full 1.2.0 notes: https://github.com/mcstatorg/MCStat-Plugin/releases/tag/v1.2.0

MCStat 1.2.0

MCStat 1.2.0 turns the plugin from a heartbeat sender into a full analytics source: your MCStat dashboard now shows every player, their sessions and what they do, and how the server performs.

Requires an updated MCStat site (live now). 1.1.x keeps working; upgrade to get the new statistics.

New

• Gameplay statistics: blocks broken and placed (per block type), mob and player kills (per mob), deaths (per cause), distance travelled, items crafted, fish caught, items enchanted, experience gained, advancements, and chat/command activity — counted, never read.
• AFK time inside every session (threshold set in the dashboard).
• Performance: TPS, tick time (MSPT on Paper), CPU, memory, loaded chunks and entities.
• Audience data: Minecraft version (ViaVersion-aware), client brand, client language, Java or Bedrock (Floodgate), country and the join address (domain) players connected through.
• Country lookup stays on your server: the plugin downloads the free DB-IP Lite country database (refreshed monthly) and resolves countries locally; player IP addresses are never sent.
• Offline-mode (cracked) and Bedrock players are tracked per server like everyone else.
• Dashboard control: choose modules, report interval (30–300 s) and the AFK threshold per server in the MCStat dashboard; the plugin applies changes within a minute, no restart.
• Local switches (metrics.*) can keep any module off on your server whatever the dashboard says, including new client-info, country and join-address.
• 35 languages: console in language:, players always in their own client language (/vote, notices).

Reliability

• Events go out as compressed, signed batches every heartbeat; all network work is off the main thread.
• An on-disk spool (plugins/McStat/spool, capped at 20 MB) keeps unsent data through outages and restarts; a retried batch is applied exactly once.
• Folia supported natively; Paper's virtual host used for the join address (no legacy login-event warning).

Upgrade

Stop the server, replace the jar, start it again. Your config.yml keeps working; new keys use their defaults. Then open Dashboard → your server → Plugin to choose what is collected.

File	Platform
McStat-Spigot-1.2.0.jar	Bukkit / Spigot / Paper / Purpur / Pufferfish / Folia (Minecraft 1.13+)
McStat-Velocity-1.2.0.jar	Velocity 3.x
McStat-BungeeCord-1.2.0.jar	BungeeCord / Waterfall
McStat-Plugin-Source-1.2.0.tar.gz	Source (Maven)

IP geolocation by DB-IP (DB-IP Lite, CC BY 4.0).

MCStat Plugin v1.1.5

Fixes heartbeats being rejected as HTTP 401 / HTTP 429 on busy servers.

What was wrong. The plugin stamped X-Timestamp and signed the request when the call was built. OkHttp only dispatches 5 calls per host at a time, so whenever the API was slow, calls waited in the queue and went out carrying a stamp that was already too old — the server rejected them as expired. In the console that reads as server stats rejected: HTTP 401, which looks like a broken API key even though the key was fine. The rejected calls were then retried, and the retries tripped the rate limit, adding HTTP 429.

What changed. An interceptor now stamps and signs every request at the moment it is actually sent, so a call that waited in the queue — or a retry — always carries a fresh signature.

The server side of this was fixed at the same time: the ingest endpoint no longer stalls behind hourly maintenance writes, a database hiccup answers 503 instead of a misleading 401, and plugin telemetry has its own rate-limit budget so a network sending from one IP is not throttled.

Upgrading is optional but recommended. 1.1.4 works against the fixed API. To upgrade: stop the server, replace the jar, start it again. Config is unchanged.

File	Platform
McStat-Spigot-1.1.5.jar	Spigot / Paper / Purpur / Folia
McStat-Velocity-1.1.5.jar	Velocity
McStat-BungeeCord-1.1.5.jar	BungeeCord / Waterfall

MCStat Plugin v1.1.4

Added

• Safe update checks against the official GitHub Releases feed.
• New /mcstat update command to check for the latest platform jar.
• New /mcstat update download command to download the matching jar into the plugin data updates folder.
• New config block: updates.check, updates.notify-admins, updates.auto-download, updates.check-interval-hours.

Safety

• auto-download is disabled by default.
• The plugin never hot-swaps or replaces a running jar.
• Downloaded jars are staged under the plugin data folder; stop the server, replace the old jar, then start it again.
• Background update check failures are quiet to avoid console spam during GitHub or network issues.

MCStat Plugin v1.1.3

Fixes

• Throttles repeated API warning logs so server consoles are not spammed during temporary API errors, validation failures, or rate limits.
• Keeps retry behavior for retryable HTTP responses while summarizing suppressed duplicate warnings once per minute.
• Truncates long API rejection bodies in logs to keep output safe and readable.

Upgrade

Replace your platform jar with the matching v1.1.3 asset and restart the Minecraft server or proxy so the new jar is loaded.

MCStat Plugin v1.1.2

Fixes heartbeat rejection loops by logging API response bodies, avoiding retries for permanent 4xx responses, limiting queued heartbeat flushes, and pairing with the mcstat.org ingest tolerance update for heartbeat TPS/player-list validation.

MCStat Plugin 1.1.1

Fixes config reload handling, reloadable API client and heartbeat scheduler, safer player event sending, proxy session tracking behavior, and publishes updated compiled jars.