@hytaleone/query 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 HytaleOne
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,68 @@
+# @hytaleone/query
+
+Query Hytale servers using the UDP query protocol.
+
+## Installation
+
+```bash
+npm install @hytaleone/query
+```
+
+## Usage
+
+```typescript
+import { query } from '@hytaleone/query';
+
+// Basic query
+const info = await query('play.example.com', 5520);
+console.log(`${info.serverName}: ${info.currentPlayers}/${info.maxPlayers}`);
+
+// Full query - includes players and plugins
+const full = await query('play.example.com', 5520, { full: true });
+console.log('Players:', full.players.map(p => p.name).join(', '));
+console.log('Plugins:', full.plugins.map(p => p.id).join(', '));
+```
+
+## API
+
+### query(host, port?, options?)
+
+Query a server for information.
+
+```typescript
+const info = await query('localhost', 5520, {
+  timeout: 5000,
+  full: true
+});
+```
+
+**Options:**
+- `timeout` - Query timeout in milliseconds (default: 5000)
+- `full` - Include players and plugins (default: false)
+
+**Returns `ServerInfo`:**
+- `serverName` - Server display name
+- `motd` - Message of the day
+- `currentPlayers` - Current player count
+- `maxPlayers` - Maximum player capacity
+- `hostPort` - Server port
+- `version` - Server version
+- `protocolVersion` - Protocol version number
+- `protocolHash` - Protocol hash
+
+**With `full: true`, also returns:**
+- `players` - Array of `{ name, uuid }`
+- `plugins` - Array of `{ id, version, enabled }`
+
+## Requirements
+
+- Node.js >= 18
+- Server must have the [HytaleOne Query Plugin](https://github.com/hytaleone/hytale-one-query-plugin) installed
+
+## License
+
+MIT
+
+---
+
+**[hytale.one](https://hytale.one/)** - Discover Hytale Servers

package/dist/index.cjs

@@ -0,0 +1,217 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  query: () => query
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/query.ts
+var import_node_dgram = __toESM(require("dgram"), 1);
+
+// src/protocol.ts
+var REQUEST_MAGIC = Buffer.from("HYQUERY\0", "ascii");
+var RESPONSE_MAGIC = Buffer.from("HYREPLY\0", "ascii");
+var TYPE_BASIC = 0;
+var TYPE_FULL = 1;
+function buildRequest(type) {
+  const buf = Buffer.alloc(REQUEST_MAGIC.length + 1);
+  REQUEST_MAGIC.copy(buf, 0);
+  buf[REQUEST_MAGIC.length] = type;
+  return buf;
+}
+var BufferReader = class {
+  constructor(buf) {
+    this.buf = buf;
+  }
+  offset = 0;
+  readBytes(length) {
+    const slice = this.buf.subarray(this.offset, this.offset + length);
+    this.offset += length;
+    return slice;
+  }
+  readUInt16LE() {
+    const value = this.buf.readUInt16LE(this.offset);
+    this.offset += 2;
+    return value;
+  }
+  readInt32LE() {
+    const value = this.buf.readInt32LE(this.offset);
+    this.offset += 4;
+    return value;
+  }
+  readBigInt64BE() {
+    const value = this.buf.readBigInt64BE(this.offset);
+    this.offset += 8;
+    return value;
+  }
+  readBoolean() {
+    return this.buf[this.offset++] !== 0;
+  }
+  readString() {
+    const length = this.readUInt16LE();
+    const bytes = this.readBytes(length);
+    return bytes.toString("utf8");
+  }
+  readUUID() {
+    const msb = this.readBigInt64BE();
+    const lsb = this.readBigInt64BE();
+    return formatUUID(msb, lsb);
+  }
+  get remaining() {
+    return this.buf.length - this.offset;
+  }
+};
+function formatUUID(msb, lsb) {
+  const toHex = (n) => {
+    if (n < 0n) {
+      n = BigInt.asUintN(64, n);
+    }
+    return n.toString(16).padStart(16, "0");
+  };
+  const hex = toHex(msb) + toHex(lsb);
+  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+function validateResponse(buf) {
+  if (buf.length < RESPONSE_MAGIC.length + 1) {
+    return false;
+  }
+  return buf.subarray(0, RESPONSE_MAGIC.length).equals(RESPONSE_MAGIC);
+}
+function parseBasicResponse(buf) {
+  if (!validateResponse(buf)) {
+    throw new Error("Invalid response: magic mismatch");
+  }
+  const reader = new BufferReader(buf);
+  reader.readBytes(RESPONSE_MAGIC.length);
+  reader.readBytes(1);
+  return {
+    serverName: reader.readString(),
+    motd: reader.readString(),
+    currentPlayers: reader.readInt32LE(),
+    maxPlayers: reader.readInt32LE(),
+    hostPort: reader.readUInt16LE(),
+    version: reader.readString(),
+    protocolVersion: reader.readInt32LE(),
+    protocolHash: reader.readString()
+  };
+}
+function parseFullResponse(buf) {
+  if (!validateResponse(buf)) {
+    throw new Error("Invalid response: magic mismatch");
+  }
+  const reader = new BufferReader(buf);
+  reader.readBytes(RESPONSE_MAGIC.length);
+  reader.readBytes(1);
+  const serverName = reader.readString();
+  const motd = reader.readString();
+  const currentPlayers = reader.readInt32LE();
+  const maxPlayers = reader.readInt32LE();
+  const hostPort = reader.readUInt16LE();
+  const version = reader.readString();
+  const protocolVersion = reader.readInt32LE();
+  const protocolHash = reader.readString();
+  const playerCount = reader.readInt32LE();
+  const players = [];
+  for (let i = 0; i < playerCount; i++) {
+    players.push({
+      name: reader.readString(),
+      uuid: reader.readUUID()
+    });
+  }
+  const pluginCount = reader.readInt32LE();
+  const plugins = [];
+  for (let i = 0; i < pluginCount; i++) {
+    plugins.push({
+      id: reader.readString(),
+      version: reader.readString(),
+      enabled: reader.readBoolean()
+    });
+  }
+  return {
+    serverName,
+    motd,
+    currentPlayers,
+    maxPlayers,
+    hostPort,
+    version,
+    protocolVersion,
+    protocolHash,
+    players,
+    plugins
+  };
+}
+
+// src/query.ts
+var DEFAULT_TIMEOUT = 5e3;
+function sendQuery(host, port, type, timeout) {
+  return new Promise((resolve, reject) => {
+    const socket = import_node_dgram.default.createSocket("udp4");
+    let timeoutHandle;
+    const cleanup = () => {
+      clearTimeout(timeoutHandle);
+      socket.close();
+    };
+    socket.on("message", (msg) => {
+      cleanup();
+      resolve(msg);
+    });
+    socket.on("error", (err) => {
+      cleanup();
+      reject(err);
+    });
+    timeoutHandle = setTimeout(() => {
+      cleanup();
+      reject(new Error(`Query timeout after ${timeout}ms`));
+    }, timeout);
+    const request = buildRequest(type);
+    socket.send(request, port, host, (err) => {
+      if (err) {
+        cleanup();
+        reject(err);
+      }
+    });
+  });
+}
+async function query(host, port = 5520, options = {}) {
+  const timeout = options.timeout ?? DEFAULT_TIMEOUT;
+  const type = options.full ? TYPE_FULL : TYPE_BASIC;
+  const response = await sendQuery(host, port, type, timeout);
+  if (options.full) {
+    return parseFullResponse(response);
+  }
+  return parseBasicResponse(response);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  query
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/query.ts","../src/protocol.ts"],"sourcesContent":["export { query } from './query.js';\nexport type {\n  ServerInfo,\n  ServerInfoFull,\n  Player,\n  Plugin,\n  QueryOptions,\n} from './types.js';\n","import dgram from 'node:dgram';\nimport {\n  buildRequest,\n  parseBasicResponse,\n  parseFullResponse,\n  TYPE_BASIC,\n  TYPE_FULL,\n} from './protocol.js';\nimport type { QueryOptions, ServerInfo, ServerInfoFull } from './types.js';\n\nconst DEFAULT_TIMEOUT = 5000;\n\n/**\n * Send a UDP query and wait for response.\n */\nfunction sendQuery(\n  host: string,\n  port: number,\n  type: number,\n  timeout: number\n): Promise<Buffer> {\n  return new Promise((resolve, reject) => {\n    const socket = dgram.createSocket('udp4');\n    let timeoutHandle: NodeJS.Timeout;\n\n    const cleanup = () => {\n      clearTimeout(timeoutHandle);\n      socket.close();\n    };\n\n    socket.on('message', (msg) => {\n      cleanup();\n      resolve(msg);\n    });\n\n    socket.on('error', (err) => {\n      cleanup();\n      reject(err);\n    });\n\n    timeoutHandle = setTimeout(() => {\n      cleanup();\n      reject(new Error(`Query timeout after ${timeout}ms`));\n    }, timeout);\n\n    const request = buildRequest(type);\n    socket.send(request, port, host, (err) => {\n      if (err) {\n        cleanup();\n        reject(err);\n      }\n    });\n  });\n}\n\n/**\n * Query a Hytale server for information.\n *\n * @param host - Server hostname or IP address\n * @param port - Server port (default: 5520)\n * @param options - Query options\n * @returns Server information (full if options.full is true)\n *\n * @example\n * ```typescript\n * // Basic query\n * const info = await query('play.example.com', 5520);\n * console.log(`${info.serverName}: ${info.currentPlayers}/${info.maxPlayers}`);\n *\n * // Full query (includes players + plugins)\n * const full = await query('play.example.com', 5520, { full: true });\n * console.log('Players:', full.players.map(p => p.name).join(', '));\n * ```\n */\nexport async function query(\n  host: string,\n  port?: number,\n  options?: QueryOptions & { full?: false }\n): Promise<ServerInfo>;\nexport async function query(\n  host: string,\n  port: number,\n  options: QueryOptions & { full: true }\n): Promise<ServerInfoFull>;\nexport async function query(\n  host: string,\n  port = 5520,\n  options: QueryOptions & { full?: boolean } = {}\n): Promise<ServerInfo | ServerInfoFull> {\n  const timeout = options.timeout ?? DEFAULT_TIMEOUT;\n  const type = options.full ? TYPE_FULL : TYPE_BASIC;\n  const response = await sendQuery(host, port, type, timeout);\n\n  if (options.full) {\n    return parseFullResponse(response);\n  }\n  return parseBasicResponse(response);\n}\n","import type { Player, Plugin, ServerInfo, ServerInfoFull } from './types.js';\n\n// Protocol constants\nexport const REQUEST_MAGIC = Buffer.from('HYQUERY\\0', 'ascii');\nexport const RESPONSE_MAGIC = Buffer.from('HYREPLY\\0', 'ascii');\nexport const TYPE_BASIC = 0x00;\nexport const TYPE_FULL = 0x01;\n\n/**\n * Build a query request packet.\n */\nexport function buildRequest(type: number): Buffer {\n  const buf = Buffer.alloc(REQUEST_MAGIC.length + 1);\n  REQUEST_MAGIC.copy(buf, 0);\n  buf[REQUEST_MAGIC.length] = type;\n  return buf;\n}\n\n/**\n * Buffer reader helper for parsing responses.\n */\nclass BufferReader {\n  private offset = 0;\n\n  constructor(private buf: Buffer) {}\n\n  readBytes(length: number): Buffer {\n    const slice = this.buf.subarray(this.offset, this.offset + length);\n    this.offset += length;\n    return slice;\n  }\n\n  readUInt16LE(): number {\n    const value = this.buf.readUInt16LE(this.offset);\n    this.offset += 2;\n    return value;\n  }\n\n  readInt32LE(): number {\n    const value = this.buf.readInt32LE(this.offset);\n    this.offset += 4;\n    return value;\n  }\n\n  readBigInt64BE(): bigint {\n    const value = this.buf.readBigInt64BE(this.offset);\n    this.offset += 8;\n    return value;\n  }\n\n  readBoolean(): boolean {\n    return this.buf[this.offset++] !== 0;\n  }\n\n  readString(): string {\n    const length = this.readUInt16LE();\n    const bytes = this.readBytes(length);\n    return bytes.toString('utf8');\n  }\n\n  readUUID(): string {\n    const msb = this.readBigInt64BE();\n    const lsb = this.readBigInt64BE();\n    return formatUUID(msb, lsb);\n  }\n\n  get remaining(): number {\n    return this.buf.length - this.offset;\n  }\n}\n\n/**\n * Format UUID from most/least significant bits.\n */\nfunction formatUUID(msb: bigint, lsb: bigint): string {\n  const toHex = (n: bigint): string => {\n    if (n < 0n) {\n      n = BigInt.asUintN(64, n);\n    }\n    return n.toString(16).padStart(16, '0');\n  };\n\n  const hex = toHex(msb) + toHex(lsb);\n  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;\n}\n\n/**\n * Validate response magic bytes.\n */\nexport function validateResponse(buf: Buffer): boolean {\n  if (buf.length < RESPONSE_MAGIC.length + 1) {\n    return false;\n  }\n  return buf.subarray(0, RESPONSE_MAGIC.length).equals(RESPONSE_MAGIC);\n}\n\n/**\n * Parse a basic query response.\n */\nexport function parseBasicResponse(buf: Buffer): ServerInfo {\n  if (!validateResponse(buf)) {\n    throw new Error('Invalid response: magic mismatch');\n  }\n\n  const reader = new BufferReader(buf);\n\n  // Skip magic\n  reader.readBytes(RESPONSE_MAGIC.length);\n\n  // Skip type\n  reader.readBytes(1);\n\n  return {\n    serverName: reader.readString(),\n    motd: reader.readString(),\n    currentPlayers: reader.readInt32LE(),\n    maxPlayers: reader.readInt32LE(),\n    hostPort: reader.readUInt16LE(),\n    version: reader.readString(),\n    protocolVersion: reader.readInt32LE(),\n    protocolHash: reader.readString(),\n  };\n}\n\n/**\n * Parse a full query response.\n */\nexport function parseFullResponse(buf: Buffer): ServerInfoFull {\n  if (!validateResponse(buf)) {\n    throw new Error('Invalid response: magic mismatch');\n  }\n\n  const reader = new BufferReader(buf);\n\n  // Skip magic\n  reader.readBytes(RESPONSE_MAGIC.length);\n\n  // Skip type\n  reader.readBytes(1);\n\n  // Base info\n  const serverName = reader.readString();\n  const motd = reader.readString();\n  const currentPlayers = reader.readInt32LE();\n  const maxPlayers = reader.readInt32LE();\n  const hostPort = reader.readUInt16LE();\n  const version = reader.readString();\n  const protocolVersion = reader.readInt32LE();\n  const protocolHash = reader.readString();\n\n  // Player list\n  const playerCount = reader.readInt32LE();\n  const players: Player[] = [];\n  for (let i = 0; i < playerCount; i++) {\n    players.push({\n      name: reader.readString(),\n      uuid: reader.readUUID(),\n    });\n  }\n\n  // Plugin list\n  const pluginCount = reader.readInt32LE();\n  const plugins: Plugin[] = [];\n  for (let i = 0; i < pluginCount; i++) {\n    plugins.push({\n      id: reader.readString(),\n      version: reader.readString(),\n      enabled: reader.readBoolean(),\n    });\n  }\n\n  return {\n    serverName,\n    motd,\n    currentPlayers,\n    maxPlayers,\n    hostPort,\n    version,\n    protocolVersion,\n    protocolHash,\n    players,\n    plugins,\n  };\n}\n"],"mappings":"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","names":["dgram"]}

package/dist/index.d.cts

@@ -0,0 +1,87 @@
+/**
+ * Basic server information returned by a basic query.
+ */
+interface ServerInfo {
+    /** Server display name */
+    serverName: string;
+    /** Message of the day */
+    motd: string;
+    /** Current number of players online */
+    currentPlayers: number;
+    /** Maximum player capacity */
+    maxPlayers: number;
+    /** Server port */
+    hostPort: number;
+    /** Server version string */
+    version: string;
+    /** Protocol version number */
+    protocolVersion: number;
+    /** Protocol hash string */
+    protocolHash: string;
+}
+/**
+ * Player information included in full query response.
+ */
+interface Player {
+    /** Player username */
+    name: string;
+    /** Player UUID in standard format */
+    uuid: string;
+}
+/**
+ * Plugin information included in full query response.
+ */
+interface Plugin {
+    /** Plugin identifier (e.g. "HytaleOne:Query") */
+    id: string;
+    /** Plugin version string */
+    version: string;
+    /** Whether the plugin is enabled */
+    enabled: boolean;
+}
+/**
+ * Full server information including player and plugin lists.
+ */
+interface ServerInfoFull extends ServerInfo {
+    /** List of online players */
+    players: Player[];
+    /** List of installed plugins */
+    plugins: Plugin[];
+}
+/**
+ * Options for query function.
+ */
+interface QueryOptions {
+    /** Timeout in milliseconds (default: 5000) */
+    timeout?: number;
+    /** Request full info including players and plugins (default: false) */
+    full?: boolean;
+}
+
+/**
+ * Query a Hytale server for information.
+ *
+ * @param host - Server hostname or IP address
+ * @param port - Server port (default: 5520)
+ * @param options - Query options
+ * @returns Server information (full if options.full is true)
+ *
+ * @example
+ * ```typescript
+ * // Basic query
+ * const info = await query('play.example.com', 5520);
+ * console.log(`${info.serverName}: ${info.currentPlayers}/${info.maxPlayers}`);
+ *
+ * // Full query (includes players + plugins)
+ * const full = await query('play.example.com', 5520, { full: true });
+ * console.log('Players:', full.players.map(p => p.name).join(', '));
+ * ```
+ */
+declare function query(host: string, port?: number, options?: QueryOptions & {
+    full?: false;
+}): Promise<ServerInfo>;
+declare function query(host: string, port: number, options: QueryOptions & {
+    full: true;
+}): Promise<ServerInfoFull>;
+
+export { type Player, type Plugin, type QueryOptions, type ServerInfo, type ServerInfoFull, query };

package/dist/index.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Basic server information returned by a basic query.
+ */
+interface ServerInfo {
+    /** Server display name */
+    serverName: string;
+    /** Message of the day */
+    motd: string;
+    /** Current number of players online */
+    currentPlayers: number;
+    /** Maximum player capacity */
+    maxPlayers: number;
+    /** Server port */
+    hostPort: number;
+    /** Server version string */
+    version: string;
+    /** Protocol version number */
+    protocolVersion: number;
+    /** Protocol hash string */
+    protocolHash: string;
+}
+/**
+ * Player information included in full query response.
+ */
+interface Player {
+    /** Player username */
+    name: string;
+    /** Player UUID in standard format */
+    uuid: string;
+}
+/**
+ * Plugin information included in full query response.
+ */
+interface Plugin {
+    /** Plugin identifier (e.g. "HytaleOne:Query") */
+    id: string;
+    /** Plugin version string */
+    version: string;
+    /** Whether the plugin is enabled */
+    enabled: boolean;
+}
+/**
+ * Full server information including player and plugin lists.
+ */
+interface ServerInfoFull extends ServerInfo {
+    /** List of online players */
+    players: Player[];
+    /** List of installed plugins */
+    plugins: Plugin[];
+}
+/**
+ * Options for query function.
+ */
+interface QueryOptions {
+    /** Timeout in milliseconds (default: 5000) */
+    timeout?: number;
+    /** Request full info including players and plugins (default: false) */
+    full?: boolean;
+}
+
+/**
+ * Query a Hytale server for information.
+ *
+ * @param host - Server hostname or IP address
+ * @param port - Server port (default: 5520)
+ * @param options - Query options
+ * @returns Server information (full if options.full is true)
+ *
+ * @example
+ * ```typescript
+ * // Basic query
+ * const info = await query('play.example.com', 5520);
+ * console.log(`${info.serverName}: ${info.currentPlayers}/${info.maxPlayers}`);
+ *
+ * // Full query (includes players + plugins)
+ * const full = await query('play.example.com', 5520, { full: true });
+ * console.log('Players:', full.players.map(p => p.name).join(', '));
+ * ```
+ */
+declare function query(host: string, port?: number, options?: QueryOptions & {
+    full?: false;
+}): Promise<ServerInfo>;
+declare function query(host: string, port: number, options: QueryOptions & {
+    full: true;
+}): Promise<ServerInfoFull>;
+
+export { type Player, type Plugin, type QueryOptions, type ServerInfo, type ServerInfoFull, query };

package/dist/index.js

@@ -0,0 +1,180 @@
+// src/query.ts
+import dgram from "dgram";
+
+// src/protocol.ts
+var REQUEST_MAGIC = Buffer.from("HYQUERY\0", "ascii");
+var RESPONSE_MAGIC = Buffer.from("HYREPLY\0", "ascii");
+var TYPE_BASIC = 0;
+var TYPE_FULL = 1;
+function buildRequest(type) {
+  const buf = Buffer.alloc(REQUEST_MAGIC.length + 1);
+  REQUEST_MAGIC.copy(buf, 0);
+  buf[REQUEST_MAGIC.length] = type;
+  return buf;
+}
+var BufferReader = class {
+  constructor(buf) {
+    this.buf = buf;
+  }
+  offset = 0;
+  readBytes(length) {
+    const slice = this.buf.subarray(this.offset, this.offset + length);
+    this.offset += length;
+    return slice;
+  }
+  readUInt16LE() {
+    const value = this.buf.readUInt16LE(this.offset);
+    this.offset += 2;
+    return value;
+  }
+  readInt32LE() {
+    const value = this.buf.readInt32LE(this.offset);
+    this.offset += 4;
+    return value;
+  }
+  readBigInt64BE() {
+    const value = this.buf.readBigInt64BE(this.offset);
+    this.offset += 8;
+    return value;
+  }
+  readBoolean() {
+    return this.buf[this.offset++] !== 0;
+  }
+  readString() {
+    const length = this.readUInt16LE();
+    const bytes = this.readBytes(length);
+    return bytes.toString("utf8");
+  }
+  readUUID() {
+    const msb = this.readBigInt64BE();
+    const lsb = this.readBigInt64BE();
+    return formatUUID(msb, lsb);
+  }
+  get remaining() {
+    return this.buf.length - this.offset;
+  }
+};
+function formatUUID(msb, lsb) {
+  const toHex = (n) => {
+    if (n < 0n) {
+      n = BigInt.asUintN(64, n);
+    }
+    return n.toString(16).padStart(16, "0");
+  };
+  const hex = toHex(msb) + toHex(lsb);
+  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+function validateResponse(buf) {
+  if (buf.length < RESPONSE_MAGIC.length + 1) {
+    return false;
+  }
+  return buf.subarray(0, RESPONSE_MAGIC.length).equals(RESPONSE_MAGIC);
+}
+function parseBasicResponse(buf) {
+  if (!validateResponse(buf)) {
+    throw new Error("Invalid response: magic mismatch");
+  }
+  const reader = new BufferReader(buf);
+  reader.readBytes(RESPONSE_MAGIC.length);
+  reader.readBytes(1);
+  return {
+    serverName: reader.readString(),
+    motd: reader.readString(),
+    currentPlayers: reader.readInt32LE(),
+    maxPlayers: reader.readInt32LE(),
+    hostPort: reader.readUInt16LE(),
+    version: reader.readString(),
+    protocolVersion: reader.readInt32LE(),
+    protocolHash: reader.readString()
+  };
+}
+function parseFullResponse(buf) {
+  if (!validateResponse(buf)) {
+    throw new Error("Invalid response: magic mismatch");
+  }
+  const reader = new BufferReader(buf);
+  reader.readBytes(RESPONSE_MAGIC.length);
+  reader.readBytes(1);
+  const serverName = reader.readString();
+  const motd = reader.readString();
+  const currentPlayers = reader.readInt32LE();
+  const maxPlayers = reader.readInt32LE();
+  const hostPort = reader.readUInt16LE();
+  const version = reader.readString();
+  const protocolVersion = reader.readInt32LE();
+  const protocolHash = reader.readString();
+  const playerCount = reader.readInt32LE();
+  const players = [];
+  for (let i = 0; i < playerCount; i++) {
+    players.push({
+      name: reader.readString(),
+      uuid: reader.readUUID()
+    });
+  }
+  const pluginCount = reader.readInt32LE();
+  const plugins = [];
+  for (let i = 0; i < pluginCount; i++) {
+    plugins.push({
+      id: reader.readString(),
+      version: reader.readString(),
+      enabled: reader.readBoolean()
+    });
+  }
+  return {
+    serverName,
+    motd,
+    currentPlayers,
+    maxPlayers,
+    hostPort,
+    version,
+    protocolVersion,
+    protocolHash,
+    players,
+    plugins
+  };
+}
+
+// src/query.ts
+var DEFAULT_TIMEOUT = 5e3;
+function sendQuery(host, port, type, timeout) {
+  return new Promise((resolve, reject) => {
+    const socket = dgram.createSocket("udp4");
+    let timeoutHandle;
+    const cleanup = () => {
+      clearTimeout(timeoutHandle);
+      socket.close();
+    };
+    socket.on("message", (msg) => {
+      cleanup();
+      resolve(msg);
+    });
+    socket.on("error", (err) => {
+      cleanup();
+      reject(err);
+    });
+    timeoutHandle = setTimeout(() => {
+      cleanup();
+      reject(new Error(`Query timeout after ${timeout}ms`));
+    }, timeout);
+    const request = buildRequest(type);
+    socket.send(request, port, host, (err) => {
+      if (err) {
+        cleanup();
+        reject(err);
+      }
+    });
+  });
+}
+async function query(host, port = 5520, options = {}) {
+  const timeout = options.timeout ?? DEFAULT_TIMEOUT;
+  const type = options.full ? TYPE_FULL : TYPE_BASIC;
+  const response = await sendQuery(host, port, type, timeout);
+  if (options.full) {
+    return parseFullResponse(response);
+  }
+  return parseBasicResponse(response);
+}
+export {
+  query
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/query.ts","../src/protocol.ts"],"sourcesContent":["import dgram from 'node:dgram';\nimport {\n  buildRequest,\n  parseBasicResponse,\n  parseFullResponse,\n  TYPE_BASIC,\n  TYPE_FULL,\n} from './protocol.js';\nimport type { QueryOptions, ServerInfo, ServerInfoFull } from './types.js';\n\nconst DEFAULT_TIMEOUT = 5000;\n\n/**\n * Send a UDP query and wait for response.\n */\nfunction sendQuery(\n  host: string,\n  port: number,\n  type: number,\n  timeout: number\n): Promise<Buffer> {\n  return new Promise((resolve, reject) => {\n    const socket = dgram.createSocket('udp4');\n    let timeoutHandle: NodeJS.Timeout;\n\n    const cleanup = () => {\n      clearTimeout(timeoutHandle);\n      socket.close();\n    };\n\n    socket.on('message', (msg) => {\n      cleanup();\n      resolve(msg);\n    });\n\n    socket.on('error', (err) => {\n      cleanup();\n      reject(err);\n    });\n\n    timeoutHandle = setTimeout(() => {\n      cleanup();\n      reject(new Error(`Query timeout after ${timeout}ms`));\n    }, timeout);\n\n    const request = buildRequest(type);\n    socket.send(request, port, host, (err) => {\n      if (err) {\n        cleanup();\n        reject(err);\n      }\n    });\n  });\n}\n\n/**\n * Query a Hytale server for information.\n *\n * @param host - Server hostname or IP address\n * @param port - Server port (default: 5520)\n * @param options - Query options\n * @returns Server information (full if options.full is true)\n *\n * @example\n * ```typescript\n * // Basic query\n * const info = await query('play.example.com', 5520);\n * console.log(`${info.serverName}: ${info.currentPlayers}/${info.maxPlayers}`);\n *\n * // Full query (includes players + plugins)\n * const full = await query('play.example.com', 5520, { full: true });\n * console.log('Players:', full.players.map(p => p.name).join(', '));\n * ```\n */\nexport async function query(\n  host: string,\n  port?: number,\n  options?: QueryOptions & { full?: false }\n): Promise<ServerInfo>;\nexport async function query(\n  host: string,\n  port: number,\n  options: QueryOptions & { full: true }\n): Promise<ServerInfoFull>;\nexport async function query(\n  host: string,\n  port = 5520,\n  options: QueryOptions & { full?: boolean } = {}\n): Promise<ServerInfo | ServerInfoFull> {\n  const timeout = options.timeout ?? DEFAULT_TIMEOUT;\n  const type = options.full ? TYPE_FULL : TYPE_BASIC;\n  const response = await sendQuery(host, port, type, timeout);\n\n  if (options.full) {\n    return parseFullResponse(response);\n  }\n  return parseBasicResponse(response);\n}\n","import type { Player, Plugin, ServerInfo, ServerInfoFull } from './types.js';\n\n// Protocol constants\nexport const REQUEST_MAGIC = Buffer.from('HYQUERY\\0', 'ascii');\nexport const RESPONSE_MAGIC = Buffer.from('HYREPLY\\0', 'ascii');\nexport const TYPE_BASIC = 0x00;\nexport const TYPE_FULL = 0x01;\n\n/**\n * Build a query request packet.\n */\nexport function buildRequest(type: number): Buffer {\n  const buf = Buffer.alloc(REQUEST_MAGIC.length + 1);\n  REQUEST_MAGIC.copy(buf, 0);\n  buf[REQUEST_MAGIC.length] = type;\n  return buf;\n}\n\n/**\n * Buffer reader helper for parsing responses.\n */\nclass BufferReader {\n  private offset = 0;\n\n  constructor(private buf: Buffer) {}\n\n  readBytes(length: number): Buffer {\n    const slice = this.buf.subarray(this.offset, this.offset + length);\n    this.offset += length;\n    return slice;\n  }\n\n  readUInt16LE(): number {\n    const value = this.buf.readUInt16LE(this.offset);\n    this.offset += 2;\n    return value;\n  }\n\n  readInt32LE(): number {\n    const value = this.buf.readInt32LE(this.offset);\n    this.offset += 4;\n    return value;\n  }\n\n  readBigInt64BE(): bigint {\n    const value = this.buf.readBigInt64BE(this.offset);\n    this.offset += 8;\n    return value;\n  }\n\n  readBoolean(): boolean {\n    return this.buf[this.offset++] !== 0;\n  }\n\n  readString(): string {\n    const length = this.readUInt16LE();\n    const bytes = this.readBytes(length);\n    return bytes.toString('utf8');\n  }\n\n  readUUID(): string {\n    const msb = this.readBigInt64BE();\n    const lsb = this.readBigInt64BE();\n    return formatUUID(msb, lsb);\n  }\n\n  get remaining(): number {\n    return this.buf.length - this.offset;\n  }\n}\n\n/**\n * Format UUID from most/least significant bits.\n */\nfunction formatUUID(msb: bigint, lsb: bigint): string {\n  const toHex = (n: bigint): string => {\n    if (n < 0n) {\n      n = BigInt.asUintN(64, n);\n    }\n    return n.toString(16).padStart(16, '0');\n  };\n\n  const hex = toHex(msb) + toHex(lsb);\n  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;\n}\n\n/**\n * Validate response magic bytes.\n */\nexport function validateResponse(buf: Buffer): boolean {\n  if (buf.length < RESPONSE_MAGIC.length + 1) {\n    return false;\n  }\n  return buf.subarray(0, RESPONSE_MAGIC.length).equals(RESPONSE_MAGIC);\n}\n\n/**\n * Parse a basic query response.\n */\nexport function parseBasicResponse(buf: Buffer): ServerInfo {\n  if (!validateResponse(buf)) {\n    throw new Error('Invalid response: magic mismatch');\n  }\n\n  const reader = new BufferReader(buf);\n\n  // Skip magic\n  reader.readBytes(RESPONSE_MAGIC.length);\n\n  // Skip type\n  reader.readBytes(1);\n\n  return {\n    serverName: reader.readString(),\n    motd: reader.readString(),\n    currentPlayers: reader.readInt32LE(),\n    maxPlayers: reader.readInt32LE(),\n    hostPort: reader.readUInt16LE(),\n    version: reader.readString(),\n    protocolVersion: reader.readInt32LE(),\n    protocolHash: reader.readString(),\n  };\n}\n\n/**\n * Parse a full query response.\n */\nexport function parseFullResponse(buf: Buffer): ServerInfoFull {\n  if (!validateResponse(buf)) {\n    throw new Error('Invalid response: magic mismatch');\n  }\n\n  const reader = new BufferReader(buf);\n\n  // Skip magic\n  reader.readBytes(RESPONSE_MAGIC.length);\n\n  // Skip type\n  reader.readBytes(1);\n\n  // Base info\n  const serverName = reader.readString();\n  const motd = reader.readString();\n  const currentPlayers = reader.readInt32LE();\n  const maxPlayers = reader.readInt32LE();\n  const hostPort = reader.readUInt16LE();\n  const version = reader.readString();\n  const protocolVersion = reader.readInt32LE();\n  const protocolHash = reader.readString();\n\n  // Player list\n  const playerCount = reader.readInt32LE();\n  const players: Player[] = [];\n  for (let i = 0; i < playerCount; i++) {\n    players.push({\n      name: reader.readString(),\n      uuid: reader.readUUID(),\n    });\n  }\n\n  // Plugin list\n  const pluginCount = reader.readInt32LE();\n  const plugins: Plugin[] = [];\n  for (let i = 0; i < pluginCount; i++) {\n    plugins.push({\n      id: reader.readString(),\n      version: reader.readString(),\n      enabled: reader.readBoolean(),\n    });\n  }\n\n  return {\n    serverName,\n    motd,\n    currentPlayers,\n    maxPlayers,\n    hostPort,\n    version,\n    protocolVersion,\n    protocolHash,\n    players,\n    plugins,\n  };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@hytaleone/query",
+  "version": "1.0.0",
+  "description": "Query Hytale servers using the UDP query protocol",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "hytale",
+    "query",
+    "server",
+    "udp",
+    "status",
+    "ping"
+  ],
+  "author": "HytaleOne",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/HytaleOne/query-js"
+  },
+  "homepage": "https://hytale.one",
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  }
+}