SuperCreatures

A BepInEx mod for How to Fish that allows you to configure the spawn chance of rare "Drip" (Shiny) creatures.

In the base game, caught fish only have a ~5% chance to appear as a special Drip variant (wearing sunglasses, featuring custom meshes, and selling for significantly more in the Journal). This mod gives you full control over that roll.

Features

• Configurable Drip spawn chance (0% to 100%, default: 50%).
• Optional toggle to force every catch to be a Drip variant (100% guarantee).
• Optional setting to allow bosses and mini-bosses to also roll Drip variants.
• Dynamic bilingual support (automatically adapts to English or Russian depending on game language).
• Compatible with in-game mod settings menus (e.g. ModMenu) for live adjustments.

Configuration

Settings can be modified in-game or via the configuration file at BepInEx/config/com.howToFish.supercreatures.cfg:

• Enabled (true/false, default: true): Toggles the mod on or off.
• SuperCreatureChance (0 - 100, default: 50): Percentage chance for hooked fish to spawn as Drip variants.
• AlwaysSuper (true/false, default: false): Overrides the percentage chance and guarantees a Drip roll on every catch.
• AllowBosses (true/false, default: false): Enables Drip rolls for bosses and mini-bosses.

Installation

Via Mod Manager (Recommended)

Install directly through Thunderstore Mod Manager or Gale.

Manual Installation

1. Ensure BepInEx 5.4+ is installed.
2. Place SuperCreatures.dll into your How to Fish/BepInEx/plugins/ directory.
3. Start the game.

Changelog

[1.0.2] - 2026-08-24 - HOTFIX (Game 1.0.9 Compatibility)

Added

• Full Compatibility with Game Update 1.0.9:
  • Fully adapted all slot machine hooks to the new SlotMachineManager architecture introduced in game update 1.0.9 (RollRandom, SendRoll).
  • Restored full custom skin rolls, category filters (Knives, Snipers, Assault Rifles, Rods, Shotguns, Boats), specific skin IDs, and legendary probabilities on game v1.0.9.
• Multi-Stage Drip Lifecycle Hooks (DripHelper):
  • Multi-stage synchronization of Drip visuals, accessories (glasses, chains), gold meshes, and network SyncVars across CreatureManager.HookItem, Bait.AddItemOnBait, and Creature.OnStartClient.
  • Ensures 100% reliable super fish transformations in both single-player and multiplayer sessions.
• Comprehensive Debug & Diagnostic Logging:
  • Added real-time informational and diagnostic logging to BepInEx/LogOutput.log to trace fish bites, Drip applications, and slot rolls with exact parameters.
• Enhanced Input & Interaction Locking System:
  • Integrated Player.get_BlockInputs native hook alongside PlayerCamera, PlayerInventory, PlayerHolding, PlayerPunching, and FishingRod input blockers.
  • Completely prevents mouse wheel hotbar scrolling, item selection, shooting, rod casting, and camera drifting while the F5 menu is open, while preserving full WASD walking movement.
• Debounced Menu Toggle (F5):
  • Implemented unscaled frame-time debouncing to prevent double-toggling or stutter when opening and closing the in-game GUI.
  • Ensures clean cursor unlocking and locking lifecycle.

Fixed

• Guaranteed 100% Super/Drip Fish Spawning:
  • Fixed an issue where changing the internal shiny chance variable did not apply to hooked fish due to game 1.0.9 caching mechanisms and uninitialized network state.
  • Now DripHelper directly triggers Creature.SetDrip(), updates SyncVars, and enables 3D accessories on the hooked catch, guaranteeing 100% shiny/drip variants and journal unlock when the toggle is enabled or percentage roll succeeds.
• Reel of Fortune (Slot Machine) Hooks in 1.0.9:
  • Resolved slot machine rolls not applying custom filters or crashing due to game 1.0.9 migrating reel logic into SlotMachineManager.
• Complete Input & Interaction Isolation:
  • Fixed accidental hotbar scrolling and weapon swinging while clicking sliders and buttons in the GUI.

[1.0.1] - 2026-08-24

Added

• Separated Weapon Reel Filters:
  • Filter options are now explicitly divided into SNIPER RIFLES ONLY (SniperRifle) and ASSAULT RIFLES ONLY (AssaultRifle) for precise roll targeting.
• Collapsible Visual Skin Selector (SpecificSkinIndex):
  • Interactive skin browser in the Slot Machine tab displaying available skins, names, and rarity tags (Common, Rare, Legendary) for the selected category.
  • Collapsed by default for a clean UI, expanding on demand when toggling "Force Skin by ID" mode.
  • Click any skin card to guarantee a 100% drop on your next slot machine spin, with active selection badges and instant Reset / Turn Off button.
• Draggable & Resizable In-Game GUI (F5):
  • AMOLED dark overlay with tabs, live sliders, and instant setting updates.
  • Spawns in top-left, draggable by header, and resizable by corner grip (//).
• Language Switcher (EN / RU):
  • English by default with one-click toggle to Russian (EN / RU).
• Universal Slot Machine Item Filter (ItemFilter):
  • Filter reel pool strictly to specific categories (Knives only, Snipers only, Assault Rifles only, Rods only, Shotguns only, Boat skins only) across all islands and locations.
• Skin Rarity & Weight Settings:
  • Custom Legendary / Rare drop chances with 100% Legendary guarantee toggle.
  • Category roll weights (Knives, Snipers, Assault Rifles, Rods, Shotguns, Boats).
• Fishing Multipliers:
  • Multipliers for rare fish species (Dripper, Shark, Gar) and boss hook chances.
• Dynamic Russian Localization:
  • Auto-translates ModMenu config labels when running in Russian.

Fixed

• Slot Machine Reel Drop Overhaul: Redesigned reel generation and drop targeting to ensure standard rarity distribution and flawless visual animations when forcing specific skin drops or rarity tiers.
• Strict Weapon Type Isolation: Fixed filter keyword overlap where AssaultRifle (containing "rifle") was falsely rolled under Sniper Rifles.
• Boat Skin Rolls on Starter Island: Fixed slot machine rendering and rolling blank when filtering by Boat skins on islands where the boat hasn't spawned yet by providing fallback prefab access.
• Camera & Mouse Input Isolation: While the mod menu is open, camera rotation, hotbar mouse scroll, and weapon actions are completely locked to prevent accidental clicks or camera drift, while full player movement (WASD, running, jumping) remains available.
• Global Island Slot Pool Support: Fixed slot machines on later islands (which only contained rifles) so they can roll knives and any other selected weapon category from the global game database.
• Game Stability & Crash Protection: Added comprehensive error handling and safe bounds-checking across all slot machine hooks, network RPCs, and UI rendering to completely eliminate random game crashes.
• IMGUI Layout State Fix: Fixed layout control count sync to prevent game crashes when clicking toggles or switching tabs.
• AMOLED Scrollbar Styling: Replaced default Unity grey scrollbars with a custom dark/cyan scrollbar matching the UI theme.
• Clean Typography & Encoding: Saved with UTF-8 BOM and standard characters to eliminate encoding artifacts.
• Master Toggle Functionality: Clarified General settings tab so disabling the mod immediately restores 100% vanilla game behavior.

[1.0.0] - 2026-08-24

Added

• Initial release with configurable Drip fish spawn rates.