MagicBullet

Magic Bullet

Silent Aim & Forced Headshots mod for _How to Fish_

Magic Bullet redirects projectile velocity toward valid creature targets in real time without moving your camera or crosshair.

This mod was researched, developed, and packaged with AI assistance.

本 Mod 的逆向分析、代碼實現與打包流程由 AI 輔助完成。

Gameplay Preview

Moving Target Tracking / 移動目標追蹤

Albatross Targeting / 信天翁目標鎖定

Features

• Silent Aim — Redirects real projectile velocity without camera snapping or view lock.
• Forced Headshots — While Magic Bullet is enabled, eligible ranged hits from the local player against supported creature targets can be promoted into the game's headshot region.
• Movement Prediction — Intercept prediction with ballistic gravity compensation for moving targets.
• Sticky Target — Retains the current target during continuous firing to prevent target jumping.
• Target Modes — Four selectable targeting strategies: Crosshair, Nearest, LowestHealth, and BossPriority.
• Target Filters — Fish, Birds, and Albatross can be enabled or disabled independently.
• Strict Target Safety — Players and teammates are never selected as Magic Bullet targets.
• Visuals — Optional on-screen FOV circle and target tracking line (clipped to screen bounds).
• Optional Wall Penetration — Allows authorized local-player Magic Bullet shots to pass through environmental obstacles.
• Projectile Ownership Isolation — NPC/Boss projectiles such as Albatross attacks are not redirected.

Controls

| Key | Action |

|:--- |:--- |

| F8 | Toggle Magic Bullet ON / OFF |

| [ | Decrease targeting FOV |

| ] | Increase targeting FOV |

Target Modes

| Mode | Behavior |

|:--- |:--- |

| Crosshair | Targets the valid creature closest to the crosshair center within FOV (default). |

| Nearest | Targets the closest valid creature by 3D world distance. |

| LowestHealth | Targets the valid creature with the lowest remaining health. |

| BossPriority | Prioritizes boss targets. |

Line of Sight & Wall Penetration

RequireLineOfSight and WallPenetration are independent settings:

• RequireLineOfSight = false — Targets behind obstacles may be acquired.
• WallPenetration = true — Authorized local Magic Bullet projectiles may pass environmental obstacles to reach the selected target.

Examples:

• RequireLineOfSight = false + WallPenetration = false (Default): Targets behind obstacles can be locked, but projectiles are still stopped by obstacles.
• RequireLineOfSight = false + WallPenetration = true: Targets behind obstacles can be locked and authorized Magic Bullet projectiles will penetrate obstacles to reach them.
• RequireLineOfSight = true: Targets hidden behind obstacles cannot be acquired.

Note: WallPenetration does NOT globally disable collisions and does not affect NPC or remote-player projectiles.

Installation

Mod Manager / r2modman (Recommended)

• Install Magic Bullet through Mod Manager or r2modman.
• Ensure the BepInExPack dependency is installed.
• Launch the game using Start modded.
• Press F8 in-game to toggle Magic Bullet.

Manual Installation

• Install BepInEx 5.
• Place HowToFishMagicBullet.dll in:

BepInEx/plugins/HowToFishMagicBullet/

• Launch the game.

Configuration

The configuration file is generated after first launch at:

BepInEx/config/com.openai.howtofish.magicbullet.cfg

Important settings and their defaults:

[MagicBullet]

Enabled = true

[Targeting]

TargetMode = Crosshair

FOV = 35.0

MaxTargetDistance = 500.0

StickyTarget = true

RequireLineOfSight = false

WallPenetration = false

[Filtering]

TargetFish = true

TargetBirds = true

TargetAlbatross = true

[Visuals]

ShowFOVCircle = true

ShowTargetLine = true

[Diagnostics]

DebugLogging = false

📖 中文說明

Magic Bullet 是專爲 How to Fish 開發的靜默自瞄與強制爆頭模組。

Magic Bullet 在開火時實時重定向子彈飛行速度矢量，將其引導至有效生物目標，全程無需轉動或吸附玩家鏡頭與準星。

本 Mod 的逆向分析、代碼實現與打包流程由 AI 輔助完成。

✨ 主要特性

• 靜默自瞄 (Silent Aim) — 實時重定向真實子彈物理速度，絕不強行轉動或鎖定玩家視角。
• 強制爆頭 (Forced Headshots) — 開啓 Magic Bullet 期間，本地玩家對支持的生物目標造成的遠程命中可直接進入遊戲頭部判定區域，觸發爆頭倍率。
• 移動預判 (Movem