Skip to content

Deep Mechanics & Simulation Math

This page documents the exact deterministic formulas inside BiteModel, WeatherSystem, FishPopulation, LakeModel, BoatSystem, TackleSystem, ForageSystem, and ScoringSystem.


Master Strike Probability Formula

Every valid cast on a navigable water cell runs through BiteModel:

  1. Snag Check runs first. If snagged, the cast ends immediately (no bite roll).
  2. Best Species Selection: Evaluates density * feeding_mood across every species on the lake at the clamped running depth and picks the highest-scoring species.
  3. Strike Roll:
raw_buff_mult = line_vis_mod
              * cat_mod          (lure-weather synergy)
              * color_mod        (water clarity & light affinity)
              * lure_aff         (species lure preference; Live Bait = 0.70x)
              * shade_mod        (canopy / dock shade)
              * season_mod       (seasonal presentation synergy)
              * solar_mod        (dawn / dusk / night & dock lights)
              * forage_mod       (Match the Hatch = 1.22x)
              * live_sonar_mod   (Tier 3 Live Sonar = 1.12x)
              * stealth_mod      (Hydraulic Power Poles <= 8 ft = 1.15x)
              * night_lights_mod (Halogen/UV Night Rig = 1.10x)

eff_buff_mult = apply_strike_multiplier_soft_cap(raw_buff_mult)
strike_prob   = clamp(0.20 * density * mood * dive_fit * speed_fit * eff_buff_mult, 0.02, 0.88)

Dive Depth Fit, Retrieve Speed Fit & Soft Caps

  • Lure Dive Depth Fit (dive_fit): 1.15x when target depth is inside [min_dive_depth_ft, max_dive_depth_ft]. Outside the envelope: clamp(1.0 - distance_ft * 0.06, 0.30, 1.0).
  • Retrieve Speed Fit (speed_fit): clamp(1.0 - |speed - optimal_speed| * 0.18, 0.45, 1.0).
  • Species Lure Affinity (lure_aff): 1.00x if the lure category is in the species' preferred list; 0.90x if not; 0.70x for Live Bait (worm_nightcrawler / LIVE_BAIT), which also applies a 0.80x weight multiplier.
  • Strike Multiplier Soft Cap: Linear up to 1.85x, then 35% marginal gain above 1.85x, hard-capped at 2.25x.
  • Weight Multiplier Soft Cap: Linear up to 1.15x, then 35% marginal gain above 1.15x, hard-capped at 1.25x.
  • Near-Miss Thresholds (on missed strike): >= 22% = Short Strike, >= 12% = Swirl, >= 5% = Follow, < 5% = no reaction.
  • Hookup & Landing Roll: After passing the line-break check, landing probability is clamp((0.78 + rod.hookset_modifier_bonus) * hookset_modifier, 0.10, 0.98).

Weather, Barometric Pressure & Temperature

WeatherSystem updates diurnal temperatures every 1-minute tick and steps the weather front every 15 minutes (pressure clamped to 1005–1028 mb, trend momentum ±0.35 mb, wind clamped to 0–30 mph).

Barometric Pressure & Sky Mood Modifiers

FishPopulation.get_feeding_mood() multiplies temp_mult * light_mult * baro_mult * wind_mult (clamped to [0.05, 1.50]):

Condition Barometric Mood Modifier (baro_mult) Sky Light Multiplier
Falling Pressure (delta_p < -0.25) 1.22x (Prime Pre-Front Bite) —
Stable Pressure 1.00x —
Rising Pressure (delta_p > +0.25) 0.80x (Post-Frontal Lockjaw) —
Cloudy / Drizzle / Rain / Thunderstorm / Snow +0.06 additive to baro_mult Cloudy 0.65, Drizzle 0.58, Snow 0.55, Rain 0.48, Storm 0.35
Sunny + Rising Pressure (Bluebird High) -0.05 additive (0.75x net) Sunny 1.00 (Partly Cloudy 0.86)

Final baro_mult is clamped to [0.65, 1.35]. Precipitation turns to Snow whenever air temp <= 36 °F (or <= 46 °F during Winter).

Wind Effects on Fish, Lures, Forage & Boats

  • Species Wind Mood: Striped Bass gain 1.15x at >= 12 mph wind (1.08x at >= 7 mph). Walleye gain 1.10x at >= 6 mph ("Walleye Chop").
  • Lure-Weather Synergy (cat_mod):
  • Topwater: 1.25x when ambient light <= 0.55 AND wind <= 12 mph; otherwise penalized to 0.72x.
  • Spinnerbait: 1.20x when wind >= 8 mph OR light <= 0.70; otherwise 0.92x.
  • All other categories: flat 1.05x baseline.
  • Pelagic Shad Wind Drift: Shad schools drift round(clamp(wind_mph / 8.0, 0, 3)) cells downwind on weather updates (0–3 cells), snapping to navigable water.
  • Boat Wind Drift: Unanchored, unpowered boats begin drifting once wind hits >= 12.0 mph (drift_progress += (wind_mph - 8.0) * 0.04 per tick, moving 1 cell downwind at 1.0). Prevented by anchoring, Dual Power Poles (<= 8 ft, 0 Ah), or GPS Spot-Lock (0.35 Ah/tick).

Water Temperature & Thermal Comfort

  • Diurnal Cycle: Air temperature swings ±9.0 °F around baseline (peaking mid-afternoon); surface water temperature shifts ±2.2 °F (clamped [-2.5, +2.5] °F).
  • Thermal Mood (temp_mult): Inside a species' [optimal_temp_min_f, optimal_temp_max_f], mood peaks at 1.12x–1.15x near the band midpoint (0.95x at edges). Outside the band, mood drops by -0.045 per °F down to a 0.15x floor.

Water Depth, Terrain, Thermoclines & Hull Draft

Two-Layer Thermocline Model (LakeModel)

Water cools with depth in two distinct layers: 1. Epilimnion (0 to thermocline_depth_ft): Linearly cools by -8.0 °F from surface temperature to the thermocline. 2. Hypolimnion (below thermocline_depth_ft): Cools at -0.5 °F per additional foot, floored at min(45.0 °F, thermocline_temp).

Example: On Lake Clearwater (66 °F surface, 22 ft thermocline), water is 58 °F at 22 ft and 53 °F at 32 ft — right in the strike zone for cold-water Rainbow Trout and Walleye during Summer!

Submerged Channels, Drop-Off Ledges & Depth Fit

  • Drop-Off Ledge Detection (is_drop_off_ledge): A cell counts as a ledge if it has explicit LEDGE cover or a >= 6.0 ft depth difference to any cardinal neighbor. Ledges automatically grant a 1.22x species habitat density multiplier.
  • Preferred Depth Fit: 1.15x inside [preferred_depth_min + seasonal_shift, preferred_depth_max + seasonal_shift]; decays by -0.045 per ft outside (floor 0.25x).

Canopy & Dock Shade (1.25x Midday Bonus)

A water cell is shaded (LakeGrid.is_cell_shaded) if: 1. It has DOCK cover, OR 2. Its depth is <= 10.0 ft AND it is 8-directionally adjacent to dry land with FOREST_TIMBER or BRUSH_BANK biome.

Affected Species Midday (11:00 AM – 3:00 PM) All Other Hours
Largemouth, Smallmouth, Spotted Bass & Black Crappie 1.25x 1.10x
All Other Species 1.00x 1.00x

Boat Hull Draft & Skinny-Water Penalties (BoatSystem)

  • Minimum Passable Depth (min_passable_depth_ft): A boat cannot enter any cell shallower than its draft (1.0 ft for Skiffs, 2.0 ft for Bass Classic 17, 2.8 ft for 19ft/21ft fiberglass/carbon tournament rigs).
  • Shallow / Heavy-Cover Trolling Penalty (shallow_obstacle_tick_penalty): On hulls with a penalty (+1 tick on 17ft, +2 ticks on 19ft/21ft), entering water <= 3.0 ft, LILY_PADS, TIMBER, or ROCK bottom <= 6.0 ft forces the outboard to drop into Trolling Motor mode and adds the tick penalty per obstacle cell. Shallow-draft skiffs (0 penalty) glide through at full speed.
  • Propulsion Fallback: Running out of fuel automatically drops OUTBOARD -> TROLLING. Running out of both fuel and battery triggers Emergency Oars (PADDLE) at 4 ticks (minutes) per tile.

Weeds, Cover, Ambush Bonuses & Snags

Species Habitat Density Multipliers (FishPopulation)

Habitat Factor Match Non-Match Open Water (CoverType.NONE)
Cover Match 1.35x 0.90x 0.45x (if preferred) / 0.40x (otherwise)
Bottom Substrate Match 1.25x 0.78x —
Drop-Off Ledge (>= 6 ft drop) 1.22x 1.00x —

Open water without structure carries a steep 0.40x–0.45x density penalty — always target cover, edges, or ledges unless chasing pelagic schools!

Exact Snag Probability Formula (BiteModel)

snag_chance = clamp(base_snag * (1.0 - clamp(weedless_rating, 0.0, 0.95) * 0.85), 0.0, 0.65)
              * snag_chance_multiplier
Cover Type Base Snag Rate With 0% Weedless With 50% Weedless With 90% Weedless (Flipping Jig / Texas Craw) With 95% Weedless (Hollow Frog)
Timber (TIMBER) 34.0% 34.0% 19.6% 8.0% 6.5%
Brush (BRUSH) 28.0% 28.0% 16.1% 6.6% 5.4%
Lily Pads (LILY_PADS) 25.0% 25.0% 14.4% 5.9% 4.8%
Dock (DOCK) 20.0% 20.0% 11.5% 4.7% 3.9%
Weeds (WEEDS) 18.0% 18.0% 10.4% 4.2% 3.5%
Rock Pile (ROCK_PILE) 12.0% 12.0% 6.9% 2.8% 2.3%
Ledge (LEDGE) 8.0% 8.0% 4.6% 1.9% 1.5%
Open Water (NONE) 0.0% 0.0% 0.0% 0.0% 0.0%

snag_chance_multiplier is reduced by Precision Casting (-8% per rank, up to -40% at Rank 5) and compounded with Snag & Snap Ward (0.85x from the Storm Chaser achievement).


Water Clarity, Lure Colors & Night Fishing

Water Clarity & Lure Color Affinity (color_mod)

Condition Exact Threshold Best Color Family Match Bonus Mismatch Penalty
Clear Water Clarity >= 8.0 ft & Light > 0.35 NATURAL_SHAD (shad, pearl, silver, white, ghost, natural) 1.10x (+10%) CHARTREUSE_FIRE: 0.95x / BLACK_BLUE: 0.92x
Stained Water Clarity 4.0–7.9 ft & Light > 0.35 CHARTREUSE_FIRE (chartreuse, firetiger, yellow, gold) 1.10x (+10%) Neutral (1.00x)
Muddy or Low Light Clarity < 4.0 ft or Light <= 0.35 BLACK_BLUE (black, blue, midnight, dark, junebug) 1.10x (+10%) NATURAL_SHAD: 0.92x

Match the Hatch (forage_mod)

Matching the active prey in the target cell grants 1.22x strike rate and 1.10x catch weight:

Forage Type Where It Spawns Surface Activity Clues Qualifying Lures & Colors (ForageSystem.matches_hatch)
Shad Schools Pelagic water >= 7 ft (denser on ledges & 12–32 ft), drifts 0–3 cells downwind. Boils at Dawn/Dusk, or when density >= 0.75 in <= 20 ft. Any Crankbait or Spinnerbait, any swimbait / jerkbait / spoon / shad ID, NATURAL_SHAD profile, or shad / silver / chrome / white finish.
Crawfish Beds Static benthic colonies on ROCK / GRAVEL, LEDGE, or CLIFF_BLUFF borders (3–26 ft). Never shows surface activity (use sonar / bottom readings). Any Jig or Live Bait, any craw / ned_rig / football / texas / worm / finesse ID, or craw / pumpkin / black_blue / crawdad finish.
Bluegill Fry Static shallow pods (<= 8 ft) in WEEDS, LILY_PADS, DOCK, BRUSH, or MARSH_REEDS. Dimples at Dawn/Dusk (<= 6 ft) or density >= 0.80 (<= 4 ft). Any Topwater or Spinnerbait, any chatter / popper / frog / buzzbait / swim_grass / paddle_tail ID, CHARTREUSE_FIRE profile, or bluegill / firetiger / chartreuse / bream finish.

Solar Phase & Night Fishing (solar_mod)

  • Dawn & Dusk (Crepuscular Window): Low-light predators (Walleye, Largemouth, Smallmouth, Striped Bass, Northern Pike) in <= 15 ft gain 1.10x. Topwater, Spinnerbaits, and Jerkbaits gain an additional 1.08x (stacking to 1.188x).
  • Night (SolarPhase.NIGHT, 19:15–06:00):
  • Species Multipliers: Channel Catfish 1.35x, Walleye 1.30x, Striped Bass 1.20x, Largemouth Bass 1.15x (lit dock or <= 8 ft cover) / 1.05x (open), Bluegill / Yellow Perch / Rainbow Trout 0.60x. (Also in FishPopulation: Catfish/Burbot get +0.20 night mood, Walleye +0.14, Gar/Bowfin -0.15, Bluegill/Perch/Trout -0.18.)
  • Dark Silhouettes & High Vibration (1.25x): Any dark silhouette finish (black, blue, midnight, dark, junebug), Topwater, Spinnerbait, Jig, or Live Nightcrawler.
  • Lit Docks vs. Unlit Water (Sight Presentations): shad / natural / ghost finishes earn 1.20x on lit cells (is_dock_lit: within 3x3 of launch ramp beacon, DOCK cover, or bordering DEVELOPED_RESIDENTIAL land), but suffer 0.75x in unlit open darkness!
  • Halogen & UV Night Light Rig: 1.10x nocturnal strike bonus, 5x5 night vision, removes the +1 tick/cell unlit night outboard penalty (0.15 Ah/min).

Line Weight Guide (Finesse vs. Standard vs. Heavy)

Choosing the right line test is a core tactical trade-off between clear-water stealth (line_vis_mod) and break/abrasion resistance:

1. Clear-Water Line Visibility (clarity >= 8.0 ft)

Line Test Clear-Water line_vis_mod Stained / Muddy (< 8.0 ft) Recommended Role
2–8 lb (Finesse) 1.12x (+12% bonus!) 1.00x Gin-clear highland lakes (Clearwater, Table Rock, Glacial Shield), Drop Shots, Ned Rigs, Panfish, Trout.
9–12 lb (Standard) 1.00x (Neutral) 1.00x All-around versatile crankbaits, jerkbaits, and open-water bass/walleye without visibility penalty.
14 lb 0.95x (-5.0%) 1.00x Minimum threshold to completely eliminate abrasive-cover break penalties!
17 lb 0.875x (-12.5%) 1.00x Sweet spot for stained-water heavy cover (docks, timber, brush) and 6–10 lb bass.
20 lb 0.80x (-20.0%) 1.00x Heavy flipping, frogs in pads, and medium catfish/pike.
22 lb 0.75x (-25.0%) 1.00x Trophy pike, stripers, and heavy timber pitching in stained/muddy water.
28–50 lb (Magnum) 0.60x (floor) 1.00x Apex Muskellunge, Flathead Catfish (58–72 lb General Ironjaw), and zero-stretch glide baits.

Formula for > 12 lb in clear water (>= 8.0 ft): clamp(1.0 - (line_lb - 12) * 0.025, 0.60, 1.0).

2. Exact Line-Break & Abrasion Math

ratio      = hooked_weight_lbs / max(line_test_lb, 2.0)
break_risk = max(ratio - 0.35, 0.0) * 0.45
           + abrasive_cover_penalty   (only if line_test_lb < 14)
           + (0.08 if line_test_lb outside rod's [min, max] rating else 0.0)
           + (1.0 - line_condition) * 0.45

final_break_prob = clamp(break_risk * line_break_multiplier, 0.005, 0.85)
  • Weight Threshold: Break risk begins as soon as a hooked fish exceeds 35% of your line test (e.g., 2.8 lb on 8 lb line, 6.0 lb on 17 lb line, 10.5 lb on 30 lb line).
  • Abrasive Cover Penalty (lines < 14 lb only):
  • TIMBER, BRUSH, or DOCK: +4.5% per lb below 14 lb (e.g. 8 lb line in Timber adds +27% instant snap risk!).
  • LEDGE or ROCK_PILE: +2.5% per lb below 14 lb.
  • 14 lb or heavier line takes ZERO abrasive-cover break penalty.
  • Line Wear per Cast (TackleSystem.apply_cast_wear): Base -0.5% per cast, -3.5% in abrasive cover (TIMBER, BRUSH, DOCK, LEDGE, ROCK_PILE), -2.5% on ROCK bottom, and -(3% + clamp(weight/line_lb, 0, 1) * 6%) on a fight or snag.
  • Retie vs. Restring (Spare Line Spools):
  • Retie (Intact Rod): Free! Restores line_condition to 100% before a break occurs. Always retie once condition dips below 75% (at 50% condition, you carry +22.5% extra break risk).
  • Restring (Broken Rod): Consumes 1 Spare Line Spool ($15 at Tackle Shop; you start with 3) and costs 8 simulated minutes on the water. Between tournaments, all unlocked rods are repaired automatically at the dock.

Seasons & Biological Phases

Season Biological Phase Water Temp Offset Depth Shift Daylight Window Density & Strike Synergies
Spring Pre-Spawn / Spawn -8 °F / -2 °F -4 ft / -6 ft 06:00–20:00 Shallow flats (2–8 ft) + Weeds/Pads/Docks: 1.18x density, 1.10x strike (1.05x partial). Deep >= 22 ft warmwater fish drop to 0.85x density.
Summer Summer Peak +8.0 °F +6.0 ft 05:30–21:00 Shaded cover or 14–28 ft ledges: 1.30x density; Midday (11 AM–3 PM) 14–28 ft ledges: 1.20x strike. Unshaded shallow (<= 6 ft, no cover) plunges to 0.65x density.
Autumn Fall Turnover -4.0 °F +1.0 ft 07:00–18:30 4–14 ft rock/ledges: 1.30x density. Reaction baits (Crankbaits, Spinnerbaits, Topwater, Swimbaits, Jerkbaits) on rock/ledges, 4–14 ft flats, or >= 6 mph wind: 1.25x strike.
Winter Winter Deep -18.0 °F +10.0 ft 07:30–17:00 20–38 ft ledges/bluffs: 1.40x density (<= 8 ft drops to 0.45x). Slow bottom baits (Jigs, Soft Plastics, Live Bait) on 18–38 ft structure/ledges: 1.30x strike (1.15x elsewhere). Coldwater specialists (Walleye, Trout, Perch, Pike, Burbot): 1.25x density (10–32 ft) and 1.20x strike. Topwater penalized to 0.25x!

Tournament Rulesets & Weigh-In Penalties (ScoringSystem)

  • Dead Fish Penalty: -0.25 lbs per dead fish. Dead fish cannot be auto-culled and are ineligible for Big Bass Kicker! Keep your live-well aerator powered (or equip the Pro Live-Well).
  • Late Check-In Penalty: -1.00 lb per minute late up to 15 minutes grace. Checking in > 15 minutes late or failing to check in at the launch ramp results in automatic Disqualification (0.00 lbs).
  • Safety Violation Penalty: -2.00 lbs flat deduction (e.g., running the outboard without a PFD/life jacket).