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
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107

/*
 *  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::{CAPTURE_DURATION, MAP},
    domain::{CaptureDomain, DisplayAction},
    state::CapturePointState,
};

#[derive(Clone, Hash, PartialEq, Eq, Debug)]
pub struct StartCapturing(pub u8);
impl Task<CaptureDomain> for StartCapturing {
    fn duration(
        &self,
        _tick: u64,
        _state_diff: StateDiffRef<CaptureDomain>,
        _agent: AgentId,
    ) -> TaskDuration {
        // StartCapture is instantaneous
        0
    }

    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);
        diff.capture_points[self.0 as usize] = CapturePointState::Capturing(agent);
        Some(Box::new(Capturing(self.0)))
    }

    fn display_action(&self) -> DisplayAction {
        DisplayAction::StartCapturing(MAP.capture_location(self.0))
    }

    fn is_valid(
        &self,
        _tick: u64,
        state_diff: StateDiffRef<CaptureDomain>,
        agent: AgentId,
    ) -> bool {
        let state = CaptureDomain::get_cur_state(state_diff);
        // if the point is already captured, we cannot restart capturing
        if state.capture_points[self.0 as usize] == CapturePointState::Captured(agent) {
            return false;
        }
        let capture_location = MAP.capture_location(self.0);
        state.agents.get(&agent).map_or(false, |agent_state|
				// agent is at the right location and not moving
				agent_state.cur_or_last_location == capture_location &&
				agent_state.next_location.is_none())
    }

    impl_task_boxed_methods!(CaptureDomain);
}

#[derive(Clone, Hash, PartialEq, Eq, Debug)]
pub struct Capturing(u8);
impl Task<CaptureDomain> for Capturing {
    fn duration(
        &self,
        _tick: u64,
        _state_diff: StateDiffRef<CaptureDomain>,
        _agent: AgentId,
    ) -> TaskDuration {
        // Capturing takes some time
        CAPTURE_DURATION
    }

    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);
        diff.capture_points[self.0 as usize] = CapturePointState::Captured(agent);
        None
    }

    fn display_action(&self) -> DisplayAction {
        DisplayAction::Capturing(MAP.capture_location(self.0))
    }

    fn is_valid(
        &self,
        _tick: u64,
        state_diff: StateDiffRef<CaptureDomain>,
        agent: AgentId,
    ) -> bool {
        let state = CaptureDomain::get_cur_state(state_diff);
        state.agents.get(&agent).is_some()
            && state.capture_points[self.0 as usize] == CapturePointState::Capturing(agent)
        // note: no need to check agent location, as this task is always a follow-up of StartCapturing
    }

    impl_task_boxed_methods!(CaptureDomain);
}