SuperCreatures [v1.1.5]

SuperCreatures is a dynamic creature scaling and rarity modifier for How to Fish, allowing fish to scale anywhere from 0.2x Micro to 25.0x Kaiju Giants, customizing slot machine drop rates, and configuring all physics parameters in a pleasant and convenient in-game menu (F5).

Fully Tested & Compatible with the latest Steam game update (including dropped item world saving, cooked meat washing mechanics, and roulette physics).

⚙️ How It Works & Architecture

SuperCreatures hooks into the game's core creature spawning pipeline via HarmonyLib:

• Dynamic Mesh & Transform Scaling: Hooks Creature.Start to scale Creature.transform.localScale smoothly between 0.2f and 25.0f.
• Procedural Collider & Physics Adjustment: Automatically scales CapsuleCollider.radius, CapsuleCollider.height, and adjusts Rigidbody.mass so that oversized and microscopic fish interact naturally with water buoyancy and world geometry.
• Storage & Display Compatibility: Integrates with SaveManager.SaveWorldItems and display racks to prevent physics explosions or visual clipping when storing giant creatures.
• Slot Machine & Loot Weight Tables: Hooks into BaitInfo.ItemWeights and Purchasable to allow real-time control over creature spawn rarities and slot machine drop tables.

✨ Key Features

• 🦈 Dynamic Scale Range (0.2x – 25.0x): Scale fish from pocket-sized minnows to colossal sea monsters.
• 🎨 In-Game Control Menu (F5):
  • Procedural capsule toggles (DrawPillToggle) with smooth sliding knobs.
  • Camera look is isolated while adjusting sliders, while character WASD walking remains fully active.
  • Multi-tab layout: Fish Scaling, Loot Weights, Roulette Studio, and Settings.
• 🎰 Drop Chance Modifiers: Real-time sliders for Super/Drip creature spawn chances and slot machine payouts.
• 🌐 Instant Bilingual Toggle: One-click switch between English and Russian across all UI labels.

🎮 Controls

⚙️ Configuration

The configuration file is located at BepInEx/config/com.howToFish.supercreatures.cfg:

[1. General]
Enabled = true                  # Enable or disable creature scaling
MinScale = 0.2                  # Minimum possible fish scale multiplier
MaxScale = 25.0                 # Maximum possible fish scale multiplier

[2. Loot & Chances]
SuperChanceMultiplier = 1.0     # Multiplier for Super creature spawn rates
SlotWeightMultiplier = 1.0      # Multiplier for slot machine payouts

📥 Installation

1. Install BepInEx 5.4+ for How to Fish.
2. Extract SuperCreatures.zip into your game directory or place SuperCreatures.dll into How to Fish/BepInEx/plugins/SuperCreatures/.
3. Launch the game and press F5 to open the menu!

📄 License

Distributed under the MIT License. See LICENSE for more information.

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.