[WEB] [PHP] Simple to use minecraft server status query!

Minecraft Server Status Query, written in PHP, with online players, motd, favicon and more server related informations without plugins and enable-query.

Tested with Spigot 1.9 and Bungeecord 1.9 & 1.8

https://github.com/FunnyItsElmo/PHP-Minecraft-Server-Status-Query

Installation

Code:

composer require funnyitselmo/minecraftserverstatus

Tutorial

Code:

use MinecraftServerStatus\MinecraftServerStatus;

require '../vendor/autoload.php';

$response = MinecraftServerStatus::query('lostforce.com', 25565);

if (! $response) {
    echo "The Server is offline!";
} else {
    echo "<img width=\"64\" height=\"64\" src=\"" . $response['favicon'] . "\" /> <br>
        The Server " . $response['hostname'] . " is running on " . $response['version'] . " and is online,
        currently are " . $response['players'] . " players online
        of a maximum of " . $response['max_players'] . ". The motd of the server is '" . $response['description'] . "'.
        The server has a ping of " . $response['ping'] . " milliseconds.";
}

If the server is offline MinecraftServerStatus::query returns false else it returns an array which contains the server informations.

Variables
The table contains the aviable variables the response can contain.
The default content of each variable is false.

'hostname' Exact server address in 127.0.0.1 format
'port' The servers port for example 25565
'ping' The time in ms the server needs to answer
'version' The server version (for example: 1.7.2)
'protocol' The server protocol (for example: 4)
'players' Amount of players who are currently online
'max_players' Number of the slots of the server
'description' The message of the day of the server
'description_raw' The raw version of description (contains color codes etc.)
'favicon' The favicon of the server in a base64 string (Can be displayed with the html img tag by setting the string as src)
'modinfo' Informations about the plugins

 

Warning: socket_connect() expects parameter 1 to be resource, null given in /xxx/xxx/public_html/online/status.class.php on line 23
Warning: socket_create() has been disabled for security reasons in /xxx/xxx/public_html/online/status.class.php on line 22

 

Speaw you use a free host right? On free hosts the script dont work because the socket methods are diabled.

 

http://sonoyuncu.com
Not free.

 

Then your web server is configured incorrectly or you have an outdated php version.

 

The key line to this error is;
Warning: socket_create() has been disabled for security reasons in /xxx/xxx/public_html/online/status.class.php on line22

It means function "socket_create()" is disabled on the host for security reasons lol.

You should contact your host for more info, if they can enable it for you.

 

Thanks a lot!

 

There will be a swarm of kids trying this with no PHP knowledge.

 

Then tell those kids to use a pre-configured server. Awesomestatus: http://mctools.tyzoid.com/mcb/

 

Having some trouble, This is how I have it setup:
HTML Part:

HTML:

<?php
include_once '/home/content/85/9477285/html/uniqueminecraftservers/listener/MCSS.php';
$status = new MinecraftServerStatus();
$response = $status->getStatus('75.127.12.73');
?>
<tr>
        <td class="trank">*</td>
        <td class="tname"><p class="wrap-tname"><a href="server/70.170.21.9.php">RandomCraft</a></p></td>
        <td class="tserver">
 
<a href="server/70.170.21.9.php"><img style="border:none;width:468px;height:60px;" src="/uniqueminecraftservers/slist/banners/1.jpg"></a>
 
<br>IP: 70.170.21.9:25565</td>
        <td class="ttype"><p class="wrap-ttype">Mini-Game</p></td>
        <td class="tplayers"></td>
 
        <td class="tstatus Online">
<?php
if(!$response) {
echo"Offline";
} else {
echo"Online";
}
?>
 
</td>
        </tr>

PHP Script:

PHP:

<?php
 
    /**
    * Minecraft Server Status Query
    * @author Julian Spravil <[email protected]> https://github.com/FunnyItsElmo
    * @license Free to use but dont remove the author, license and copyright
    * @copyright © 2013 Julian Spravil
    */
    class MinecraftServerStatus {
        private $timeout;
 
        /**
        * Prepares the class.
        * @param int    $timeout  default(3)
        */
        public function __construct($timeout = 5) {
            $this->timeout = $timeout;
        }
 
        /**
        * Gets the status of the target server.
        * @param string    $host    domain or ip address
        * @param int    $port    default(25565)
        */
        public function getStatus($host = '127.0.0.1', $port = 25565) {
 
            //Transform domain to ip address.
            if (substr_count($host , '.') != 4) $host = gethostbyname($host);
 
            //Get timestamp for the ping
            $start = microtime(true);
 
            //Connect to the server
            if(!$socket = @stream_socket_client('tcp://'.$host.':'.$port, $errno, $errstr, $this->timeout)) {
 
                //Server is offline
                return false;
 
 
            } else {
 
                stream_set_timeout($socket, $this->timeout);
 
                //Write and read data
                fwrite($socket, "\xFE\x01");
                $data = fread($socket, 2048);
                fclose($socket);
                if($data == null) return false;
 
                //Calculate the ping
                $ping = round((microtime(true)-$start)*1000);
 
                //Evaluate the received data
                if (substr((String)$data, 3, 5) == "\x00\xa7\x00\x31\x00"){
 
                    $result = explode("\x00", mb_convert_encoding(substr((String)$data, 15), 'UTF-8', 'UCS-2'));
                    $motd = preg_replace("/(§.)/", "",$result[1]);
 
                }else{
 
                    $result = explode('§', mb_convert_encoding(substr((String)$data, 3), 'UTF-8', 'UCS-2'));
 
                    $motd = "";
                    foreach ($result as $key => $string) {
                        if($key != sizeof($result)-1 && $key != sizeof($result)-2 && $key != 0) {
                            $motd .= '§'.$string;
                        }
                    }
 
                    $motd = preg_replace("/(§.)/", "", $motd);
 
                }
                //Remove all special characters from a string
                $motd = preg_replace("/[^[:alnum:][:punct:] ]/", "", $motd);
 
                //Set variables
                $res = array();
                $res['hostname'] = $host;
                $res['version'] = $result[0];
                $res['motd'] = $motd;
                $res['players'] = $result[sizeof($result)-2];
                $res['maxplayers'] = $result[sizeof($result)-1];
                $res['ping'] = $ping;
 
                //return obj
                return $res;
            }
 
        }
    }
 
?>

It shows offline all the time. I am pinging a server I KNOW is online.

 

try going to the servers properties file and setting enable jquery true?

huh LOL I'm getting the same problem too XD I set enable-JQuery to true tho?

EDIT by Moderator: merged posts, please use the edit button instead of double posting.

 

You can't place the class last you need to save the class into a different file "query.class.php" then at the very top do

Code:php

 
<?php
require_once('path/query.class.php');
?>
 

Then instantiate the class and use it.

 

I'm not, this is what I'm doing:

PHP:

<body>
 
<?php
 
include_once 'status.class.php'; //include the class
$status = new MCServerStatus(); // call the class
 
$response = $status->getStatus('shadowcraft.pwnz.org'); // call the function
 
$statusTxt = "offline";
$version ="N/A";
$ping ="N/A";
$players = "0/0";
 
if($response){
    $statusTxt="online";
    $players = $response['players'] . "/" . $response['maxplayers'];
    $version = $response['version'];
    $ping = $response['ping'];
}
 
?>
<div id="banner">
<div id="status"><?php
echo$statusTxt;
?></div>
<div id="version"><?php
echo$version;
?></div>
<div id="ping"><?php
echo$ping;
?></div>
<div id="players"><?php
echo$players;
?></div>
</div>
 
</body>

inside the body of course

 

I'm not sure, I've used a lot of classes for query lately and they've all been failing.

 

Thanks, This was very useful.

 

Error.....

PHP:

include_once 'status.class.php'; //include the class

You missed the brackets.

Fixed.....

PHP:

include_once('status.class.php'); //include the class

Brackets activated!

 

This script doesnt work. No errors. I have tested this on several servers which has query enabled, with the correct port.

 

Tested, works fine on my main server Windows Server 2012 w/IIS. Thanks for the script!

Amended: Using IIS 8

 

Just a heads up, pining 1.7 servers return an array for version and players. I just use the implode() method to remove the array part.

 

Parenthesis* are not needed for include, include_once, require, or require_once functions.

 

include, include_once, require, etc. are not functions to begin with.

It won't cause an error, but standard practice is to put parentheses around includes.

 

Good point, they're statements. While it is standard practice, I was pointing out that they aren't required as my quoted post clearly defined.

 

Please fix this: https://github.com/FunnyItsElmo/PHP-Minecraft-Server-Status-Query/issues/8

 

xPaw's one still works. Can successfully ping a 1.7.2 server (Dev Bukkit one) My script can ping it. (I tested it )

See it by yourself, 1.7.2 running http://s.rightawake.com/queryd/query.php?ip=tntup.me&port=25565&mode=1

 

What is the server is running Bungee?

 

Tried on my bun.gee test server, query works. It must be enabled in its config to be able to query it

 

Okay the status query is updated to the minecraft version 1.7.* hope all your problems are fixed. Please take a look at the new tutorial some things has changed

 

heh heh, http://x10hosting.com has sockets enabled, and its free

 

It says the server "mcctf.com" have 0/0 players online, but there's people playing D:


Can you help me?

 

Dosen't work...
error: http://pastebin.com/CrNV9qMk
I tried it both with my server, and several others.