npc-engine-core 0.1.0

The core of the NPC engine, providing a generic MCTS framework.
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

/*
 *  SPDX-License-Identifier: Apache-2.0 OR MIT
 *  © 2020-2022 ETH Zurich and other contributors, see AUTHORS.txt for details
 */

use npc_engine_core::{
    impl_task_boxed_methods, AgentId, StateDiffRef, StateDiffRefMut, Task, TaskDuration,
};
use npc_engine_utils::OptionDiffDomain;

use crate::{
    constants::{RESPAWN_AMMO_DURATION, RESPAWN_MEDKIT_DURATION},
    domain::{CaptureDomain, DisplayAction},
    state::CapturePointState,
};

#[derive(Clone, Hash, PartialEq, Eq, Debug)]
pub struct WorldStep;

impl Task<CaptureDomain> for WorldStep {
    fn duration(
        &self,
        _tick: u64,
        _state_diff: StateDiffRef<CaptureDomain>,
        _agent: AgentId,
    ) -> TaskDuration {
        1
    }

    fn execute(
        &self,
        tick: u64,
        state_diff: StateDiffRefMut<CaptureDomain>,
        _agent: AgentId,
    ) -> Option<Box<dyn Task<CaptureDomain>>> {
        let diff = CaptureDomain::get_cur_state_mut(state_diff);
        // for each captured point, increment the score of the corresponding agent
        for capture_point in &diff.capture_points {
            if let CapturePointState::Captured(agent) = capture_point {
                if let Some(agent_state) = diff.agents.get_mut(agent) {
                    agent_state.acc_capture += 1;
                }
            }
        }
        // respawn if timeout
        let now = (tick & 0xff) as u8;
        if respawn_timeout_ammo(now, diff.ammo_tick) {
            diff.ammo = 1;
            diff.ammo_tick = now;
        }
        if respawn_timeout_medkit(now, diff.medkit_tick) {
            diff.medkit = 1;
            diff.medkit_tick = now;
        }

        Some(Box::new(WorldStep))
    }

    fn display_action(&self) -> DisplayAction {
        DisplayAction::WorldStep
    }

    fn is_valid(
        &self,
        _tick: u64,
        _state_diff: StateDiffRef<CaptureDomain>,
        _agent: AgentId,
    ) -> bool {
        true
    }

    impl_task_boxed_methods!(CaptureDomain);
}

fn respawn_timeout_ammo(now: u8, before: u8) -> bool {
    now.wrapping_sub(before) > RESPAWN_AMMO_DURATION
}
fn respawn_timeout_medkit(now: u8, before: u8) -> bool {
    now.wrapping_sub(before) > RESPAWN_MEDKIT_DURATION
}