Stats File Formats (AMX Mod X)

From AlliedModders Wiki
Jump to: navigation, search

AMX Mod X has statistics modules for Counter-Strike (CSX), Day of Defeat (DoDX), Team Fortress Classic (TFCX), and The Specialists (TSX).

They each have their own similar but separate binary file format. These file formats must be sequentially read and written, and are not organized into tables. This makes them a bit confusing to extract iteratively, however the format is still trivial.

Each stats file has a header, which contains the version. After the header, each stats entry is written sequentially. Each stats entry contains strings, and the strings are prefixed with the number of bytes to read. Once this number contains zero, the stats file has no more data, and thus iteration must be stopped.

The file formats in this document are displayed as lists. When the list has an indented section, it means that that section of the file is repeated until a condition. Explanations of the data types are below. Sample code is provided for CSX.

How to Interpret

  • int8/uint8 - Signed or Unsigned Byte (8 bits). C types: char, unsigned char
  • int16/uint16 - Signed or Unsigned Word (16 bits). C types: short, unsigned short
  • int32/uint16 - Signed or Unsigned Doubleword (32 bits). C types: int, unsigned int
  • sz - Zero-terminated C-style string

If a size is followed by [N], for example, int8[9], this would mean 9 blocks of int8 data must be read.

CSX (csstats.dat)

The CSSTATS format has RANK_VERSION of 11. The version numbers are considered isolated rather than backwards or forward compatible.

  • int16 - RANK_VERSION
  • uint16 - Bytes in first string (if 0, no entries)
    • sz - Name (read N bytes, where N is previous uint16)
    • uint16 - Bytes of next string
    • sz - Steam ID (read N bytes, where N is previous uint16)
    • uint32 - Team kills
    • uint32 - Damage
    • uint32 - Deaths
    • int32 - Kills
    • uint32 - Shots
    • uint32 - Hits
    • uint32 - Headshots
    • uint32 - Defusions
    • uint32 - Defusal Attempts
    • uint32 - Plants
    • uint32 - Explosions
    • uint32[9] - Body Hits (array of ints, one for each body hit area)
    • uint16 - If zero, end of file. Otherwise, loop back up and read the next name for this many bytes.

Sample Code for Reading/Writing


This example reads in a CSX stats file. Once read, it then demonstrates displaying the contents. You can optionally specify a new file to output the contents to. Insert code in between to change the result set.

my $infile = shift;
my $outfile = shift;
my @players;
my $buffer;
my $RANK_VERSION = 11;
die("Usage: ./ <infile> [outfile]\n") unless $infile ne "";
open(INFILE, $infile) or die "File $infile could not be opened.\n";
if (!read(INFILE, $buffer, 2))
	die "File $infile looks like an invalid file.\n";
my $vers = unpack("s1", $buffer);
if ($vers != $RANK_VERSION)
	print "File $infile does not have the correct header version ($RANK_VERSION)\n";
	die("Detected version: $vers\n");
if (!read(INFILE, $buffer, 2))
	die "File $infile looks malformed.\n";
my $bytes = unpack("S1", $buffer);
my $num = 0;
my $str = "";
my @stats;
while ($bytes)
	read(INFILE, $buffer, $bytes);
	$players[$num]->{name} = unpack("Z*", $buffer);
	read(INFILE, $buffer, 2);
	$bytes = unpack("S1", $buffer);
	read(INFILE, $buffer, $bytes);
	$players[$num]->{auth} = unpack("Z*", $buffer);
	read(INFILE, $buffer, 11 * 4);
	@stats = unpack("L11", $buffer);
	$players[$num]->{tks} = $stats[0];
	$players[$num]->{damage} = $stats[1];
	$players[$num]->{deaths} = $stats[2];
	$players[$num]->{kills} = $stats[3];
	$players[$num]->{shots} = $stats[4];
	$players[$num]->{hits} = $stats[5];
	$players[$num]->{hs} = $stats[6];
	$players[$num]->{defuses} = $stats[7];
	$players[$num]->{defuse_attempts} = $stats[8];
	$players[$num]->{plants} = $stats[9];
	$players[$num]->{explosions} = $stats[10];
	read(INFILE, $buffer, 9*4);
	@{$players[$num]->{hits}} = unpack("L9", $buffer);
	read(INFILE, $buffer, 2);
	$bytes = unpack("S1", $buffer);
for ($i=0; $i<=$#players; $i++)
	my %player = %{$players[$i]};
	my @stats = @{$player{hits}};
	print $player{name} . ", " . $player{auth} . ", ";
	print $player{kills} . ", " . $player{deaths} . ", " . $player{shots} . "\n";
	for ($j=0; $j<9; $j++)
		print "Hit group $j: " . $stats[$j] . "\n";
if ($outfile ne "")
	open (OUTFILE, ">$outfile") or die("Could not open output file: $outfile\n");
	syswrite(OUTFILE, pack("s1", $RANK_VERSION));
	my %player;
	my @stats;
	for ($i=0; $i<=$#players; $i++)
		%player = %{$players[$i]};
		@stats = @{$player{hits}};
		syswrite(OUTFILE, pack("S1", (length($player{name})+1) ));
		syswrite(OUTFILE, pack("Z*", $player{name}));
		syswrite(OUTFILE, pack("S1", (length($player{auth})+1) ));
		syswrite(OUTFILE, pack("Z*", $player{auth}));
		syswrite(OUTFILE, pack("L11",
		for ($j=0; $j<9; $j++)
			syswrite(OUTFILE, pack("L1", $stats[$j]));
	syswrite(OUTFILE, pack("S1", 0));


The StatsFile.ReadEntriesToList member function below is part of a quick C# class. Note that it uses an ArrayList rather than an Array, since the number of items is not known beforehand.

using System;
using System.Collections;
using System.IO;
using System.Text;
public class StatsFile
	public const short RANK_VERSION = 11;
	public class StatsEntry
		public StatsEntry()
			bodyHits = new uint[9];
		public String name;
		public String unique;
		public uint tks;
		public uint damage;
		public uint deaths;
		public int kills;
		public uint shots;
		public uint hits;
		public uint hs;
		public uint bDefusions;
		public uint bDefused;
		public uint bPlants;
		public uint bExplosions;
		public uint [] bodyHits;
	public static ArrayList ReadEntriesToList(string file)
		if (!File.Exists(file))
			throw new FileNotFoundException();
		System.IO.FileStream stream = File.Open(file, System.IO.FileMode.Open);
		if (stream == null)
			throw new FileLoadException();
		BinaryReader br = new BinaryReader(stream);
		ArrayList list;
			short vers = br.ReadInt16();
			if (vers != RANK_VERSION)
				throw new Exception("Bad stats version");
			ushort num = br.ReadUInt16();
			list = new ArrayList();
			while (num != 0)
				StatsEntry entry = new StatsEntry();
				byte [] name = br.ReadBytes(num);
				num = br.ReadUInt16();
				byte [] unique = br.ReadBytes(num); = Encoding.ASCII.GetString(name, 0, name.Length-1);
				entry.unique = Encoding.ASCII.GetString(unique, 0, unique.Length-1);
				entry.tks = br.ReadUInt32();
				entry.damage = br.ReadUInt32();
				entry.deaths = br.ReadUInt32();
				entry.kills = br.ReadInt32();
				entry.shots = br.ReadUInt32();
				entry.hits = br.ReadUInt32();
				entry.hs = br.ReadUInt32();
				entry.bDefusions = br.ReadUInt32();
				entry.bDefused = br.ReadUInt32();
				entry.bPlants = br.ReadUInt32();
				entry.bExplosions = br.ReadUInt32();
				for (int i=0; i<entry.bodyHits.Length; i++)
					entry.bodyHits[i] = br.ReadUInt32();
				num = br.ReadUInt16();
			throw new FileLoadException("Error reading file");
			if (br != null)
				br = null;
			if (stream != null)
				stream = null;
		return list;