New official qstat repository
C HTML Other
Latest commit b7bfcba Jan 28, 2017 @stevenh stevenh committed on GitHub Merge pull request #59 from stevenh/tf-updates
Update tf to support v4 protocol
Permalink
Failed to load latest commit information.
info remove obsolete .cvsignore files Nov 25, 2008
template remove obsolete .cvsignore files Nov 25, 2008
tests use query_status_t for functions that are already ported to the new r… Jul 2, 2009
.gitignore Ignore *.o and built binaries Jul 10, 2015
.travis.yml Enable Travis CI Nov 26, 2016
CHANGES.txt Added KSP support Oct 16, 2014
COMPILE.txt Add a simple Makefile.noauto for those who don't want to or can't use… Nov 24, 2004
ChangeLog Added $SCORE for player score Feb 23, 2003
LICENSE.txt Migration to Artistic 2.0 Sep 10, 2008
Makefile.am Extract json support to its own files Nov 27, 2016
Makefile.noauto Extract json support to its own files Nov 27, 2016
README.md Update README.md Nov 15, 2014
a2s.c uncrustify the code Dec 16, 2016
a2s.h Added KSP support Oct 16, 2014
armyops.c uncrustify the code Dec 16, 2016
armyops.h Extract json support to its own files Nov 27, 2016
autogen.sh The following changes where made in order to fix a number key issues … Apr 24, 2008
bfbc2.c uncrustify the code Dec 16, 2016
bfbc2.h uncrustify the code Dec 16, 2016
config.c uncrustify the code Dec 16, 2016
config.h uncrustify the code Dec 16, 2016
configure.ac Only include strndup if needed Feb 9, 2015
contrib.cfg Initial revision Nov 14, 2002
crysis.c uncrustify the code Dec 16, 2016
crysis.h uncrustify the code Dec 16, 2016
cube2.c uncrustify the code Dec 16, 2016
cube2.h uncrustify the code Dec 16, 2016
debug.c uncrustify the code Dec 16, 2016
debug.h uncrustify the code Dec 16, 2016
dirtybomb.c uncrustify the code Dec 16, 2016
dirtybomb.h uncrustify the code Dec 16, 2016
display_json.c Update tf to support v4 protocol Jan 27, 2017
display_json.h uncrustify the code Dec 16, 2016
doom3.c uncrustify the code Dec 16, 2016
doom3.h uncrustify the code Dec 16, 2016
farmsim.c uncrustify the code Dec 16, 2016
farmsim.h uncrustify the code Dec 16, 2016
fl.c uncrustify the code Dec 16, 2016
fl.h Added KSP support Oct 16, 2014
gitmktar use timestamp of last commit instead of current date Feb 4, 2008
gps.c uncrustify the code Dec 16, 2016
gps.h uncrustify the code Dec 16, 2016
gs2.c uncrustify the code Dec 16, 2016
gs2.h uncrustify the code Dec 16, 2016
gs3.c uncrustify the code Dec 16, 2016
gs3.h uncrustify the code Dec 16, 2016
haze.c uncrustify the code Dec 16, 2016
haze.h uncrustify the code Dec 16, 2016
hcache.c uncrustify the code Dec 16, 2016
ksp.c uncrustify the code Dec 16, 2016
ksp.h uncrustify the code Dec 16, 2016
md5.c uncrustify the code Dec 16, 2016
md5.h uncrustify the code Dec 16, 2016
mumble.c uncrustify the code Dec 16, 2016
mumble.h uncrustify the code Dec 16, 2016
ottd.c uncrustify the code Dec 16, 2016
ottd.h Added KSP support Oct 16, 2014
packet_manip.c uncrustify the code Dec 16, 2016
packet_manip.h uncrustify the code Dec 16, 2016
qserver.c uncrustify the code Dec 16, 2016
qserver.h uncrustify the code Dec 16, 2016
qstat.c Merge pull request #59 from stevenh/tf-updates Jan 27, 2017
qstat.cfg Remove Enemy Territory: Legacy Dec 16, 2015
qstat.h Merge pull request #59 from stevenh/tf-updates Jan 27, 2017
qstatdoc.html docu fixes Jul 2, 2009
starmade.c uncrustify the code Dec 16, 2016
starmade.h uncrustify the code Dec 16, 2016
tee.c add teeworlds master query, fix #5 Dec 20, 2016
tee.h add teeworlds master query, fix #5 Dec 20, 2016
template.c uncrustify the code Dec 16, 2016
terraria.c uncrustify the code Dec 16, 2016
terraria.h uncrustify the code Dec 16, 2016
tf.c Update tf to support v4 protocol Jan 27, 2017
tf.h Add Titanfall support Jul 10, 2015
tm.c uncrustify the code Dec 16, 2016
tm.h uncrustify the code Dec 16, 2016
ts2.c uncrustify the code Dec 16, 2016
ts2.h uncrustify the code Dec 16, 2016
ts3.c uncrustify the code Dec 16, 2016
ts3.h uncrustify the code Dec 16, 2016
uncrustify.cfg uncrustify the code Dec 16, 2016
ut2004.c uncrustify the code Dec 16, 2016
ut2004.h Added KSP support Oct 16, 2014
utils.c uncrustify the code Dec 16, 2016
utils.h uncrustify the code Dec 16, 2016
ventrilo.c uncrustify the code Dec 16, 2016
ventrilo.h uncrustify the code Dec 16, 2016
wic.c uncrustify the code Dec 16, 2016
wic.h uncrustify the code Dec 16, 2016
xform.c uncrustify the code Dec 16, 2016
xform.h uncrustify the code Dec 16, 2016

README.md

qstat

QStat is a command-line program that displays information about Internet game servers. The servers are either down, non-responsive, or running a game. For servers running a game, the server name, map name, current number of players, and response time are displayed. Server rules and player information may also be displayed.

Supported Games

Games supported include Quake, QuakeWorld, Hexen II, Quake II, HexenWorld, Unreal, Half-Life, Sin, Shogo, Tribes, Tribes 2, Quake III: Arena, BFRIS, Kingpin, and Heretic II, Unreal Tournament, Soldier of Fortune, Rogue Spear, Redline, Turok II, Blood 2, Descent 3, Drakan, KISS, Nerf Arena Blast, Rally Master, Terminous, Wheel of Time, and Daikatana and many more. Note for Tribes 2: QStat only supports Tribes 2 builds numbered 22075 or higher. Note for Ghost Recon QStat only supports GhostRecon patch 1.2, 1.3, 1.4, Desert Siege, and Island Thunder.

This list is currently outdated, for a full list see the output from qstat itself.

The different server types can be queried simultaneously. If qStat detects that this is being done, the output is keyed by the type of server being displayed. See Display Options.

The game server may be specified as an IP address or a hostname. Servers can be listed on the command-line or, with the use of the -f option, a text file.

Display Options

One line will be displayed for each server queried. The first component of the line will be the server's address as given on the command-line or the file. This can be used as a key to match input addresses to server status. Server rules and player information are displayed under the server info, indented by one tab stop.

qstat supports three additional display modes: raw, templates, and XML. In raw mode, the server information is displayed using simple delimiters and no formatting. This mode is good for programs that parse and reformat QStat's output. The template mode uses text files to layout the server information within existing text. This is ideal for generating web pages. The XML mode outputs server information wrapped in simple XML tags. The raw mode is enabled using the -raw option, template output is enabled using -Ts, and XML output is enabled with -xml.

Game Options

These options select which servers to query and what game type they are running. Servers are specified by IP address (for example: 199.2.18.4) or hostname. Servers can be listed on the command-line or in a file (see option -f.) The game type of a server can be specified with its address, or a default game type can be set for all addresses that don't have a game type.

The following table shows the command-line option and type strings for the supported game types. The type string is used with the -default option and in files with the -f option.

Configuration files

The games supported by qstat can be customized with configuration files. The query parameters of built-in game types can be modified and new games can be defined. For built-in game types, certain parameters can be modified. The parameters are limited to the master server protocol and master server query string.

New game types can be defined as a variation on an existing game type. Most new games use a Quake 3 or Gamespy/Unreal based network engine. These games can already be queried using -q3s or -gps, but they don't have game specific details such as the correct default port, the game name, and the correct "game" or "mod" server rule. And, mostly importantly, they don't get their own game type string (e.g. q3s, rws, t2s). All of these details can be specified in the QStat config file.

qstat comes with a default configuration file called 'qstat.cfg'. If this file is found in the directory where qstat is run, the file will be loaded. Configuration files can also be specified with the QSTAT_CONFIG environment variable and the -cfg command-line option. See Appendix B for a description of the configuration file format.

Migration to Github

I've been the only active maintainer for the old qstat sourceforge repo for a while now. Unfortunately I don't have full admin their and have been unable to contact the original qstat project creator Steve Jankowski for some time, so I've decided to move the project to github.

Hence for all intensive purposes https://github.com/multiplay/qstat is the new official home of the qstat repro.