Skip to content

Minecraft playercount metrics on Instatus

License

Noxcrew/instatus-minecraft

Repository files navigation

instatus-minecraft

Queries a Minecraft server instance and sends the playercount as metric to Instatus to visualize your server's playercount on your Instatus page.

As seen on MCC's status page.

CleanShot 2025-07-17 at 22 14 59@2x

Usage

A Docker image is available at ghcr.io/noxcrew/instatus-minecraft:latest. Configure it with the environment variables below.

Configuration / Environment Variables

  • INSTATUS_PAGE_ID: The unique identifier for the Instatus status page.
  • INSTATUS_METRIC_ID: The unique identifier for the metric to update on Instatus.
  • INSTATUS_TOKEN: The authentication token used to access the Instatus API.
  • MC_SERVER_IP: The IP address of the Minecraft server to monitor. Defaults to "play.mccisland.net".
  • QUERY_INTERVAL: The interval (in seconds) between server status queries. Defaults to "30".

About

Minecraft playercount metrics on Instatus

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages