Enum EngineHint 

pub enum EngineHint {
    Cap {
        agent: AgentId,
        max_ms: f32,
    },
    Prioritize {
        agent: AgentId,
        weight: f32,
    },
}

A developer/editor hint that biases GORNA arbitration without changing game semantics — the “adapt the HOW, not the WHAT” control surface, on the same axis as [AdaptationMode]. Hints are advisory: a death-spiral safety stop and a Manual pin both still win over them. Sent to the DCC over the hint channel; the DCC folds them per agent (see AgentHints) and feeds the accumulated state into each arbitration round.

Variants

Cap

Cap an agent’s per-frame time budget: GORNA will not issue a strategy whose estimated cost exceeds max_ms, clamping toward cheaper strategies. Re-send with a large max_ms to lift a previous cap.

Fields

agent: AgentId

The agent to cap.

max_ms: f32

Maximum per-frame strategy cost, in milliseconds.

Prioritize

Bias an agent’s negotiation priority weight (higher = more budget share when the fit upgrades agents). Overrides the default per-agent priority.

Fields

agent: AgentId

The agent to reprioritize.

weight: f32

Priority weight (typically 0.0–1.0; higher wins budget first).

Implementations

impl EngineHint

pub fn agent(&self) -> AgentId

The agent this hint targets.

Trait Implementations

impl Clone for EngineHint

fn clone(&self) -> EngineHint

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EngineHint

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

Formats the value using the given formatter.

impl PartialEq for EngineHint

fn eq(&self, other: &EngineHint) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for EngineHint

impl StructuralPartialEq for EngineHint