encounter-rs 0.1.0

Resolution engine for multi-character encounters with pluggable scoring backends
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

//! BackgroundScheme — a long-running plot that accumulates progress over
//! several ticks, then resolves to one consequential beat that triggers
//! escalation.
//!
//! Run with: `cargo run --example background_scheme`

use encounter::resolution::BackgroundScheme;
use encounter::types::Effect;

fn main() {
    let mut scheme = BackgroundScheme::new(
        "alice".into(),
        "bob".into(),
        "spy_ring".into(),
        /* threshold */ 5.0,
    );

    // Three ticks of progress — could be game weeks, story beats, etc.
    // The drama-manager layer (consumer's responsibility) decides when to
    // call advance() and by how much.
    scheme.add_advantage("inside_man".into());
    scheme.advance(2.0);
    scheme.advance(2.0);
    let resolved = scheme.advance(1.5);
    assert!(resolved, "scheme should resolve at threshold");

    let success_effects = vec![Effect::RelationshipDelta {
        axis: "trust".into(),
        from: "alice".into(),
        to: "bob".into(),
        delta: -0.6,
    }];
    let failure_effects = vec![];

    let result = scheme.to_result(success_effects, failure_effects);

    println!("scheme: {} ({})", scheme.scheme_type, scheme.initiator);
    println!("advantages held: {:?}", scheme.advantages);
    println!("final progress: {} / {}", scheme.progress, scheme.threshold);
    println!("beats: {}", result.beats.len());
    println!(
        "  resolution: {} ({})",
        result.beats[0].action,
        if result.beats[0].accepted {
            "succeeded"
        } else {
            "failed"
        }
    );
    println!("escalation requested: {}", result.escalation_requested);
    for req in &result.escalation_requests {
        println!(
            "  → trigger={} fidelity={:?}",
            req.trigger, req.suggested_fidelity
        );
    }
}