Skip to content

Query tool for Minecraft: Bedrock Edition servers.

License

Notifications You must be signed in to change notification settings

w-gao/py-mcpe-query

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

mcquery

PyPI

Introduction


mcquery (aka py-mcpe-query) is a Python software that uses the query protocol to ping a Minecraft: Bedrock edition server for basic information.

Note: If you get a timeout error, it might be that the target server do not support the query protocol. If that happens, you can use mcstats instead, where you can ping a server without the query protocol.

Install


Install via pip

Run pip install mcquery in your terminal, and it will install the latest version of this project in your Python environment.

Install from source

Clone this repository and run the following in the root folder of this project:

python setup.py build install

Usage


Query with CLI

After installation, the mcquery command will be available in your Python environment. You can perform a query with the following command: mcquery localhost.

Example:

$ mcquery play.lbsg.net
Motd: None
Hostname: {-name-:-Lifeboat Proxy-,-node-:{-type-:-PROXY-,-ip-:-proxy14.lbsg.net-,-players-:91,-maxplayers-:400,-tps-:39.950001}}
Game type: None
Game id: None
Version: None
Server engine: None
Plugins: ['']
Map: None
Num players: 91
Max players: 400
Whitelist: None
Host ip: **.***.**.**
Host port: 19132
Players: []

You can also specify the port with the -p option (e.g.: mcquery localhost -p 19133). For more options, please run mcquery --help.

Use as a module

You can also use the API by writing the following code in your project:

from mcquery import mcquery

host = "localhost"
port = 19132

with mcquery(host, port=port, timeout=10) as data:
    # data is a QueryServerData object
    print(data)

License


MIT © 2017-2021 w-gao