A Node.js implementation of Minecraft's query protocol
npm install minecraft-query
You will first have to configure your server to recieve queries from clients.
To do so, set the enable-query flag to true in your server.properties file and then set the query.port flag as you wish.
The configuration should look like this
...
enable-query=true
query.port=<1-65535>
...
const Query = require("minecraft-query");
const q = new Query({host: 'localhost', port: 9630, timeout: 7500});
q.fullStat()
.then(success => {
console.log(success);
return q.basicStat()
})
.then(success => {
console.log(success);
q.close();
})
import Query from "minecraft-query";
const q = new Query({host: 'localhost', port: 9630, timeout: 7500});
q.fullStat()
.then(success => {
console.log(success);
return q.basicStat()
})
.then(success => {
console.log(success);
q.close();
})
class Query({host, port, timeout})
host: the address of the serverport: the query port of the servertimeout: handshake timeout in ms (default 5000)
It returns a Query instance.
Query#basicStat()
- none
A promise that returns an object that corresponds to the basic stat query type. The object should look like this:
{
motd: 'MOTD here',
gametype: 'SMP',
map: 'world',
online_players: '0',
max_players: '20'
}
Query#close()
- none
It ends the connection
Query#fullStat()
- none
A promise that returns an object that corresponds to the full stat query type. The object should look like this:
{
motd: 'MOTD here',
gametype: 'SMP',
game_id: 'MINECRAFT',
version: '1.14.2',
plugins: 'Paper on 1.14.2-R0.1-SNAPSHOT',
map: 'world',
online_players: '4',
max_players: '20',
port: '9630',
players: ['macca_ferri', 'player1', 'notch', 'jeb']
}