81 lines
2.1 KiB
TypeScript
81 lines
2.1 KiB
TypeScript
/**
|
|
* @param port The server port.
|
|
* @param timeout The read/write socket timeout.
|
|
* @param protocolVersion The protocol version.
|
|
*/
|
|
export type JavaPingOptions = {
|
|
port?: number | undefined,
|
|
timeout?: number | undefined,
|
|
protocolVersion?: number | undefined;
|
|
};
|
|
|
|
/**
|
|
* JSON format chat component used for description field.
|
|
* @see https://wiki.vg/Chat
|
|
*/
|
|
export type ChatComponent = {
|
|
text: string;
|
|
bold?: boolean;
|
|
italic?: boolean;
|
|
underlined?: boolean;
|
|
strikethrough?: boolean;
|
|
obfuscated?: boolean;
|
|
color?: string;
|
|
extra?: ChatComponent[];
|
|
};
|
|
|
|
export type SampleProp = {
|
|
name: string,
|
|
id: string;
|
|
};
|
|
|
|
/**
|
|
* `JSON Response` field of Response packet.
|
|
* @see https://wiki.vg/Server_List_Ping#Response
|
|
*/
|
|
export type JavaPingResponse = {
|
|
version: {
|
|
name: string;
|
|
protocol: number;
|
|
};
|
|
players: {
|
|
max: number;
|
|
online: number;
|
|
sample?: SampleProp[];
|
|
};
|
|
description: string | ChatComponent;
|
|
favicon?: string;
|
|
enforcesSecureChat?: boolean;
|
|
previewsChat?: boolean;
|
|
};
|
|
|
|
/**
|
|
* Asynchronously ping Minecraft Java server.
|
|
*
|
|
* The optional `options` argument can be an object with a `ping` (default is `25565`) or/and `timeout` (default is `5000`) property.
|
|
*
|
|
* @param host The Java server address.
|
|
* @param options The configuration for pinging Minecraft Java server.
|
|
*
|
|
* ```js
|
|
* import { pingJava } from '@minescope/mineping';
|
|
*
|
|
* const data = await pingJava('mc.hypixel.net');
|
|
* console.log(data);
|
|
* ```
|
|
*
|
|
* The resulting output will resemble:
|
|
* ```console
|
|
* {
|
|
* version: { name: 'Requires MC 1.8 / 1.18', protocol: 47 },
|
|
* players: { max: 200000, online: 67336, sample: [] },
|
|
* description: ' §f☃ §aHypixel Network §eTRIPLE COINS & EXP §f☃\n' +
|
|
* ' §6✰ §f§lHOLIDAY SALE §c§lUP TO 85% OFF §6✰',
|
|
* favicon: 'data:image/png;base64,iVBORw0KGg...
|
|
}
|
|
* ```
|
|
* @see [source](https://github.com/minescope/mineping/blob/915edbec9c9ad811459458600af3531ec0836911/lib/java.js#L117)
|
|
*/
|
|
export function pingJava(host: string, options?: JavaPingOptions): Promise<JavaPingResponse>;
|
|
|