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.
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