FastStatsFastStats

Server Information

FastStats is a metrics service used by Hytale and Minecraft plugin and mod developers to understand how their projects are used in the real world. As a server administrator, you do not integrate with FastStats directly. Instead, FastStats may be included in plugins or mods that you choose to install on your server.

What FastStats Is Used For

FastStats helps plugin and mod developers answer questions such as:

  • How many servers are using a plugin
  • How many players are affected overall
  • Which server software and versions are commonly used
  • What errors are occurring in their plugins or mods

This information allows developers to:

  • Prioritize bug fixes and compatibility
  • Decide which platforms and versions to support
  • Measure general adoption of their projects

FastStats is not used for advertising, tracking individual servers, or identifying players.

What Data Is Collected

FastStats transmits a lightweight metrics payload on a fixed schedule. The fields below describe exactly what is sent.

Standard payload

Included in every request. Individual fields cannot be turned off.

Server

Server ID
Randomly generated identifier used internally to prevent duplicate counting
Player count
Current number of online players
Online mode
Whether the server runs in online or offline mode
Country
Approximate country inferred by Cloudflare — your IP address is never stored

Software

Platform
Server software name (e.g. Paper, Folia, Velocity, Fabric, Hytale)
Platform version
Version of the server software
Game version
Version of the game (e.g. Minecraft 1.21, Hytale build)
Plugin version
Version of the plugin or mod that includes FastStats
Client mod
Whether the mod runs on the client rather than on the server

System

Operating system
OS name (e.g. Linux, Windows, macOS)
OS version
Operating system version
OS architecture
CPU architecture (e.g. x86_64, aarch64)
CPU core count
Number of CPU cores available to the server

Java

Java version
Runtime version (e.g. 21.0.2)
Java vendor
Java distribution vendor (e.g. Eclipse Temurin, Oracle)

Additional data

May be included when a plugin or mod developer has enabled error tracking or custom metrics.

Error tracking
Error messages and stack traces from the plugin or mod itself
Custom metrics
Additional values defined by the plugin developer (e.g. feature usage counters)

Error anonymization

When error tracking is enabled, all error data is automatically anonymized before transmission.

Folder paths that may contain usernames are redacted (e.g. /home/name, /Users/name, C:\Users\name)
IPv4 and IPv6 addresses are redacted
The system username (user.name property) is redacted
Errors are deduplicated to avoid transmitting the same error multiple times

Error tracking and custom metrics are controlled by the plugin developer and can be disabled independently of the standard payload.

What Is Not Collected

FastStats is designed to avoid collecting personal or identifying data. Specifically:

  • No IP addresses

    All requests are proxied. FastStats never receives or stores your server's IP address. Only an approximate country is inferred by Cloudflare.

  • No player data

    No usernames, UUIDs, or other player identifiers are collected.

  • No server fingerprinting

    FastStats does not attempt to uniquely fingerprint or track servers across reinstalls.

  • No personal data

    Data that could reasonably identify a person or make a server uniquely traceable is not collected.

The server ID used by FastStats is internal, randomly generated, and not publicly derivable.

Anonymity & Privacy

All data sent to FastStats is handled in an anonymous and aggregated manner.

While FastStats uses a server ID internally to prevent duplicate counting, this identifier:

  • Can be regenerated by the administrator
  • Is not exposed publicly
  • Cannot be used to identify your server by third parties

FastStats does not sell or share collected data with external parties.

Performance Impact

Enabling FastStats has no noticeable performance impact on your server. Metrics are lightweight and sent at low frequency.

Default request

~215 bytes (±15)

With one error

~400 bytes

Per error added

~200 bytes

Error tracking, when enabled by a plugin, has minimal network overhead. Errors happen very infrequently, are transmitted every 30 minutes alongside normal metrics, and are deduplicated to prevent sending the same error multiple times.

Opting Out & Server ID Control

As a server administrator, you are always in control.

You can:

  • Disable metrics collection entirely
  • Re-roll (regenerate) your server ID

Metrics collection is enabled by default, but:

  • No data is transmitted unless a plugin explicitly includes FastStats
  • Plugin developers must opt in by integrating FastStats into their plugin
  • Administrators may opt out at any time

To opt out, set enabled=false in your plugins/faststats/config.properties file.

Abuse Reporting

If you believe a plugin or mod is misusing FastStats, please report it.

Examples of abuse include:

  • Ignoring or bypassing the metrics enabled option
  • Sending metrics after an administrator opted out
  • Artificially inflating statistics
  • Collecting personal data
  • Violating FastStats' Terms of Service

How to Report Abuse

Submit a report at: https://faststats.dev/abuse

What Happens After a Report

  • Every report is reviewed
  • The project owner is informed
  • Illegitimate data may be removed if necessary
  • Continued non-compliance can result in plugin removal or developer bans after repeated offenses
  • All abuse reports receive a response via email

Terms of Service

FastStats has a formal Terms of Service that plugin developers are required to follow.

You can review them here: https://faststats.dev/tos

These terms provide more detailed and legally binding explanations of acceptable usage.

You're a plugin developer yourself?

Join our Discord to grab an invite code and try FastStats while we're in closed beta.

Join Discord