Find a file
2013-07-10 06:07:13 -05:00
protocols Don't clobber options, and allow callback as a seperate param 2013-07-10 05:59:10 -05:00
Class.js initial commit 2013-07-10 05:02:48 -05:00
index.js Fix udp responses 2013-07-10 06:07:13 -05:00
LICENSE initial commit 2013-07-10 05:02:48 -05:00
package.json change case 2013-07-10 05:28:24 -05:00
reader.js initial commit 2013-07-10 05:02:48 -05:00
README.md Fix readme tabs 2013-07-10 05:44:18 -05:00

node-GameDig - Game Server Query Library

Usage

var Gamedig = require('gamedig');
Gamedig.query({
	type: 'minecraft',
	host: 'mc.example.com',
	callback: function(state) {
		if(state.error) console.log("Server is offline");
		else console.log(state);
	}
});

State Object

The callback function is "guaranteed" to be called exactly once, indicating either a query error or timeout (in the state's error key), or with a state object containg the successful results.

The returned state object may contain some or all of the following keys, depending on what is available from the queried server:

  • error
  • numplayers
  • maxplayers
  • players
    • name
    • ping
    • score
  • map
  • gametype
  • name

Supported Games

  • Armagetron
  • Gamespy 3 Protocol
    • Minecraft
  • Unreal 2 Protocol
    • Killing Floor
  • Quake 2
  • Quake 3
  • Source Engine
    • Counter-Strike: Source
    • Counter-Strike: Global Offensive
    • Team Fortress 2
      • others
  • GoldSrc Engine
    • Half Life: Death Match
    • Ricochet
    • Counter-Strike: 1.6
      • others

Unstable API

The contents of the returned state object may change slightly from build to build, as the API is still being formed.