Butterfly Knife on Shop

Version 0.2.0 for How to Fish 1.0.10.

This BepInEx mod adds one focused custom Butterfly Knife plus the game's original M9 Bayonet to the normal knife shop item. Both choices cost exactly $45.

Included knives

• M9 Bayonet (original game model)
• Butterfly Knife

Features

• A Blender-authored Butterfly V4 with continuous curved surfaces, bevels, recessed cyan inlays, liners, bores, pivot hardware, and a purple/cyan titanium finish.
• The M9 Bayonet is never replaced: it uses the original game's detailed mesh, materials, hands, and inspect animation.
• The game's native hand, finger, wrist, and knife-bone Inspect clip remains active. The Butterfly adds a real two-pin mechanical flourish: its bite handle is fixed in the palm while the safe handle fans around the actual blade pivot with out-of-plane hand clearance.
• Reworked first-person grip alignment with a dedicated per-knife GripPose, improving palm contact and keeping the Butterfly aligned through the native Inspect animation.
• A visual shop selector with shaded thumbnails, selection highlighting, and a separate purchase confirmation button.
• A pre-rendered high-detail Butterfly shop thumbnail so the selector stays responsive even with the production mesh.
• Uses the vanilla knife's damage, range, sharpness, inventory, save, and purchase behavior.
• Stores a purchased variant as a vanilla knife plus a reserved skin code, so normal saves continue to work.
• Multiplayer synchronization uses the existing FishNet knife object. For correct shops and visuals, the host and every player should install the same mod version.

Installation

1. Install BepInEx 5 (x64) into the game's folder if it is not already installed.
2. Copy the included BepInEx folder into: Steam\steamapps\common\How to Fish\How to Fish
3. Start the game through Steam.

Use

Visit any shop that sells the normal knife and press E on it. A cursor menu opens with the original M9 and Butterfly choices. Click a knife card, then click Buy for $45 to confirm. Press Esc or the menu's X button to close without buying. Use the game's Weapon Inspect input to play the custom flourish; the M9 uses the native game inspect.

Compatibility notes

• Tested with How to Fish 1.0.10, Unity 6000.4.4f1, and BepInEx 5.4.23.5.
• The selection menu uses the original knife interaction, so it does not depend on the shop layout used by a particular map.
• A future game update may change game methods and require a mod update.
• Joining an unmodded server will not support the reserved purchase IDs.

Asset and trademark note

This package contains no Valve or Counter-Strike model, texture, sound, or animation files. The Butterfly geometry is authored for this mod; no third-party meshes are redistributed. Product and knife names may be trademarks of their respective owners; this is an unofficial fan mod.

Development disclosure

This project was developed with substantial assistance from OpenAI Codex. The package was compiled and tested against the live game before release; its two menu entries, native M9 restoration, Butterfly production mesh, renderer replacement, and knife hierarchy integration passed the included runtime self-test.

Changelog

0.2.0

• Reworked the Butterfly Knife first-person grip alignment with a dedicated per-knife GripPose.
• Fixed the handle sitting too far out of the player's palm during normal holding.
• Improved Butterfly alignment throughout the game's native Inspect animation without replacing the native hand/finger choreography.
• Separated model-space coordinates from gameplay grip-space calibration for a more stable attachment pipeline.
• Preserved the Butterfly mechanical blade/handle pivot hierarchy while keeping the native Knife bone as the animation driver.
• Restored native inspect audio behavior in the custom inspect path.
• Added development-only runtime grip calibration tools and backward-compatible rig metadata.
• Verified the updated build against How to Fish 1.0.10.

0.1.10

• Aligned the Butterfly handle-to-tip axis directly with the original game's native Knife bone, matching the M9's first-person holding direction.
• Removed the Karambit from the catalog and shop selector; the mod now contains only the original M9 and Butterfly Knife.
• Kept both available knives priced at exactly $45.

0.1.9

• Replaced the old flat procedural Butterfly implementation with the embedded Blender-authored Butterfly V4 mesh: 65,472 rendered vertices, 125,132 triangles, curved blade/handles, recessed inlays, liners, bores, and hardware.
• Rebuilt its hierarchy as a real mechanical chain: bite handle fixed in the hand, blade at the bite pin, and safe handle at the second pin. This eliminates the previous shared fake pivot and part overlap.
• Reworked the Butterfly inspect layer to preserve the base game's complete hand/finger/wrist clip while animating the safe handle through a clearance-aware fan and catch. The custom root no longer adds camera-moving wrist transforms.
• Added a polished purple/cyan titanium material set and a pre-rendered selector thumbnail; retained the original M9 and the $45 price for every choice.

0.1.8

• Re-authored the Butterfly and Karambit silhouettes with deeper bevels, blade-face geometry, layered handle construction, machined fasteners, jimping, and ring/pivot hardware.
• Added subtle generated normal detail to metal and grip materials for better highlights in first-person and the shop preview.
• Reworked the selector cards with larger thumbnails, lit face shading, and a live rotating 3D selected-knife preview instead of reusing a flat icon.

0.1.7

• Removed the compounded full-wrist spins that could throw Butterfly/Karambit out of frame.
• Kept the native game Inspect clip as the sole hand/finger/knife-bone driver; custom layers are now bounded pivot accents only.

0.1.6

• Reused the native How to Fish Inspect clip for custom knives, including the game's hand, finger, IK, and knife-bone curves.
• Matched inspect timing to the native clip and limited custom overlays to Butterfly hinge motion and Karambit twirl motion.
• Removed the guessed full-hand inspect pose that could freeze hands or push the weapon outside the camera.

0.1.5

• Corrected the first-person mesh basis so custom blades show their broad face and full silhouette instead of an edge-on strip.
• Switched live inspect playback to bounded IK/root posing so the knife and hand remain inside the camera view.
• Updated Butterfly and Karambit materials to silver blades with black grips for clearer CS-style contrast.

0.1.4

• Reduced the shop to the original M9 Bayonet, Butterfly Knife, and Karambit only.
• Removed all other knife cards and custom definitions from the active catalog.
• Rebuilt the Karambit as a broad hooked crescent with fuller, cutting edge, contoured scale, finger grooves, pin, bridge, and ring hardware.
• Preserved the previous Butterfly and Karambit skin codes so existing saves keep those purchases.

0.1.3

• Restored the original game's detailed M9 Bayonet model, materials, hands, and inspect animation; the mod no longer substitutes a procedural M9.
• Kept the M9 in the $45 selector as a native-game choice while retaining 18 custom knife models.
• Rebuilt inspect playback around the game's legacy Animation + IK target path so the hand and knife move together.
• Added per-knife rig curves for wrist, hand target, root motion, and dual-wield mirroring.
• Refined the selector layout with an accent header, model filter bar, preview badge, and cleaner card borders.

0.1.2

• Fixed the vanilla and custom held knife models rendering on top of each other.
• Replaced the vanilla inspect clip for modded knives instead of layering custom movement over it.
• Added 19 distinct inspect motion profiles, one for every knife.
• Rebuilt the butterfly knife with grouped blade, handle hinges, inset panels, rivets, and latch details.
• Replaced the plain button menu with crisp model thumbnails, a large detail preview, selection state, and explicit Buy for $45 confirmation.

0.1.1

• Replaced the world-space knife rack with a cursor-driven selection menu opened from the original knife.
• Made knife selection independent of shop position and map layout.
• Added movement/camera blocking while the menu is open and Esc/X close controls.
• Kept all 19 knives priced at $45 and retained the vanilla purchase flow.

0.1.0

• Initial release for How to Fish 1.0.9.
• Added 19 buyable knife variants, all priced at $45.
• Added original procedural models and independent inspect flourishes.
• Added inventory, save, and FishNet multiplayer synchronization support.
• Verified all 19 catalog meshes and world-model attachments in the live game runtime.