AstralBeauty-SpearFishing icon

SpearFishing

Catch fish with spears, harpoons, bows and crossbows. Network-safe Spearfishing remake.

Last updated 3 hours ago
Total downloads 27
Total rating 0 
Categories Mods Tweaks Misc Client-side
Dependency string AstralBeauty-SpearFishing-1.0.2
Dependants 0 other packages depend on this package

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2202 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured and includes unstripped Unity DLLs.

Preferred version: 5.4.2202

README

SpearFishing

Catch fish with spears, harpoons, bows and crossbows.

A modern, network-safe remake of the classic spearfishing idea: hit a swimming fish with a projectile and either loot the floating catch or (with the Abyssal Harpoon) pull it straight into your inventory.

Speared fish stay as the same object turned into a floating corpse (Fish AI removed). They are not respawned as a new living fish.

Features

  • Works with spears, Abyssal Harpoon, bows and crossbows
  • Detects weapons by skill type (survives game updates better than name matching)
  • Multiplayer-safe: destroys the living fish for everyone, then spawns a normal floating item drop
  • Harpoon auto-pickup when you have inventory space
  • Config to toggle each weapon type, auto-pickup, Fishing XP, messages and VFX

Do not run this together with Korppis Spearfishing — disable/remove the old mod first.

Config

Generated at BepInEx/config/valheimoverhaul.spearfishing.cfg after first launch.

Option Default Description
Enable Spears true Catch with thrown spears
Enable Harpoons true Catch with Abyssal Harpoon (auto-pickup)
Enable Bows true Catch with bow arrows
Enable Crossbows true Catch with crossbow bolts
Auto Pickup All false Auto-add fish to inventory for all weapons (harpoon always does)
Require In Water true Only catch swimming fish
Grant Fishing XP true Small Fishing skill gain on catch
Show Messages true Center HUD messages
Hit Effects true Blood / hit VFX

Install

  1. Install BepInExPack Valheim
  2. Install this mod
  3. Remove/disable Korppis-Spearfishing if present

Credits

  • Idea / original mod: Korppis — Spearfishing (MIT source)
  • This remake: written with Cursor (Grok) for the Valheim Overhaul project — not a fork of the old DLL; reimplemented against current Valheim APIs

Compatibility

  • Client-side; server install optional (everyone who wants the feature should have it)
  • Incompatible with org.bepinex.plugins.spearfishing (old Spearfishing)