Skip to main content

Crate perturbator_hunt_ai

Crate perturbator_hunt_ai 

Source
Expand description

Pure, deterministic building blocks for an intelligent hunt loop.

The crate knows about semantic zones, evidence, player habits, route facts, and fairness constraints. It deliberately knows nothing about transforms, navmeshes, audio playback, ECS entities, or a pacing-director type. A host translates those engine concerns at the boundary. This makes it a natural fit for 3D and isometric games without excluding 2D: the host represents its own space through semantic zone, route, and anchor IDs.

Structs§

AcousticEvent
A normalized sound already mapped by the host to a semantic zone.
ActiveEvidence
Evidence paired with its decayed effective confidence.
AdaptivePlayerProfile
Decaying statistical profile of how this player approaches the hunt.
AnchorId
Stable host-assigned identifier for a route entry anchor.
BeliefConfig
Weights used to infer a normalized probability distribution over zones.
BeliefMap
Immutable normalized belief distribution inferred for one model time.
CandidateEvaluation
Full audit record for one candidate, including hard rejections.
Evidence
A clue with normalized confidence and a semantic observation time.
FairnessContext
Session facts shared by all candidate fairness checks.
FairnessGate
Validated, reusable hard fairness filter.
FairnessReport
Result of applying every hard rule to one candidate.
FairnessRules
Hard constraints that prevent apparently omniscient or oppressive routing.
HuntBrain
Stateful, engine-neutral facade for an evidence-driven hunter.
HuntBrainConfig
Configuration for the stateful HuntBrain facade.
HuntBrainSnapshot
Versioned persistence value for HuntBrain.
HuntMemory
Bounded evidence memory with deterministic half-life decay.
HuntPacing
Neutral pacing inputs supplied by the host.
HuntPlan
Belief and fully explainable route output for one decision point.
HuntPlanRequest
Inputs for one meaningful route decision.
MemoryConfig
Per-class half-lives and capacity for hunter memory.
PlayerBehaviorEvent
Timed player behavior with normalized intensity.
PlayerProfileConfig
Learning and forgetting controls for the adaptive player profile.
PlayerTendencies
Normalized, slowly changing behavioral tendencies.
RouteCandidate
Host-provided facts for one possible semantic route.
RouteContext
Immutable inputs shared by one route decision.
RouteDecision
Chosen semantic route and the exact terms that made it win.
RouteId
Stable host-assigned identifier for an authored route.
RouteSelection
Explainable output. decision is None when every route is rejected.
RouteTags
Compact semantic tags authored on a route.
ScoreContribution
One additive term in a candidate’s final score.
WeightedRoutePolicy
Default deterministic policy: hard fairness gate followed by additive score.
WeightedRoutePolicyConfig
Additive scoring weights for WeightedRoutePolicy.
ZoneBelief
Probability assigned to one semantic zone.
ZoneId
Stable host-assigned identifier for a semantic world zone.

Enums§

AcousticKind
Semantic category of a sound. The host remains responsible for propagation.
AcousticSource
Best available attribution for an acoustic event.
ArrivalMode
Whether movement is continuous or represents an off-screen re-entry.
EvidenceClass
Decay class used by crate::MemoryConfig.
EvidenceKind
One clue available to the hunter’s imperfect world model.
FairnessViolation
One explicit reason why a route was rejected before scoring.
HuntError
Fail-closed validation error produced by the pure hunt core.
PlayerBehaviorKind
A semantic observation used to learn player habits without machine learning.
RouteAvailability
Whether a route can currently be traversed according to the host navigator.
ScoreFactor
Named contribution retained for designer-facing diagnostics.

Constants§

HUNT_BRAIN_SNAPSHOT_VERSION
Current schema version for HuntBrainSnapshot.

Traits§

RoutePolicy
Policy boundary for selecting a semantic route from host-provided facts.

Type Aliases§

HuntResult
Result alias used by fallible hunt-model operations.