louixscult/querylabel

A MCPE query library for PHP

v1.0.0 2026-04-26 16:07 UTC

MIT

README

QueryLabel

MCPE query library for PHP

Introduction

QueryLabel is a library for PocketMine-MP To make a query to an MCPE server using sockets. The library will retrieve the data and transform it into an object, which can then be serialized.

Instalation

You can use the library in Composer.

Example:

composer require louixscult/querylabel

You can also use it in Poggit plugins. Example of use in poggit.yml file:

---
build-by-default: true
branches:
- yourpluginbranch
projects:
  YourProjectName:
    libs:
      - src: louixscult\QueryLabel
        version: ^1.0.0
    path: ''
...

Using the library

You can perform a query using the QueryHandle::query() method. It works by sending a query, using sockets, thus returning the data from the server, therefore, transforming raw data and returning the object ServerQuery

Example (Using Composer)

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

use louixscult\querylabel\QueryHandler;

// returns a ServerQuery obj
$queryData = QueryHandler::query(
  'myserver.xyz', // address
  19132, // port
  3 // tries
)->jsonSerialize(); // suport for serialize the obj

var_dump($queryData);

The object also has methods related to server data, allowing you to retrieve information from the server more easily.

Example of a query to retrieve the number of players on the server (Using Composer)

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

use louixscult\querylabel\QueryHandler;

$query = QueryHandler::query('myserver.xyz', 19132);
$players = $query->getPlayersCount();

echo 'There are ' . $players . ' players in this server';