node-gamedig/README.md

node-GameDig - Game Server Query Library
---

Usage
---

```shell
npm install gamedig
```

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

### Input Parameters

* **type**: One of the types from the protocols folder
* **host**
* **port**: (optional) Uses the protocol default if not set
* **login**: (optional) Used only by nadeo protocol
* **password**: (optional) Used only by nadeo protocol
* **notes**: (optional) Passed through to output

###Callback Function

The callback function is "guaranteed" to be called exactly once.

If an error occurs, the returned object will contain an "error" key, indicating the issue.
If the error key exists, it should be assumed that the game server is offline or unreachable.

Otherwise, the returned object is guaranteed to contain the following keys:

**Stable, always present:**

* **name**
* **map**
* **password**: Boolean
* **maxplayers**
* **players**: (array of objects) Each object **may** contain name, ping, score, team, address
* **bots**: Same schema as players
* **notes**: Passed through from the input

**Unstable, not guaranteed:**

* **raw**: Contains all information received from the server
* **query**: Details about the query performed

It can usually be assumed that the number of players online is equal to the length of the players array.
Some servers may return an additional player count number, which may be present in the unstable raw object.

Supported Games
---
* Armagetron
* Gamespy 3 Protocol
 * Minecraft
 * Unreal Tournament 3
* GoldSrc Engine
 * Half Life: Death Match
 * Ricochet
 * Counter-Strike: 1.6
 * \+ others
* Nadeo Protocol
 * Trackmania Forever
 * Trackmania 2
 * Shootmania
* Quake 2 Protocol
 * Quake 2
* Quake 3 Protocol
 * Quake 3 Arena
 * Quake 3 Team Arena
 * Warsow
* Source Engine
 * Counter-Strike: Source
 * Counter-Strike: Global Offensive
 * Team Fortress 2
 * \+ others
* Terraria (tshock)
* Unreal 2 Protocol
 * Killing Floor
 * Unreal Tournament 2004