Package Exports

cs2-log-parser
cs2-log-parser/lib/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (cs2-log-parser) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

cs2-log-parser

A simple 0-dependency library that parses logs from a CS2 server into JavaScript objects, originally based on this fork by BLAST (available here), and the original library made by negezor (available here). These libraries however have not been updated in a while, which is the reason for making this one, which has been cleaned up & updated to the latest CS2 logging formats, with some new log parsers added.

For a list of the logs this library supports look inside the tests directory.

Install

npm i cs2-log-parser

Usage

HTTP

CS2 supports sending logs over HTTP POST requests by giving it an address using logaddress_add_http.
Here is a simple example using tinyhttp and milliparsec on how we can handle these on our server:

import { App } from "@tinyhttp/app";
import { text } from "milliparsec";
import { StatusCodes } from "http-status-codes";
import parse from "cs2-log-parser";

const app = new App();

app.post("/cs2_logs", text(), (req, res) => {

    const logLines = req.body.split("\n");

    for (const logLine of logLines) {

        const event = parse(logLine, { format: "http" });

        if (event === null) {
            continue;
        }

        console.log(event);
        
    }

    res.sendStatus(StatusCodes.OK);

});

app.listen(3000);

Log file

CS2 can write logs to a text file by setting sv_logfile 1, saved in a directory specified by sv_logsdir (defaults to logs inside the game/csgo folder).
Here is a simple example on how we can read these using Node's built-in fs & path modules:

import fs from "fs";
import path from "path";
import parse from "cs2-log-parser";

const logFilePath = path.join(
  "C:",
  "Program Files (x86)",
  "Steam",
  "steamapps",
  "common",
  "Counter-Strike Global Offensive",
  "game",
  "csgo",
  "logs",
  "2025_10_08_214757.log"
);

const logFileData = fs.readFileSync(logFilePath, "utf-8");

const logLines = logFileData.split("\n");

for (const logLine of logLines) {

    // Log file lines begin with "L" & contain whitespace, we clean them up here
    const cleanLogLine = logLine.slice(1).trim();

    const event = parse(cleanLogLine, { format: "file" });

    if (!event) {
        continue;
    }

    console.log(event);
    
}

Note

Some logs require additional ConVars to be set on the server in order to get logged, specifically:

attacked needs mp_logdetail set to either 1 (to log enemy attacks), 2 (to log team attacks) or 3 (to log both).
picked_up needs mp_logdetail_items set to true (or 1).