EpicGuns

EpicGuns 0.5.0

Three configurable Valheim firearms using the Bows skill and Bow item category, with custom models, icons, ammunition, and sounds. Requires BepInExPack Valheim 5.4.2350 and Jotunn 2.30.2. Epic Loot is optional.

Weapons and recipes

| Weapon | Tier / station | Crafting materials | Default damage | Firing |

|---|---|---|---|---|

| 1911 | Black Forest / Forge 1 | 8 Bronze, 4 Fine Wood, 2 Deer Hide | 22 weapon + 18 ammo pierce | One round, 1-second base reload |

| Pump Action | Black Forest / Forge 1 | 15 Bronze, 15 Tin | 60 total pierce across 12 pellets | One shell, 1.8-second base reload |

| M16 | Swamp / Forge 2 | 20 Iron, 10 Fine Wood, 5 Leather Scraps | 18 weapon + 10 ammo pierce per bullet | 3-round automatic burst, 0.12 seconds between rounds, 1.1-second base reload |

Damage values are before skill, armor, resistance, and magic modifiers. A shotgun pellet deals 5 base pierce, not 60. Spread makes the shotgun most effective nearby. Valheim applies armor separately to each hit. Both new weapons have four quality levels; shotgun upgrades add 6 total pierce and rifle upgrades add 3 pierce per bullet per level.

The shotgun uses a blued-steel barrel, bronze fittings, ribbed walnut pump, stock, trigger guard, sights, receiver pins, and ejection port. The M16 has a fixed polymer stock, open carry handle, ribbed handguard, front sight tower, flash hider, and gently curved magazine. The overhauled 1911 has a slim chamfered slide, flush muzzle, swept walnut grip, open curved trigger guard, serrations, safety controls, hammer, and screws. These are procedural models with a size-safety fallback; long guns use a supporting left-hand pose. They use the existing firing animation; there is no animated pump cycle or detachable-magazine reload.

Ammunition

| Recipe output | Materials | Effect |

|---|---|---|

| 20.45 ACP | 1 Copper, 2 Coal, 1 Resin | Existing pistol ammunition |

| 10 × 12 Gauge Buckshot | 1 Copper, 1 Coal | 12 pellets, 60 combined base pierce |

| 10 × 12 Gauge Dragon's Breath | 2 Copper, 2 Coal | 12 pellets, 60 pierce plus 15 fire at default quality |

| 30 × 556 | 1 Iron, 1 Copper, 2 Coal | Standard M16 rounds |

| 20 ×.45 ACP AP | 2 Copper, 2 Coal, 1 Resin | +6 pierce; 46 combined base pierce |

| 20 ×.45 ACP Hollow Point | 2 Copper, 2 Coal, 1 Resin | 40 combined base pierce +6 blunt |

| 30 × 556 AP | 2 Iron, 1 Copper, 2 Coal | +5 pierce; 33 combined base pierce |

| 30 × 556 Hollow Point | 1 Iron, 2 Copper, 2 Coal | 28 combined base pierce +5 blunt |

All.45 ACP and 12-gauge recipes use Forge 1; all 556 recipes use Forge 2. AP and hollow-point bonuses and crafting costs are configurable. AP supplies extra pierce damage using normal armor/resistance rules. Hollow points retain standard pierce and add blunt damage. Select the desired compatible ammo in your inventory. Dragon's breath adds fire equal to 25% of the final pierce damage, including weapon quality and damage modifiers. Its flying pellets have orange/yellow flame trails and fading wisps. Fire damage follows Valheim's burning and resistance rules. The new ammo icons match the existing three-cartridge, gold-outline style; shells have flat crimped tops, and dragon shells have flame markings.

One shotgun shot consumes one shell. Rifle bursts consume one cartridge per bullet through Valheim's normal ammo-selection method, preserving Epic Loot ammo conservation. An incomplete ammo stack fires only the available rounds; switching weapons or interrupting an attack can cancel the rest of a burst. Burst rounds and interval are configurable. This release uses burst fire rather than a magazine-based continuous automatic-fire system.

Installation and configuration

Import dist/EpicGuns-0.5.0.zip as a local mod in your mod manager, or extract its BepInEx directories into your profile/game folder. Replace the prior EpicGuns installation so only one EpicGuns DLL is loaded. The source ZIP is for development.

Install the same version on the server and every clien