Metalbound

Metalbound is a work-in-progress metal-pushing and metal-pulling movement mod for Valheim. Detect nearby metal, lock onto an anchor, launch yourself through the world, throw recoverable coins, and fire coins as fast piercing projectiles.

WIP warning: This is an early test build. Back up important characters and worlds before using experimental mods. Multiplayer and dedicated-server behavior still need broader testing.

Features

• Faint blue lines reveal nearby metal while Metalbound mode is held.
• The aimed or locked anchor receives a brighter line.
• Push away from metal or pull yourself toward it.
• Targets remain locked while Push or Pull is held, allowing you to turn the camera in flight.
• Build pieces are detected from metal ingredients in their recipes.
• Dropped metal items and configured world prefabs can act as anchors.
• Throw a recoverable vanilla coin as a temporary anchor.
• Coins and nails launched sharply downward settle on valid ground instead of rolling, making vertical launches more dependable.
• Fired Bronze and Iron Nails stick to terrain, rocks, trees, and building pieces for the current session, creating recoverable temporary Push/Pull tethers. Their stuck state does not survive a world reload.
• Loose coins fly at a configurable fixed speed in a straight line when pushed or pulled; the instant they become braced, the held force moves the player instead. Bronze and Iron Nails use the same loose-versus-braced behavior.
• Controlled upward pushes and pulls prevent fall damage after safely arresting a descent.
• Hold Allomancy and press Space during the final 0.6 seconds before landing. The buffered input triggers a native dodge roll near the ground. Rolls reduce fall damage by 50% through 10 metres, 40% above 10 through 16 metres, and at least 30% above 16 metres with no maximum fall cutoff.
• Select Coins, Bronze Nails, or Iron Nails as Coinshot ammunition from the metal wheel.
• Fire fast, straight projectiles with configurable piercing damage: 10 for Coins, 18 for Bronze Nails, and 28 for Iron Nails by default.
• Successful Coin and Nail shots share a configurable 0.5-second cooldown by default.
• Normal attacks are suppressed while Metalbound mode is held.
• Keyboard shortcuts, movement, targeting, visuals, Coinshot, and metal-name detection are configurable.
• A persistent 120-point, character-specific metal reserve powers sight, movement, target locks, and Coinshot.
• One craftable Metallic Tincture completely restores the reserve through normal consumption or the refill shortcut.
• Toggleable, volume-controlled vanilla Valheim sound cues provide feedback for target locking, coin throwing, Coinshot, tincture use, and empty reserve.
• Procedural wind streaks grow denser, longer, brighter, and faster with Push/Pull movement speed.
• A multiplayer-safe radial metal wheel uses a tethered mouse selector to toggle accessible metals without changing game time.
• Steel must be burning to Push or fire Coinshots; Iron must be burning to Pull.
• Pewter can be burned for configurable speed, jumping, stamina, strength, resistance, carry-weight, knockback, fall-damage, and poison-resistance bonuses.
• Tin can be burned for local low-light vision, native Wishbone-style hidden-object sensing, and Mistlands fog clearing around the player. Pulsing gold sensory glows reveal hostile creatures through walls and clamp to the screen edge when off-screen; their size is configurable, and red warnings reveal incoming projectiles.
• Hold the configurable Tin Focus key for a smooth scouting zoom while Tin is burning.
• Copper can be burned to create a Coppercloud that reduces enemy detection visibility by 65% by default.
• Hold the configurable Flare key to strengthen burning metals: Iron and Steel gain force, Pewter gains stronger physical bonuses, and Tin gains stronger senses and focus at greatly increased reserve drain.
• Flaring brightens metal lines but intentionally does not increase movement-wind density.
• Burning Pewter prevents 65% of fall damage by default. A landing roll combines multiplicatively with Pewter protection.
• Iron, Steel, Pewter, Tin, and Copper have separate persistent 120-point reserves. A bar appears only while its metal is burning; holding the wheel shows every accessible reserve.
• Their matching Vials refill one reserve; an Allomantic Tincture refills all five.
• New characters begin Unawakened and have a configurable 8% chance to become an Iron, Steel, Pewter, Tin, or Copper Misting each time they die. The awakened metal persists with the character.
• Existing characters with Metalbound reserve data migrate to Mistborn and retain every ability.
• Lerasium Beads have a configurable 3% chance to appear in newly generated world chests. Consuming one kills the character and permanently awakens them as Mistborn.
• Locked metals appear unavailable on the wheel and cannot be burned, used, or refilled.

Default controls

Action	Default
Hold Metalbound mode	Left Alt
Push	Left mouse
Pull	Right mouse
Throw anchor coin	G
Fire Coinshot	Hold Metalbound mode + R
Consume Allomantic Tincture to refill all reserves	V
Hold metal wheel; click a metal arranged around the circle or ammo below it	Q
Hold Tin Focus while burning Tin	Z
Hold to flare burning metals	Caps Lock

While the wheel is open, left-click Coin, Bronze Nail, or Iron Nail to select Coinshot ammunition. Right-click Iron, Steel, Pewter, or Tin to consume its matching single-metal vial.

All shortcuts can be changed through BepInEx Configuration Manager (F1) or the generated com.keeto.valheim.metalbound.cfg file.

Installation

Thunderstore Mod Manager / r2modman

1. Download the Metalbound ZIP.
2. Open your Valheim profile.
3. Choose Settings > Import local mod.
4. Select the ZIP and launch Modded.

Manual

1. Install the current Valheim BepInEx pack and Jötunn.
2. Copy Metalbound.dll into Valheim/BepInEx/plugins/Metalbound/.
3. Launch Valheim through the modded profile or BepInEx-enabled installation.

Multiplayer

For WIP testing, install the same Metalbound version for every participating player and the dedicated server when applicable. Coin movement, damage ownership, PvP interaction, and server authority require more testing before the mod is declared multiplayer-ready.

Metal vials and tinctures

Craft the following at a level-one cauldron:

Consumable	Recipe	Output	Effect
Iron Vial	2 Iron + 2 Honey	5	Completely fills Iron reserve
Steel Vial	2 Iron + 2 Coal + 2 Honey	5	Completely fills Steel reserve
Pewter Vial	4 Tin + 1 Silver + 1 Coal + 2 Honey	5	Completely fills Pewter reserve
Tin Vial	2 Tin + 2 Honey	5	Completely fills Tin reserve
Copper Vial	2 Copper + 2 Honey	5	Completely fills Copper reserve
Allomantic Tincture	1 of each Iron, Steel, Pewter, Tin, and Copper Vial	1	Completely fills all reserves

Consume any vial normally from the inventory. Press the configurable refill shortcut for an Allomantic Tincture, or right-click a metal on the wheel to use its matching vial. Consumables are not wasted when the affected reserve is already full. They currently use a vanilla bottle appearance.

Characters created with an older Metalbound version automatically migrate missing metal reserves from their legacy reserve or configured starting value.

Allomantic awakening

Characters without earlier Metalbound progression begin Unawakened. On each genuine death, an Unawakened character has a configurable 8% chance to become one of the following permanently:

• Iron Misting (Lurcher)
• Steel Misting (Coinshot)
• Pewter Misting (Pewterarm)
• Tin Misting (Tineye)
• Copper Misting (Smoker)

Characters that already have saved Metalbound reserves are treated as legacy testers and migrate to Mistborn. A Lerasium Bead has a 3% chance to be added when an authoritative host or server generates a new world chest. Consuming the bead is fatal; that death commits permanent Mistborn status. Previously generated chests are not rerolled.

Compatibility and limitations

• Built and tested against Valheim 0.221.12 and BepInExPack Valheim 5.4.2333.
• Game updates can break runtime mods even when installation succeeds.
• Metal classification uses recipe ingredients and configurable name fragments, so unusual vanilla or modded prefabs may need an additional token in the configuration.
• Dense bases can create many metal lines. Use Maximum visible lines to control rendering cost.
• Lerasium chest generation requires Metalbound on the authoritative host or dedicated server.
• Mixed modded/unmodded sessions should not expose unmodded clients to dropped custom consumables.
• This project uses an original name and icon and is not affiliated with any book, game, author, publisher, or entertainment franchise.

Development build

Run build-package.ps1 from PowerShell to create a Release DLL and a Thunderstore-compatible ZIP under Packages/.

Feedback

When reporting a problem, include the Metalbound version, Valheim version, whether the game was single-player or multiplayer, and the relevant section of BepInEx/LogOutput.log or Player.log.