boon-deadlock 0.2.0

Boon is a Deadlock demo / replay file parser
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
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

//! Entity Snapshot — parses to a specific tick and inspects entity state.
//!
//! Usage:
//!   cargo run -p boon-deadlock --example entities -- <demo.dem> [tick]
//!
//! Defaults to tick 1000 if not specified.

use std::path::Path;

fn main() {
    let args: Vec<String> = std::env::args().collect();
    let path = args.get(1).expect("usage: entities <demo.dem> [tick]");
    let target_tick: i32 = args.get(2).and_then(|s| s.parse().ok()).unwrap_or(1000);

    let parser = boon::Parser::from_file(Path::new(path)).expect("failed to open demo");
    let ctx = parser
        .parse_to_tick(target_tick)
        .expect("failed to parse to tick");

    println!(
        "Parsed to tick {}  ({} active entities)",
        ctx.tick,
        ctx.entities.len()
    );
    println!();

    // Find all CCitadelPlayerPawn entities
    let mut pawns: Vec<_> = ctx
        .entities
        .iter()
        .filter(|(_, e)| e.class_name == "CCitadelPlayerPawn")
        .collect();
    pawns.sort_by_key(|(idx, _)| *idx);

    println!("CCitadelPlayerPawn entities: {}", pawns.len());
    println!("{}", "-".repeat(70));

    for (idx, entity) in &pawns {
        let serializer = ctx.serializers.get(&entity.class_name);
        let ser = match serializer {
            Some(s) => s,
            None => continue,
        };

        // Read basic fields using get_by_name
        let health = entity.get_by_name("m_iHealth", ser);
        let max_health = entity.get_by_name("m_iMaxHealth", ser);
        let team = entity.get_by_name("m_iTeamNum", ser);

        // Position via CBodyComponent. Source 2 splits position into a cell
        // index (m_cellX/Y/Z) and an in-cell offset (m_vecOrigin.m_vec{X,Y,Z});
        // combine them with `Entity::world_position` to get Hammer-unit world
        // coordinates.
        let cell_keys = [
            ser.resolve_field_key("CBodyComponent.m_skeletonInstance.m_vecOrigin.m_cellX"),
            ser.resolve_field_key("CBodyComponent.m_skeletonInstance.m_vecOrigin.m_cellY"),
            ser.resolve_field_key("CBodyComponent.m_skeletonInstance.m_vecOrigin.m_cellZ"),
        ];
        let offset_keys = [
            ser.resolve_field_key("CBodyComponent.m_skeletonInstance.m_vecOrigin.m_vecX"),
            ser.resolve_field_key("CBodyComponent.m_skeletonInstance.m_vecOrigin.m_vecY"),
            ser.resolve_field_key("CBodyComponent.m_skeletonInstance.m_vecOrigin.m_vecZ"),
        ];
        let [x, y, z] = entity.world_position(cell_keys, offset_keys);

        println!(
            "  Entity #{:<5} team={:<4} health={}/{}  pos=({:.1}, {:.1}, {:.1})",
            idx,
            team.map_or("-".into(), |v| format!("{:?}", v)),
            health.map_or("-".into(), |v| format!("{:?}", v)),
            max_health.map_or("-".into(), |v| format!("{:?}", v)),
            x,
            y,
            z,
        );

        // Show first ability slot as an example of ability_name() lookup
        let ability_field = entity.get_by_name("m_vecAbilities.0000", ser);
        if let Some(boon::FieldValue::U32(ability_id)) = ability_field {
            let name = boon::ability_name(*ability_id);
            println!("    ability[0]: {} (id={})", name, ability_id);
        }
    }
}