QueryHy - HTTP Server Query

Provides a configurable HTTP JSON API endpoint exposing live server stats including player count, max players, MOTD, uptime, server name, and view distance. Perfect for server lists, monitoring tools, and status pages.
Install via App

File Details
DownloadInstall

queryhy-1.0.1.jar

Byjan2k17
  • R
  • Apr 24, 2026
  • 286.01 KB
  • 11
  • Early Access

File Name

queryhy-1.0.1.jar

Supported Versions

  • Early Access

1.0.1

Added

  • Added configurable IP-based rate limiting to reduce flooding on the /query endpoint.
  • Added token-bucket burst handling for smoother request limiting under short traffic spikes.
  • Added automatic cleanup of expired rate-limit entries to prevent unnecessary memory growth over long runtimes.
  • Added JSON error responses with HTTP 429 when clients exceed the configured request limit.
  • Added a Retry-After response header for rate-limited requests.
  • Added a safe fallback response with HTTP 503 if the plugin instance is temporarily unavailable.

Changed

  • Updated the configuration with new rate-limit settings: enableRateLimit, rateLimitRequestsPerSecond, rateLimitBurstCapacity, and rateLimitEntryExpireSeconds.
  • Improved internal request handling for better protection against spam and abusive polling.
  • Cleaned up and standardized the code structure for better readability and maintainability.

Fixed

  • Fixed several code quality issues in the query server implementation, including raw collection usage being cleaned up in the revised code structure.
  • Fixed stability issues around request processing by introducing explicit error handling for unavailable plugin state.