mineping/README.md

1.0 KiB

mineping

Collect information about Minecraft (both Java and Bedrock) using Node.js.

Description

mineping is a Javasript library thar provides Minecraft server ping protocol implementation. It can be used to collect information about the server, such as MODT, current online, server icon (java edition only) and etc.

Requirements

Node.js 14 or newer is required

Example

Ping a Java server with default options:

import { pingJava } from 'mineping'

const data = await pingJava('mc.hypixel.net');
console.log(data);

Ping a Bedrock server with custom options:

import { pingBedrock } from 'mineping'

const data = await pingBedrock('mco.mineplex.com', {
    port: 19132,
    timeout: 500
})

More complex example can be found in the examples folder!

Acknowledgements

  • mcping crate for Rust
  • mcping-js library for quering Minecraft Java Edition servers