Struct Action 

pub struct Action {
    pub name: String,
    pub cost: f32,
    pub preconditions: Preconditions,
    pub effects: ActionEffects,
    pub duration_secs: f32,
    pub interrupt_priority: u32,
    pub disabled: bool,
    pub tags: Vec<String>,
}

A GOAP action that an agent can execute.

Each action has:

• A cost (lower = preferred by the planner).
• A set of preconditions that must hold before it can run.
• A set of effects that it applies to the world state.
• An optional duration in simulated seconds.
• An optional interruption priority (higher = harder to interrupt).

Fields

name: String

Unique name identifying this action.

cost: f32

Base cost (used by A* to prefer cheaper plans).

preconditions: Preconditions

Preconditions that must hold.

effects: ActionEffects

Effects applied to world state on completion.

duration_secs: f32

Estimated duration in seconds (used by the executor).

interrupt_priority: u32

Priority when being interrupted by a higher-priority action.

disabled: bool

If true, the planner will not use this action (temporarily disabled).

tags: Vec<String>

User data tag for categorizing actions.

Implementations

impl Action

pub fn new(name: &str, cost: f32) -> Self

pub fn require_bool(self, key: &str, value: bool) -> Self

pub fn require_float_gte(self, key: &str, min: f32) -> Self

pub fn require_float_lte(self, key: &str, max: f32) -> Self

pub fn require_float_gt(self, key: &str, val: f32) -> Self

pub fn require_float_lt(self, key: &str, val: f32) -> Self

pub fn effect_bool(self, key: &str, value: bool) -> Self

pub fn effect_add_float(self, key: &str, delta: f32) -> Self

pub fn effect_set_float(self, key: &str, value: f32) -> Self

pub fn with_duration(self, secs: f32) -> Self

pub fn with_interrupt_priority(self, p: u32) -> Self

pub fn with_tag(self, tag: &str) -> Self

pub fn disabled(self) -> Self

pub fn is_applicable(&self, state: &WorldState) -> bool

pub fn apply_effects(&self, state: &WorldState) -> WorldState

Compute the successor state by applying this action’s effects.

Trait Implementations

impl Clone for Action

fn clone(&self) -> Action

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Action

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.