SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedWeapons, items & crafting

AmmoVariants

by Onononoki · for Valheim

Adds 42 scatter, piercing and energy arrows and bolts, with tiered recipes, distinct firing sounds and gold or lightning trails. Gameplay settings are server synced. Required on the server and every client.

42Downloads
29d agoLast updated
BepInExLoaders
ThunderstoreSource

About AmmoVariants

From Thunderstore

Adds 42 scatter, piercing and energy arrows and bolts, with tiered recipes, distinct firing sounds and gold or lightning trails. Gameplay settings are server synced. Required on the server and every client.

AmmoVariants

Scatter, piercing and energy ammunition for bows and crossbows. Adds 42 variants across vanilla ammo tiers, from wood and bone to Bloodgold.

What it does

  • Scatter arrows. Five projectiles per shot, each dealing 30% of normal shot damage, with a tighter spread than scatter bolts.
  • Scatter bolts. Fourteen small pellets per shot, each dealing about 11.43% of normal shot damage, for up to 160% before armor and resistances.
  • Piercing. Starts at 110% of normal shot damage and passes through up to four creatures, losing 15% of its remaining damage after each. No distance damage loss. Stops on ground, trees, rocks and structures. Each creature is hit once per projectile.
  • Energy. Flies straight through creatures and terrain. Full shot damage becomes 85% lightning and 15% pierce, plus 15% additional fire damage that sets targets burning. All three shares are in the config. Damage falls to 25% at 200 meters, where flight ends. No creature limit or damage loss per creature. Chop and pickaxe damage are excluded from conversion.
  • Piercing and energy have an extra 0.35-meter hit radius against enemies. Piercing keeps a thin collision ray against terrain and objects.
  • Icons based on vanilla inventory sprites, native elemental flight effects and compact effects at held and dropped tips. Piercing and scatter trails match the material or element, energy keeps blue lightning. Separate bow and crossbow firing sounds retain the original weapon mechanism.
  • Optional material-colored trails for existing ballista bolts. Trail size follows the larger bolt. Ballista damage, targeting, flight and ammo use stay unchanged.

Scatter scales the complete weapon and ammo damage, including elemental damage. Bow draw strength and the weapon's original accuracy still apply.

Crafting

| Type | Ingredients | Output | Station | |---|---|---|---| | Scatter | 20 base ammo and a finishing material | 10 | Base ammo station and level | | Piercing | 20 base ammo and a reinforcing material | 20 | Base ammo station and level | | Energy | 20 Carapace or Bloodgold ammo and 5 refined Eitr | 10 | Black Forge |

Scatter and piercing cover thirteen arrow types and six bolt tiers. Extra materials follow the ammo tier, such as resin, coal, flint, metals or carapace. Energy is available for Carapace and Bloodgold arrows and bolts. Recipes unlock through normal ingredient discovery.

Config

The file is BepInEx/config/com.onononoki.ammovariants.cfg. Gameplay and recipe settings are synced from the server. Visual and sound settings are each player's own.

| Setting | Default | What it does | |---|---|---| | Scatter.BowPellets, Pellets | 5, 14 | Bow and crossbow projectile counts | | Scatter.BowConeHalfAngle, ConeHalfAngle | 4, 6 degrees | Bow and crossbow spread half-angles | | Scatter.BowDamageShare, CrossbowDamageShare | 0.30, 0.1142857 | Damage per projectile relative to a normal shot | | Piercing.DamageShare | 1.10 | Initial combat damage relative to a normal shot | | Piercing.MaxCreatures, LossPerCreature | 4, 0.15 | Creature limit and damage loss per creature | | Piercing.EnemyRadius, Energy.EnemyRadius | 0.35 meters | Extra radius against enemies | | Energy.Range, DamageAtRange | 200 meters, 0.25 | End range and remaining damage share | | Audio.FiringSoundVolume, NativeReleaseVolume | 1, 0.30 | Added firing sound and original weapon release volume | | Trails.Scatter, Piercing, Energy, Ballista | true | Enable each custom flight trail separately, requires restart | | Recipes.UnlockAllRecipes | false | Bypass normal recipe discovery | | Debug.LogCounters | false | Troubleshooting logs |

Existing configs retain their saved values. For the release balance, set Scatter.Pellets to 14, Scatter.CrossbowDamageShare to 0.1142857 and Piercing.MaxCreatures to 4.

Crafting amounts and materials are configurable. Recipe changes apply during play. Restart after changing prefab visuals or the original weapon release volume.

Trail switches affect custom flight lines and energy flight lightning. Native elemental particles and effects at held or dropped tips remain.

Installation and compatibility

  • Use a mod manager, or put AmmoVariants.dll into BepInEx/plugins. Requires BepInExPack Valheim and Jotunn.
  • Install the same version on the server and every player.
  • BetterArchery is optional. Its drawing, aiming, velocity changes and quivers remain active. Its arrow recovery is disabled for AmmoVariants ammunition. Energy ammo flies without gravity, so aim offsets from BetterArchery or other mods are ignored for it and it flies straight at the crosshair. Ordinary ammo keeps its usual BetterArchery behavior.
  • Secondary volleys from BowSecondaryMultishot do not receive AmmoVariants effects. ProjectileTweaks combinations have not been playtested.

Feedback and bug reports

Report problems on GitHub. Include the mod version, ammo type, weapon mods and relevant BepInEx log lines.

Highlights

From source data

Loaders

Runs on BepInEx.

Footprint

Rated a light load on a server.

Last update

Its author last shipped an update 29d ago.

AmmoVariants on Nxeon

From our catalogue
One-click install
Supported on Nxeon Valheim servers, for BepInEx servers. We download it from Thunderstore, place it, and restart the server.
Server side
Optional on the server
Server type needed
BepInEx
Server load
light
Smallest plan we suggest
Valheim — 2 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
Latest build
1.0.0, released 2026-10-23

Game versions by loader

LoaderGame versionsNewest
BepInEx

From 1 recorded build of AmmoVariants.

Dependencies

Declared by the newest build that lists any. Required ones are installed with it on one-click installs.

Run AmmoVariants on a Valheim server

Pick a server or deploy a new one above; it is installed in one click.

What kind of mod it is

From the catalog
Listed on Thunderstore as “Content”

Weapons, items & crafting

New weapons, gear, items and the recipes to make them.

Works on a server

From source side support

Thunderstore lists server-side support for AmmoVariants as optional: it can run on a server, but isn’t required there.

Compatibility

Game
Valheim
Loaders
BepInEx
Runs on
Serveroptional on the server
Requires
One-click install needs a BepInEx server.

Verified at the source

  • ✓ThunderstoreOfficial listing, checked 2026-10-24Open ↗
  • ✓AuthorOnononoki, as published on Thunderstore
  • ✓LicenseNot published by the sourceFree

AmmoVariants, answered

Generated from the mod’s own source data.

Do my players need to install AmmoVariants?

Thunderstore lists server-side support for AmmoVariants as optional: it can run on a server, but isn’t required there.

Which loaders does it support?

BepInEx.

Is it free?

Yes. AmmoVariants is free to download from Thunderstore.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run AmmoVariants on a Valheim server.

Deploy in about a minute from $6.50 a month, then add AmmoVariants in one click.