Struct HeuristicConfig 

#[non_exhaustive]
pub struct HeuristicConfig {
    pub knock_threshold: u8,
    pub safety_weight: u8,
    pub score_awareness: u8,
}

Tuning knobs for HeuristicBot

Like gin_rummy::Rules, the struct is non-exhaustive: start from HeuristicConfig::default and adjust fields.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

knock_threshold: u8

Knock whenever the residual deadwood is at most min(knock_limit, knock_threshold)

The default of 4 holds out past the first legal knock — banking a small knock every hand loses a game to the gin and undercut bonuses. Raise it toward the knock limit to knock as soon as the rules allow, or lower it to hunt gin. score_awareness bends this threshold by the game score at play time.

safety_weight: u8

Weight of discard safety against the opponent’s revealed cards

Zero ignores the opponent entirely, reproducing the pure greedy player. The default is 1.

score_awareness: u8

How strongly the game score shifts the knock threshold

Points of threshold shift per unit of margin / (game_target − leader_score), where margin is this seat’s game-score lead and leader_score the higher of the two running totals. Ahead the effective threshold rises toward the legal limit (bank the lead by knocking early); behind it falls toward zero (hold out for a gin that swings the deficit). The denominator is the leader’s distance to the winning line, not the full target, so the same lead bends the threshold ever harder as the game nears its end: a modest early-game nudge becomes a knock at any deadwood once the front-runner is a hand from winning. Zero ignores the score, so a round played outside a game is unaffected.

Trait Implementations

impl Clone for HeuristicConfig

fn clone(&self) -> HeuristicConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for HeuristicConfig

impl Debug for HeuristicConfig

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

Formats the value using the given formatter.

impl Default for HeuristicConfig

fn default() -> Self

Returns the “default value” for a type.

impl Eq for HeuristicConfig

impl PartialEq for HeuristicConfig

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for HeuristicConfig