JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 38
  • Score
    100M100P100Q42873F
  • License MIT

Universal game server status and player query tool

Package Exports

  • gamestate

Readme

🎮 gamestate — Universal Game Server Status Query Tool

npm version npm downloads node-current license PRs welcome Open Source Love

gamestate is a modern game server querying CLI & API for:

  • Minecraft Java Edition
  • Minecraft Bedrock Edition
  • Counter-Strike 2 (Valve)
  • Multi Theft Auto: San Andreas (MTA:SA)

Works everywhere — even if UDP ports are blocked ✔
Reliable fallbacks for CS2 and MTA:SA ✔
Clean and compact server info ✔


📦 Install

Global CLI:

npm install -g gamestate
npm install gamestate

🖥️ CLI Usage

gamestate <game_type> <ip[:port]>

Examples:

gamestate minecraft mc.hypixel.net
gamestate bedrock play.nethergames.org
gamestate cs2 51.210.246.171:27015
gamestate mta 91.200.42.46:22003

🧩 Node.js API Usage

import { query } from "gamestate";

const status = await query({
  type: "minecraft",
  host: "mc.hypixel.net"
});

console.log(status);

📊 Returned Data Fields by Game Type

Field Minecraft Java Minecraft Bedrock CS2 MTA:SA Notes
name Server name
numplayers Active players
maxplayers ⚠ sometimes Steam API fallback → unknown
version Game version
map Not supported in Minecraft status
ping ✔* *API fallback → "UDP blocked"
gamemode MTA:SA only
players[] list 🔜 🔜 🔜 Future: --players
protocol Source of query
raw Full response data