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:
- Snag Check runs first. If snagged, the cast ends immediately (no bite roll).
- Best Species Selection: Evaluates
density * feeding_moodacross every species on the lake at the clamped running depth and picks the highest-scoring species. - 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.15xwhen 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.00xif the lure category is in the species' preferred list;0.90xif not;0.70xfor Live Bait (worm_nightcrawler/LIVE_BAIT), which also applies a0.80xweight multiplier. - Strike Multiplier Soft Cap: Linear up to
1.85x, then 35% marginal gain above1.85x, hard-capped at2.25x. - Weight Multiplier Soft Cap: Linear up to
1.15x, then 35% marginal gain above1.15x, hard-capped at1.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.15xat>= 12 mphwind (1.08xat>= 7 mph). Walleye gain1.10xat>= 6 mph("Walleye Chop"). - Lure-Weather Synergy (
cat_mod): - Topwater:
1.25xwhen ambient light<= 0.55AND wind<= 12 mph; otherwise penalized to0.72x. - Spinnerbait:
1.20xwhen wind>= 8 mphOR light<= 0.70; otherwise0.92x. - All other categories: flat
1.05xbaseline. - 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.04per tick, moving 1 cell downwind at1.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 °Faround 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 at1.12x–1.15xnear the band midpoint (0.95xat edges). Outside the band, mood drops by-0.045per °F down to a0.15xfloor.
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 explicitLEDGEcover or a>= 6.0 ftdepth difference to any cardinal neighbor. Ledges automatically grant a1.22xspecies habitat density multiplier. - Preferred Depth Fit:
1.15xinside[preferred_depth_min + seasonal_shift, preferred_depth_max + seasonal_shift]; decays by-0.045per ft outside (floor0.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 ftfor Skiffs,2.0 ftfor Bass Classic 17,2.8 ftfor 19ft/21ft fiberglass/carbon tournament rigs). - Shallow / Heavy-Cover Trolling Penalty (
shallow_obstacle_tick_penalty): On hulls with a penalty (+1tick on 17ft,+2ticks on 19ft/21ft), entering water<= 3.0 ft,LILY_PADS,TIMBER, orROCKbottom<= 6.0 ftforces the outboard to drop into Trolling Motor mode and adds the tick penalty per obstacle cell. Shallow-draft skiffs (0penalty) 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 ftgain1.10x. Topwater, Spinnerbaits, and Jerkbaits gain an additional1.08x(stacking to1.188x). - Night (
SolarPhase.NIGHT,19:15–06:00): - Species Multipliers: Channel Catfish
1.35x, Walleye1.30x, Striped Bass1.20x, Largemouth Bass1.15x(lit dock or<= 8 ftcover) /1.05x(open), Bluegill / Yellow Perch / Rainbow Trout0.60x. (Also inFishPopulation: Catfish/Burbot get+0.20night 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/ghostfinishes earn1.20xon lit cells (is_dock_lit: within 3x3 of launch ramp beacon,DOCKcover, or borderingDEVELOPED_RESIDENTIALland), but suffer0.75xin unlit open darkness! - Halogen & UV Night Light Rig:
1.10xnocturnal strike bonus, 5x5 night vision, removes the+1 tick/cellunlit 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 lbon8 lbline,6.0 lbon17 lbline,10.5 lbon30 lbline). - Abrasive Cover Penalty (lines
< 14 lbonly): TIMBER,BRUSH, orDOCK:+4.5%per lb below 14 lb (e.g.8 lbline in Timber adds+27%instant snap risk!).LEDGEorROCK_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%onROCKbottom, 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_conditionto100%before a break occurs. Always retie once condition dips below75%(at50%condition, you carry+22.5%extra break risk). - Restring (Broken Rod): Consumes 1 Spare Line Spool (
$15at Tackle Shop; you start with3) 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 lbsper 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 lbper minute late up to15 minutesgrace. 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 lbsflat deduction (e.g., running the outboard without a PFD/life jacket).