squadreplay 0.1.0-alpha.1

Library-first Rust parser and CLI for Squad UE5 replay files
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

# squadreplay

[![Crates.io](https://img.shields.io/crates/v/squadreplay)](https://crates.io/crates/squadreplay)
[![docs.rs](https://img.shields.io/docsrs/squadreplay)](https://docs.rs/squadreplay)
[![License: MPL-2.0](https://img.shields.io/crates/l/squadreplay)](LICENSE)

`squadreplay` is a library-first Rust parser and CLI for Squad UE5 replay data.

The library exposes typed bundle APIs for:

- parsing `.replay` files into a `Bundle`
- reading and writing `.sqrj.json` bundles
- reading and writing `.sqrb` bundles
- deriving compatibility JSON from a parsed bundle

## Library

Add as a dependency (without the CLI):

```toml
[dependencies]
squadreplay = { version = "0.1.0-alpha.1", default-features = false }
```

```rust,no_run
use squadreplay::{parse_file, ParseOptions};

fn main() -> Result<(), squadreplay::Error> {
    let bundle = parse_file("match.replay", &ParseOptions::default())?;
    println!("players: {}", bundle.players.len());
    Ok(())
}
```

## CLI

Install the binary:

```bash
cargo install squadreplay
```

```bash
squadreplay parse match.replay --format sqrj,sqrb --output out/match
squadreplay inspect match.replay
squadreplay show out/match.sqrb
squadreplay unpack out/match.sqrb --output out/unpacked
```

## Feature Flags

| Feature | Default | Description |
|---------|---------|-------------|
| `cli`   | yes     | Builds the `squadreplay` binary (pulls in `clap`) |

Library-only consumers should disable default features to avoid the `clap` dependency.

## Minimum Supported Rust Version

Rust **1.85** (edition 2024).