SuperCreatures

A feature-packed enhancement mod for How to Fish that gives you complete control over Super (Drip) fish spawn rates, Reel of Fortune (Slot Machine) item filters, skin rarity rolls, targeted skin drops, and fishing multipliers.

Comes with a sleek In-Game AMOLED Dark GUI (F5) featuring drag-and-drop movement, window resizing, and instant live configuration without restarting the game.

✨ Features

🎮 In-Game Overlay GUI (F5)

• AMOLED Dark Theme: Modern dark aesthetic with custom cyan accents and styled scrollbars.
• Draggable & Resizable: Drag the top header to reposition anywhere on screen, or drag the bottom-right corner (//) to resize.
• Instant Hot-Reload: All slider adjustments and toggle clicks take effect immediately in real-time.
• Smart Input Isolation: Locks camera mouse look, weapon clicks, and hotbar scrolling while interacting with the menu, while keeping player movement (WASD, running, jumping) fully functional.

🌐 Dual Language Support (EN / RU)

• English by default with a one-click toggle to Russian (EN / RU) directly in the header.
• Automatically translates settings in both the overlay GUI and ModMenu.

🐟 Super & Drip Fish Customization

• Spawn Chance Slider: Fine-tune the chance (0–100%) for caught fish to spawn as Drip / Super variants.
• 100% Guarantee Toggle: Force every caught fish to be a Drip fish.
• Boss Drip Support: Allow bosses and mini-bosses to also roll Drip modifiers.

🎰 Universal Slot Machine Filters & Multipliers

• Global Reel Category Filter: Lock the slot machine pool strictly to specific item types across all islands and locations:
  • ALL ITEMS (Все предметы)
  • KNIVES ONLY (Только ножи и холодное оружие)
  • SNIPER RIFLES ONLY (Только снайперские винтовки)
  • ASSAULT RIFLES ONLY (Только автоматы)
  • FISHING RODS ONLY (Только удочки)
  • SHOTGUNS ONLY (Только дробовики)
  • BOAT SKINS ONLY (Только катер — работает на всех островах)
• Collapsible Skin Selector (100% Drop Guarantee):
  • Toggle "Force Skin by ID" to unfold an interactive skin browser.
  • View all available skins, names, rarity tags (Common, Rare, Legendary), and IDs for the selected weapon.
  • Click any skin to guarantee a 100% drop on your next spin, with an active badge and quick Reset button.
• Rarity Rate Controls: Custom sliders for Legendary and Rare skin chances, plus a 100% Legendary Guarantee toggle.
• Category Weights: Adjust relative drop chance multipliers (0.0x - 10.0x) for each weapon type.

🎣 Fishing Multipliers

• Rare Fish Multiplier: Boost bite chances (1.0x - 10.0x) for rare species like Dripper, Shark, and Gar.
• Boss Hook Multiplier: Increase the chance to hook bosses and mini-bosses.

🕹️ Controls

⚙️ Configuration

All settings can be tweaked live in-game (F5), through ModMenu, or by editing BepInEx/config/com.howToFish.supercreatures.cfg:

0. System & Interface

• Language (English / Russian): Interface language.
• MenuKey (Default: F5): Hotkey to open/close the overlay.

1. General

• Enabled (Default: true): Master switch. Disabling immediately restores 100% vanilla game behavior.

2. Super Creatures (Drip)

• SuperCreatureChance (0–100%, Default: 50): Chance for caught fish to be Drip variants.
• AlwaysSuper (Default: false): 100% Drip fish guaranteed.
• AllowBosses (Default: false): Allow bosses to roll Drip variants.

3. Slot Machine (Rarities & Items)

• ItemFilter (Default: All): Filter item reel pool (All, KnivesOnly, SnipersOnly, AssaultRiflesOnly, FishingRodsOnly, ShotgunsOnly, BoatsOnly).
• SpecificSkinIndex (Default: -1): Force a specific skin ID (-1 for random).
• SlotLegendaryChance (0–100%, Default: 50): Legendary skin drop chance.
• SlotRareChance (0–100%, Default: 30): Rare skin drop chance.
• SlotAlwaysLegendary (Default: false): Guarantees Legendary skin on every spin.
• FishingRodWeight / SniperWeight / KnifeWeight / ShotgunWeight / FirearmsWeight / BoatWeight (0.0 – 10.0, Default: 1.0): Category drop multipliers.

4. Fishing Multipliers

• RareFishMultiplier (1.0 – 10.0, Default: 2.0): Spawn weight multiplier for rare fish.
• BossHookMultiplier (1.0 – 10.0, Default: 1.0): Bite chance multiplier for bosses.

📥 Installation

Using Mod Manager (Recommended)

Install via Thunderstore Mod Manager or Gale Mod Manager.

Manual Installation

1. Install BepInEx 5.4+ (Mono) for How to Fish.
2. Download and extract SuperCreatures.zip.
3. Copy SuperCreatures.dll (and icon.png) into How to Fish/BepInEx/plugins/SuperCreatures/.
4. Launch the game and press F5!

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.