Nagios plugin to check the status of minecraft servers. Supports Minecraft 1.5, 1.6, and 1.7. Tested on MCPC+, Spigot, CraftBukkit, and Vanilla servers
Attempts to connect to a minecraft server on the specified host:port. After connecting, a server ping packet that corresponds to the version of Minecraft specified is created and sent to the server. If the server responds, the response is decoded to determine the number of players online, the max number of players, and time taken to complete the process.
If the port is not specified, the default port number of 25565 will be used.
-? Display this documentation.
-V Version of the minecraft server to be checked **[required]**
15 - Minecraft version 1.5.x
16 - Minecraft version 1.6.x
17 - Minecraft version 1.7.x
-P TCP port to connect to the server. Defaults to 25565 [optional]
-H Hostname or IP of the minecraft server **[required]** Command-Line Example ------------------------- $ ./check_minecraft -H localhost -V 17 MINECRAFT SERVER READY - 0/100 online|0.219s Nagios configuration examples ------------------------- define command{ command_name check_minecraft command_line /usr/lib/nagios/plugins/check_minecraft -H $ARG1$ -V $ARG2$ } # Minecraft 1.5 Server Ping Check define service{ hostgroup_name minecraft-15-servers service_description Minecraft 1.5 check_command check_minecraft!$HOSTADDRESS$!15 use generic-service notification_interval 5 ; set > 0 if you want to be renotified } # Minecraft 1.6 Server Ping Check define service{ hostgroup_name minecraft-16-servers service_description Minecraft 1.6 check_command check_minecraft!$HOSTADDRESS$!16 use generic-service notification_interval 5 ; set > 0 if you want to be renotified } # Minecraft 1.7 Server Ping Check define service{ hostgroup_name minecraft-17-servers service_description Minecraft 1.7 check_command check_minecraft!$HOSTADDRESS$!17 use generic-service notification_interval 5 ; set > 0 if you want to be renotified } [](http://githalytics.com/jmarler/check_minecraft)