Minequery - Bukkit

Minequery 1.5
Minequery creates a small server that listens for requests and responds with the port of Minecraft server, the current amount of players online, the max players cap, and the entire player list.

In the past, Minecraft did not have a query protocol and as a result Minequery was created to fulfill the need for a query protocol. Today, this plugin has been replaced with the query protocol that now exists in Minecraft.

Where do I get Minequery?
Version 1.5 of Minequery can be downloaded from here.
The source code of Minequery can be found on GitHub.

How do I install Minequery?
Just copy Minequery.jar into your plugins directory.

Configuring Minequery
There is one configurable option for Minequery that can be placed in server.properties:

minequery-port=25566

minequery-port is the port on which the query server runs on. The default port is 25566.

How do I query servers say from my own server list or my own site?
Currently there is a plugin for Ruby on Rails and a class file for PHP.

If you are code savvy, you'll want to issue this request to the query server:

QUERY

The query server should respond with something like this:

SERVERPORT 25565
PLAYERCOUNT 0
MAXPLAYERS 20
PLAYERLIST []

Since 1.3, you can additionally issue a request for a JSON response to the query server:

QUERY_JSON

The query server will respond with a JSON string:

{"serverPort":25565,"playerCount":0,"maxPlayers":20,"playerList":[]}

How can I contribute?
For starters, you can fork the plugin on GitHub.
Additionally you can create unofficial libraries in different languages for sites to query servers with.

Troubleshooting
If you are having problems, please see the troubleshooting page.

Changelog
1.5 - February 25, 2011
- Changed TSLPC to a default constructor for Bukkit build #415.

1.4 - February 21, 2011
- Fixed an issue where the server port was mistakenly reporting the port of the Minequery server.

1.3 - February 20, 2011
- Removed the shutdown exception. It is now a more friendly message.
- Added QUERY_JSON for JSON queries.
- Minequery now binds to the same IP as the Minecraft server (reads the "server-ip" property).

1.2 - January 23, 2011
- Fixed a null pointer exception on an invalid query. Thanks to daze for the heads up.
- Threaded request handling. Minequery will now respond to multiple connections at once without blocking.
- Added console messages for on enable and on disable.

1.1 - January 20, 2011
- Updated for build #66.

1.0 - January 6, 2011
- First version.

Former release thread: http://forums.bukkit.org/threads/dev-minequery-1-5-a-query-server-that-responds-with-server-info-1317.1358/

You must login to post a comment. Don't have an account? Register to get one!

148 comments
1
2
3
5
7
9
11
13
14
15
Next →

- Reply
- #153
Darrennick May 14, 2012 at 15:14 UTC - 1 like
Any idea on how to use this with Xenporta for Xenforo? Like create a side block for a player list.
- Reply
- #152
KramerC May 12, 2012 at 16:34 UTC - 0 likes
@minejames1: Go

@MStef94: Go

Although Minequery typically doesn't need an update for every new CraftBukkit or Minecraft version out there, there isn't anymore updates planned as Minecraft now has their own query protocol.
- Reply
- #151
MStef94 May 12, 2012 at 11:33 UTC - 0 likes
@minejames1: Go

This is an very important question :)
- Reply
- #150
minejames1 May 10, 2012 at 17:15 UTC - 0 likes
Will this be updated for future Minecraft/Bukkit versions?

If you want to help out, vote for my Minecraft Server. It really does go a long way!
- Reply
- #149
StuckingFoned May 04, 2012 at 04:01 UTC - 0 likes
@KramerC: Go

Ah, thanks.
24/7 Survival & Creative - Ballz of Steel
- Survival & Creative • Infinite and multi-worlds • Nether PvP • No Whitelist •
- 99.5%+ Uptime • Small community • Forums • Online map • Professional Staff •
- IP: play.ballzofsteel.com •
- Reply
- #148
KramerC May 04, 2012 at 02:44 UTC - 0 likes
@StuckingFoned: Go

The plugin description states:
Quote:
In the past, Minecraft did not have a query protocol and as a result Minequery was created to fulfill the need for a query protocol. Today, this plugin has been replaced with the query protocol that now exists in Minecraft.
- Reply
- #147
StuckingFoned May 03, 2012 at 23:47 UTC - 0 likes
Isn't this whole plugin defunct since Bukkit's inbuilt query system or what am I missing?

Edit:
Also I support the suggestion below; a config.

Last edited May 03, 2012 by StuckingFoned
- Reply
- #146
fr33soul May 01, 2012 at 09:25 UTC - 0 likes
@ryvix: Go I personally think this is a horrible idea. Why would you want this?

i didn't know this question could touch sensible hearts to be considered as "horrible"!

it's just an info as the others! maybe it will be, by the clients, a good feedback to know that the server is always uptodate! in some particular occasion like it was 1 to 1.2 mc a great news! nevermind..
- Reply
- #145
asofold May 01, 2012 at 05:36 UTC - 0 likes
@ryvix: Go

As horrible as the player list showing names and postions and health...

for some it is useful, for some it is horrible, some would fork Minequery to erase the feature - which leads me to a feature request:

How about making it confgurable what to send via Minequery?
- Reply
- #144
ryvix Apr 30, 2012 at 10:09 UTC - 0 likes
@fr33soul: Go

I personally think this is a horrible idea. Why would you want this?