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

All notable changes to SuperCreatures are documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.1.5] - 2026-08-28 - Release Update: Full Scale Stability & Performance

⚡ Improvements

• Ultra-Smooth Physics Interaction: Enhanced rigidbody synchronization when holding, throwing, and washing giant/microscaled creatures.
• Drip Accessories & Caught Banner Polish: Optimized rainbow neon "Caught!" banner timing and shimmering SFX synchronization on all bite types.
• Thunderstore Ready: Cleaned packaging and metadata for release.

[1.1.4] - 2026-08-28 - Fix: Visual Effects & Catch Banner Synchronization

🐛 Fixed

• Rainbow "Caught!" Floating Banner & SFX: Fixed an issue where enabling Always Super rolled Drip status too late for the initial bite animation. Hooked into Item.InitializeBait to instantly trigger the floating rainbow neon "Caught!" text above the water and play the shimmering catch sound effect on bite.
• 3D Drip Mesh Assignment: Ensured that the 3D Drip accessory mesh (sunglasses, hats) is applied to hooked creatures immediately upon spawning on the line.

[1.1.3] - 2026-08-28

🐛 Fixed

• Creature Scale Persistence: Fixed a bug where fishing, picking up, holding in hands, swapping inventory slots, or dropping Super Creatures on the ground reverted them back to their original size. Scale is now 100% persistent across all interactions.
• F5 Menu Keybind & Mouse Unlock: Resolved an issue where F5 could fail to trigger or unlock the cursor; added direct hardware keybind hook and PlayerCamera.ToggleMouse camera isolation.

[1.1.2] - 2026-08-27

• Microfix & performance stability improvements.

[1.1.1] - 2026-08-27

• Microfix: resolved scale boundary checks on extreme sizes.

[1.1.0] - 2026-08-27 - Major Update: Kaiju Scaling & Menu Overhaul

🌟 Added

• Full Game & Engine Compatibility:
  • Full compatibility with the latest game build (SaveManager.SaveWorldItems item saving, Item.CleanCookness water washing, and roulette physics).
• Kaiju Scale Multipliers:
  • Scale range expanded from 0.2f Micro up to 25.0f Kaiju Giants.
  • Scale dynamically applied across Creature.transform.localScale, MeshFilter.mesh, and CapsuleCollider bounds.
• Pleasant & Convenient In-Game Menu (F5):
  • Added clean settings menu with graphical capsule switches (DrawPillToggle) and sliding knobs.
  • Full mouse look lock while keeping WASD movement active.
  • Multi-tab navigation: [Fish Scaling], [Loot Weights], [Roulette Studio], [Settings].
• Slot Machine & Loot Customizer:
  • Sliders to adjust creature rarities and drop chances in real-time.
• Bilingual Interface:
  • Instant one-click toggle between English and Russian.

⚡ Optimized

• Cached MeshFilter queries in Creature_Start_Patch to reduce per-frame GC allocations.
• Optimized Harmony execution paths in FishSpawner.SpawnCreature.

🐛 Fixed

• Fixed visual mesh clipping inside storage boxes and racks.
• Fixed collision raycasts on microscopic (< 0.5f) fish models.

[1.0.2] - 2026-08-25

⚡ Optimized

• Optimized UI draw calls for high-refresh rate displays (144Hz+).
• Refined scale persistence across scene loads.

[1.0.1] - 2026-08-24

🐛 Fixed

• Fixed scale synchronization in multiplayer client sync.
• Adjusted default configuration boundary values.

[1.0.0] - 2026-08-23

🌟 Added

• Initial release of SuperCreatures.