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§
- Acoustic
Event - A normalized sound already mapped by the host to a semantic zone.
- Active
Evidence - Evidence paired with its decayed effective confidence.
- Adaptive
Player Profile - Decaying statistical profile of how this player approaches the hunt.
- Anchor
Id - Stable host-assigned identifier for a route entry anchor.
- Belief
Config - Weights used to infer a normalized probability distribution over zones.
- Belief
Map - Immutable normalized belief distribution inferred for one model time.
- Candidate
Evaluation - Full audit record for one candidate, including hard rejections.
- Evidence
- A clue with normalized confidence and a semantic observation time.
- Fairness
Context - Session facts shared by all candidate fairness checks.
- Fairness
Gate - Validated, reusable hard fairness filter.
- Fairness
Report - Result of applying every hard rule to one candidate.
- Fairness
Rules - Hard constraints that prevent apparently omniscient or oppressive routing.
- Hunt
Brain - Stateful, engine-neutral facade for an evidence-driven hunter.
- Hunt
Brain Config - Configuration for the stateful
HuntBrainfacade. - Hunt
Brain Snapshot - Versioned persistence value for
HuntBrain. - Hunt
Memory - Bounded evidence memory with deterministic half-life decay.
- Hunt
Pacing - Neutral pacing inputs supplied by the host.
- Hunt
Plan - Belief and fully explainable route output for one decision point.
- Hunt
Plan Request - Inputs for one meaningful route decision.
- Memory
Config - Per-class half-lives and capacity for hunter memory.
- Player
Behavior Event - Timed player behavior with normalized intensity.
- Player
Profile Config - Learning and forgetting controls for the adaptive player profile.
- Player
Tendencies - Normalized, slowly changing behavioral tendencies.
- Route
Candidate - Host-provided facts for one possible semantic route.
- Route
Context - Immutable inputs shared by one route decision.
- Route
Decision - Chosen semantic route and the exact terms that made it win.
- RouteId
- Stable host-assigned identifier for an authored route.
- Route
Selection - Explainable output.
decisionisNonewhen every route is rejected. - Route
Tags - Compact semantic tags authored on a route.
- Score
Contribution - One additive term in a candidate’s final score.
- Weighted
Route Policy - Default deterministic policy: hard fairness gate followed by additive score.
- Weighted
Route Policy Config - Additive scoring weights for
WeightedRoutePolicy. - Zone
Belief - Probability assigned to one semantic zone.
- ZoneId
- Stable host-assigned identifier for a semantic world zone.
Enums§
- Acoustic
Kind - Semantic category of a sound. The host remains responsible for propagation.
- Acoustic
Source - Best available attribution for an acoustic event.
- Arrival
Mode - Whether movement is continuous or represents an off-screen re-entry.
- Evidence
Class - Decay class used by
crate::MemoryConfig. - Evidence
Kind - One clue available to the hunter’s imperfect world model.
- Fairness
Violation - One explicit reason why a route was rejected before scoring.
- Hunt
Error - Fail-closed validation error produced by the pure hunt core.
- Player
Behavior Kind - A semantic observation used to learn player habits without machine learning.
- Route
Availability - Whether a route can currently be traversed according to the host navigator.
- Score
Factor - Named contribution retained for designer-facing diagnostics.
Constants§
- HUNT_
BRAIN_ SNAPSHOT_ VERSION - Current schema version for
HuntBrainSnapshot.
Traits§
- Route
Policy - Policy boundary for selecting a semantic route from host-provided facts.
Type Aliases§
- Hunt
Result - Result alias used by fallible hunt-model operations.