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 辅助完成。

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

Target Modes

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

Thunderstore Mod Manager / r2modman (Recommended)

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

Manual Installation

1. Install BepInEx 5.
2. Place HowToFishMagicBullet.dll in:

   BepInEx/plugins/HowToFishMagicBullet/
   

3. 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 开发的静默自瞄与目标增强模组。它在开火时实时修正子弹物理飞行速度，无需强行吸附或拉扯玩家镜头。

主要特性：

• 静默自瞄：不拉镜头，视角完全自由。
• 强制爆头：开启状态下，本地玩家对有效生物造成的远程命中可进入头部判定区域，触发爆头伤害倍率。
• 移动预判与重力补偿：针对移动中的海鸥与鱼类计算提前量并补偿弹道下坠。
• 粘性锁定：连发射击时平滑保持当前目标，避免密集目标间准星跳动。
• 多种目标模式：支持 Crosshair（准星最近）、Nearest（世界距离最近）、LowestHealth（残血优先）与 BossPriority（Boss 优先）。
• 生物类别过滤：鱼类、飞鸟、信天翁均可独立开关。
• 目标安全：绝对不会锁定玩家或联机队友。
• 目标视觉：可显示居中 FOV 圆环与准星目标连线。
• 视线与穿墙独立控制：
  • RequireLineOfSight = false：允许锁定墙后目标。
  • WallPenetration = true：允许经过授权的本地玩家 Magic Bullet 子弹穿透环境障碍打击目标。
• 发射所有权隔离：信天翁投弹、鲸鱼喷火等 NPC/Boss 攻击不会被 Magic Bullet 误重定向。

Source / Issues

GitHub Repository:
https://github.com/Caijue117/HowToFish-MagicBullet

Changelog

1.2.3 - 2026-08-28

Changed

• Updated and rebuilt MagicBullet against the latest How to Fish 1.0.10 game assemblies.
• Updated compatibility for the current game build.

Notes

• No gameplay behavior changes in this release.

1.2.2 - 2026-08-25

Fixed

• Corrected files accidentally included in the previous release.
• Updated the release package with the intended documentation and assets.

1.2.1 - 2026-08-25

• Verified compatibility with the latest How to Fish update.
• Added gameplay preview documentation.
• Superseded by v1.2.2 for package-size cleanup.

1.2.0 - 2026-08-24

Added

• Added movement prediction and projectile gravity compensation.
• Added Sticky Target.
• Added Crosshair, Nearest, LowestHealth, and BossPriority target modes.
• Added independent Fish, Bird, and Albatross target filters.
• Added optional Line-of-Sight checks and Wall Penetration.
• Added FOV circle and target tracking line options.
• Added configurable target distance and debug logging.

Improved

• Improved head/weak-point targeting.
• Improved target caching and performance.
• Improved projectile tracking and cleanup.
• Improved rapid-fire and multi-projectile weapon support.
• Improved Harmony startup resilience.

Fixed

• Fixed Albatross and other NPC/Boss projectiles being incorrectly redirected by Magic Bullet.
• Fixed local-player projectile ownership detection.
• Fixed target lifecycle issues after creature death or despawn.
• Fixed startup failures caused by invalid lifecycle patches.

1.1.0 - 2026-08-24

• Initial public release.
• Added Silent Aim projectile redirection.
• Added forced headshots.
• Added FOV circle and target tracking line.
• Added Bowhead Whale targeting support.