Linux Update

.github/workflows/rust.yml

@@ -0,0 +1,39 @@
+name: Rust
+
+on:
+    push:
+        branches: ["linux"]
+    pull_request:
+        branches: ["linux"]
+
+env:
+    CARGO_TERM_COLOR: always
+
+jobs:
+    build:
+        runs-on: ubuntu-latest
+
+        steps:
+            - name: Checkout Code
+              uses: actions/checkout@v4
+
+            - name: Cache Dependencies
+              uses: actions/cache@v4
+              with:
+                  path: |
+                      ~/.cargo/registry
+                      ~/.cargo/git
+                      target
+                  key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+
+            - name: Test
+              run: cargo test
+
+            - name: Build Release
+              run: cargo build --release
+
+            - name: Upload Artifact
+              uses: actions/upload-artifact@v4
+              with:
+                  name: cs2-dumper-linux
+                  path: target/release/cs2-dumper

.gitignore

@@ -1,5 +1,6 @@
 /.idea
 /.vscode
+/.vs
 /target
 Cargo.lock
-/scratch
+cs2-dumper.exe

Cargo.toml

@@ -1,26 +1,26 @@
 [package]
 name = "cs2-dumper"
-version = "0.1.1"
+version = "0.1.3"
 authors = ["a2x"]
-edition = "2021"
+edition = "2024"
 readme = "README.md"
 repository = "https://github.com/a2x/cs2-dumper"
 license = "MIT"
 
 [dependencies]
+anyhow = "1.0"
 clap = { version = "4.5", features = ["derive"] }
 chrono = { version = "0.4", features = ["serde"] }
 heck = "0.5"
 log = "0.4"
 memflow = "0.2"
-memflow-native = { git = "https://github.com/memflow/memflow-native" }
-phf = { version = "0.11", features = ["macros"] }
 serde = { version = "1.0", features = ["derive"] }
 serde_json = "1.0"
+simplelog = "0.12"
+memflow-native = { git = "https://github.com/memflow/memflow-native", version = "0.2.6" }
 skidscan = "2.0"
 skidscan-macros = "0.1"
-simplelog = "0.12"
-thiserror = "1.0"
+thiserror = "1"
 
 [profile.dev]
 opt-level = 1

README.md

@@ -1,32 +1,41 @@
 # cs2-dumper
 
-An external Counter-Strike 2 offset/interface dumper for Linux.
+An external offset/interface dumper for Counter-Strike 2 on Linux. Powered by
+[memflow](https://github.com/memflow/memflow).
 
-**Note:** This branch will likely not be kept up-to-date by myself. Pull requests are welcome!
+For a work-in-progress offline version, check out the [cs2-analyzer](https://github.com/a2x/cs2-analyzer) repository or
+view its included web demo [here](https://a2x.github.io/cs2-analyzer).
 
 ## Getting Started
 
 You can download the latest release from [Releases](https://github.com/a2x/cs2-dumper/releases) or compile it yourself.
-Note that compiling it yourself requires your Rust compiler version to be at least 1.74.0 or newer, and the nightly
-toolchain must be installed.
+Building from source requires Rust 1.85 or newer.
 
 ## Usage
 
-1. Ensure the game process is running (Being in the main menu should suffice).
-2. Run the `cs2-dumper` executable.
+1. Ensure CS2 is running (being in the main menu should suffice).
+2. Run `cs2-dumper` from the directory containing `config.json`.
+
+By default, the program uses the [memflow-native](https://github.com/memflow/memflow-native) Linux OS layer to read
+CS2. Linux signatures and their address operations are configured in `config.json`; those signatures may need updates
+after a game patch. You can select another installed memflow connector with `--connector` and pass connector options
+with `--connector-args`. Some connectors require elevated privileges; follow the connector's documentation.
 
 ### Available Arguments
 
-- `-f, --file-types <file-types>`: The types of files to generate. Default: `cs`, `hpp`,  `json`, `rs`.
+- `-c, --connector <connector>`: The name of the memflow connector to use.
+- `-a, --connector-args <connector-args>`: Additional arguments to pass to the memflow connector.
+- `-f, --file-types <file-types>`: The types of files to generate. Default: `cs`, `hpp`, `json`, `rs`, `zig`.
 - `-i, --indent-size <indent-size>`: The number of spaces to use per indentation level. Default: `4`.
 - `-o, --output <output>`: The output directory to write the generated files to. Default: `output`.
+- `-p, --process-name <process-name>`: The name of the game process. Default: `cs2`.
 - `-v...`: Increase logging verbosity. Can be specified multiple times.
 - `-h, --help`: Print help.
 - `-V, --version`: Print version.
 
 ## Running Tests
 
-To run tests, use the following command: `cargo test -- --nocapture`.
+Run `cargo test` to validate the configured Linux signature patterns.
 
 ## License
 

config.json

@@ -3,7 +3,6 @@
   "signatures": [
     {
       "libclient.so": [
-
         {
           "name": "dwEntityList",
           "pattern": "3B 72 10 75 0E 48 83 3A 00 0F 95 C0 C3",
@@ -39,10 +38,12 @@
         },
         {
           "name": "dwGameRules",
-          "pattern": "48 8B 05 ? ? ? ? 48 89 83 A0 07 00 00",
+          "pattern": "48 C7 43 30 00 00 00 00 48 8B 00 C6 43 38 00 48 89 1D ? ? ? ? 48 89 43 08 48 8D 1D ? ? ? ? 8B 3B E8 ? ? ? ? 84 C0",
           "operations": [
             {
-              "type": "rip"
+              "type": "rip",
+              "offset": 18,
+              "length": 22
             }
           ]
         },
@@ -142,12 +143,12 @@
         },
         {
           "name": "dwCSGOInput",
-          "pattern": "F3 41 0F 7E 06 F3 0F 7E 4D B0 48 8D 05 ? ? ? ? 0F 58 C1",
+          "pattern": "F3 41 0F 7E 06 F3 0F 7E C9 48 8D 05 ? ? ? ? 0F 58 C1",
           "operations": [
             {
               "type": "rip",
-              "offset": 13,
-              "length": 17
+              "offset": 12,
+              "length": 16
             },
             {
               "type": "add",
@@ -157,12 +158,12 @@
         },
         {
           "name": "dwViewAngles",
-          "pattern": "F3 41 0F 7E 06 F3 0F 7E 4D B0 48 8D 05 ? ? ? ? 0F 58 C1",
+          "pattern": "F3 41 0F 7E 06 F3 0F 7E C9 48 8D 05 ? ? ? ? 0F 58 C1",
           "operations": [
             {
               "type": "rip",
-              "offset": 13,
-              "length": 17
+              "offset": 12,
+              "length": 16
             },
             {
               "type": "add",
@@ -198,23 +199,23 @@
       "libengine2.so": [
         {
           "name": "dwBuildNumber",
-          "pattern": "89 15 ? ? ? ? 48 83",
+          "pattern": "55 48 89 E5 41 56 41 55 41 54 44 8B 25 ? ? ? ? 53 45 85 E4 0F 85 ? ? ? ?",
           "operations": [
             {
               "type": "rip",
-              "offset": 2,
-              "length": 6
+              "offset": 13,
+              "length": 17
             }
           ]
         },
         {
           "name": "dwNetworkGameClient",
-          "pattern": "48 8D 15 ? ? ? ? 48 8D 35 ? ? ? ? 48 8D 3D ? ? ? ? E8 3E FA 0F 00",
+          "pattern": "4C 89 25 ? ? ? ? 48 8B 03 48 89 DF 48 8D 35 ? ? ? ? FF 90 50 02 00 00",
           "operations": [
             {
               "type": "rip",
-              "offset": 17,
-              "length": 21
+              "offset": 3,
+              "length": 7
             }
           ]
         },
@@ -388,4 +389,4 @@
       ]
     }
   ]
-}
+}

cs2-dumper.log

@@ -0,0 +1,5 @@
+20:27:44 [INFO] found 1 buttons
+20:28:00 [INFO] found 122 interfaces across 30 modules
+20:28:01 [INFO] found 32 offsets across 5 modules
+20:28:01 [INFO] found 3301 classes and 568 enums across 18 modules
+20:28:01 [INFO] analysis completed in 17.30s

output/buttons.cs

@@ -1,9 +1,9 @@
 // Generated using https://github.com/a2x/cs2-dumper
-// 2026-07-09 21:54:28.505310310 UTC
+// 2026-10-15 20:28:01.381534584 UTC
 
 namespace CS2Dumper {
-    // Module: client.dll
+    // Module: libclient.so
     public static class Buttons {
-        public const nint  = 0xDE284353;
+        public const nint  = 0x6567F8075D484353;
     }
 }

output/buttons.hpp

@@ -1,13 +1,14 @@
 // Generated using https://github.com/a2x/cs2-dumper
-// 2026-07-09 21:54:28.505310310 UTC
+// 2026-10-15 20:28:01.381534584 UTC
 
 #pragma once
 
 #include <cstddef>
+#include <cstdint>
 
 namespace cs2_dumper {
-    // Module: client.dll
+    // Module: libclient.so
     namespace buttons {
-        constexpr std::ptrdiff_t  = 0xDE284353;
+        constexpr std::ptrdiff_t  = 0x6567F8075D484353;
     }
 }

output/buttons.json

@@ -1,5 +1,5 @@
 {
-  "client.dll": {
-    "": 3727180627
+  "libclient.so": {
+    "": 7307081630945395539
   }
 }

output/buttons.rs

@@ -1,11 +1,11 @@
 // Generated using https://github.com/a2x/cs2-dumper
-// 2026-07-09 21:54:28.505310310 UTC
+// 2026-10-15 20:28:01.381534584 UTC
 
 #![allow(non_upper_case_globals, unused)]
 
 pub mod cs2_dumper {
-    // Module: client.dll
+    // Module: libclient.so
     pub mod buttons {
-        pub const : usize = 0xDE284353;
+        pub const : usize = 0x6567F8075D484353;
     }
 }

output/buttons.zig

@@ -0,0 +1,9 @@
+// Generated using https://github.com/a2x/cs2-dumper
+// 2026-10-15 20:28:01.381534584 UTC
+
+pub const cs2_dumper = struct {
+    // Module: libclient.so
+    pub const buttons = struct {
+        pub const @"": usize = 0x6567F8075D484353;
+    };
+};

output/info.json

@@ -1,4 +1,4 @@
 {
-  "build_number": 0,
-  "timestamp": "2026-07-09T21:54:28.505310310+00:00"
+  "build_number": 10924,
+  "timestamp": "2026-10-15T20:28:01.381534584+00:00"
 }