Neobotics-MaxAxe icon

MaxAxe

Throw axes, knives, maces, swords, stones, flaming torches, shields, and tankards. Stack throwable weapons. Have Frostner return when thrown.

Last updated 2 weeks ago
Total downloads 3968
Total rating 2 
Categories Client-side
Dependency string Neobotics-MaxAxe-0.2.0
Dependants 6 other mods depend on this mod

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.1900 icon
denikson-BepInExPack_Valheim

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

Preferred version: 5.4.1900

README

MaxAxe (Throw Things)

Throw Axes, Knives, Maces, Swords, Flaming Torches, Stones, Shields & Tankards. Stack throwing weapons. Frostner returns when thrown!

  • Ever wonder why a Viking's axe (of all things) wouldn't be a weapon of choice? And why you couldn't throw them?
  • Throw Axes, Clubs, Torches, Swords, Knives, and Maces
  • Channel the spirit of Mjolnir; throw Frostner and have it return!
  • Throw Shields! Unsling your round shield and send it spinning at your enemy like Cap.
  • Throw Stones! Whack a Greyling, annoy a Troll, send feathers flying, be a Hobbit.
  • Throw Tankards! Toast your friends, throw back a cold one, then throw your mug.
  • Adds Axe secondary attack on par with other weapons with strong secondary attacks, like maces and swords.
  • Toggle between melee and throwing attacks with a key press.
  • Optionally stack throwable weapons; up to 3 Axes, Clubs or Maces, a 'quiver' of 5 Spears, and a 'sheath' of 10 Knives per slot. (see Caution below)
  • Has a weapon 'finder' to help locate thrown weapons.
  • MaxAxe can automatically equip a backup weapon so you're never fumbling to find another weapon in combat.

New

  • 0.2.0 Frostner can return to you after throwing (alpha release). See Notes.

  • 0.2.0 Patch to (hopefully) resolve issue with some people reporting intermittent "item spam" when throwing. See Notes.

  • 0.1.10 Moved stack text in front of durability bar with configurable text color

  • 0.1.10 Removed "flashing" throwing status when unarmed

  • 0.1.10 Fixed bug keeping recycling mods from recycling non-weapon stacked items, e.g., nails

  • 0.1.10 Tweaked Axe secondary melee speed and damage (removed windup 'hitch' and slightly reduced damage)

  • 0.1.9 Added throwing round shields. Hurl your shield and send it spinning. Overhand or underhand.

  • 0.1.9 Added configuration for throwing Swords.

  • 0.1.9 Added throwing Tankards.

  • 0.1.9 Throw (or change throwing status) while moving.

Configuration

General

  • MeleeAttack: If True, uses the melee secondary attack. Toggle in-game using the ToggleMeleeAttack key.
  • ToggleMeleeAttack: Press this key to toggle in-game between Throw and Melee mode for secondary attacks on enabled one-handed weapons. Default is LeftAlt+B.
  • ThrowOne: Press this key (even in melee mode) to throw the currently equipped weapon (if throwable). Default is T.
  • ThrowShield: Press this key to throw your currently equipped round shield. Default is G.
  • EnableAxes: Set to True to enable secondary melee and throwing attacks for one-handed axes.
  • EnableSpears: Set to True to enable secondary melee attack for spears.
  • EnableKnives: Set to True to enable secondary throwing attack for knives.
  • EnableSwords: Set to True to enable secondary throwing attack for swords.
  • MjolnirMode: Set to True to have Frostner return to your hand after throwing. Default is False.
  • EnableClubs: Set to True to enable secondary throwing attacks for clubs, including maces, Frostner, torches, stones & tankards.
  • EnableShields: Set to true to enable hurling your round shield with the ThrowShield key. Your shield must be equipped.
  • UnderhandShield: Set to True to throw your shield using an underhand throw. Shields must also be enabled. Default is False.
  • WeaponStones: Set to True to equip and attack with stones. Clubs must also be enabled. Can't be changed in-game.
  • StackableWeapons: Set to True to allow throwable weapons to stack. See Stackable Weapons below before enabling.
  • AutoMelee: Set to True to automatically switch to melee mode after weapon is thrown (or to prevent throwing the last weapon in a stack).
  • AutoEquip: Set to True to automatically equip another weapon after a throw. Will try to find the same weapon in inventory first.
  • TargetAdjustment: Adjusts the vertical throwing impact point in relation to the target reticle (the +). Default is -7. Valnilla Valheim is 0.
  • WeaponFinder: Type of 'locator' effect added to thrown weapon to make it easier to find. Can be 'Wishbone', 'Autopick' or 'None'. Default is Wishbone.

Utility

  • LogLevel: Controls the level of information in the log.
  • ItemAmountColor: Color of item quantity text in hotbar and inventory. Default is yellow (FFEB04FF). Active only when StackableWeapons is true.
  • ForceSimpleTrail: Forces MaxAxe to use the "simple" trail of version 0.1.8, that may help resolve the "item spam" issue reported by some users in 0.1.10. See Notes.

In-game reconfiguration

You can use Configuration Manager (or similar) mod to change the configuration without exiting the game. You can force a configuration update from the chat window (press Enter) then type:

/maxaxe config

You can also change most settings using this syntax:

/maxaxe [setting]=[value] , i.e., /maxaxe enableaxes=true

Stackable Weapons

READ BEFORE ENABLING STACKABLE WEAPONS

If you set StackableWeapons to 'true', one-handed axes, knives, clubs and spears will stack - in both player and chest inventory.

If you have stacked weapons in your player inventory, you will not be able to turn StackableWeapons 'off' in-game.

Split weapon stacks into individual weapons before you disable StackableWeapons or uninstall MaxAxe

If you have turned off StackableWeapons outside of the game by modifying the configuration file, but still have stacked weapons in your player inventory or nearby chests, MaxAxe will automatically turn StackableWeapons back on, so you don't lose the stacks. Unstack these items before turning off StackableWeapons. The log file will contain a warning indicating which weapon stack was found (but not which chest, if the stack is in a chest)

If you have uninstalled MaxAxe and restarted the game but had stacked weapons in chests, you may still be able to re-install MaxAxe and retrieve the stacked weapons. If the stack was in player inventory, you will need to exit the game, re-install MaxAxe, and copy the player backup (yourCharacter.fch.old) to the current character file before restarting the game again.

Durability With release 0.1.6 stacks of weapons will have durability applied to each weapon in the stack separately (virtually). The durability bar will decrease on the weapon until it breaks. The broken weapon will be removed from the stack, and placed in a separate slot. The durability bar on the 'next' weapon in the stack will be 'full'. If additional weapons of the same type/level break, they will be stacked with existing broken weapons of the same type/level. NOTE If no slot is available for the broken weapon, it will be dropped (but a weapon finder will be added).

When stacking weapons, the following applies:

  • You can split stacks, but the split stack will have the same durability as the source stack.
  • You cannot merge broken weapons into a stack with durability.
  • You cannot merge durable weapons into a broken stack (prevents accidentally 'breaking' good weapons)
  • You can merge durable weapons into a stack with different durability, but the merged stack will use the durability of the lesser.
  • You can merge broken weapons of the same type/level together.
  • If you pick up multiple thrown weapons, the stack will use the durability of the least durable weapon, i.e., the 'current' weapon will be the least durable.

Compatibility issues & defects

  • StackableWeapons is not compatible with Epic Loot. If you turn on stackable weapons with Epic Loot, EpicLoot will not be able to create/drop magical One Handed weapons. Existing weapons will continue to work.

  • StackableWeapons may not be compatible with custom one-handed weapon prefabs. Prefabs loaded after weapon stack sizes are adjusted will not stack.

  • If you're using DualWield with StackableWeapons and throw your weapon then pick it up, your weapon will be added to the stack and not re-equipped. You'll need to split the stack into two in order to re-equip your off-hand weapon.

  • If you find a compatibility issue you can post it on NexusMods. Be sure to include the mod name and version you think may be incompatible.

  • If you have a bug please report it on NexusMods. If you do post a bug report, please make sure to include the following:

    • Your version of this mod
    • What you were doing, or attempting to do when it happened
    • If it's repeatable - i.e., can you duplicate it?
    • The exact behavior you observed (or didn't observe)
    • If possible, a capture of the log file with errors (errors always begin with this mod's name)

Notes

  • MjolnirMode is rather OP, but it's intended for fun, not roleplay. It only works with Frostner (it's magic, after all). Note that this is still in "alpha" testing. Report issues on Nexus.

    • Try not to throw Frostner into deep water. If you do, you may need to move closer before it returns, and it may take a little time.
  • In release 0.1.10 several users have reported "item spam" intermittently when throwing weapons.

    • I have been unable to reproduce this, and determine root cause, therefore unable to resolve with certainty.
    • It's likely this has something to do with the change to the weapon trail introduced in 0.1.9, so I've added additional error checking and handling.
    • If any errors encountered in adding the trail are detected, MaxAxe will use the old 'simple' trail of 0.1.8
    • This may still be a compatibility issue, so there is a "Utility" switch, "ForceSimpleTrail" that may help if you are still encountering the issue.
  • You cannot upgrade weapons in a stack. Unstack a weapon before upgrading.

  • Torches will remain lit for a short time after being thrown. Toss into dark areas for a bit of light!

  • The spear secondary melee attack uses a powerful spear 'thrust'. Unfortunately the spear is pointed in the wrong direction(!), so this is done with the spear's butt, and therefore delivers Blunt damage!

  • Weapon finders are not persisted between sessions. If you don't pick up a weapon and log off, it will no longer display a finder.

  • Stones are not recoverable. Just pick up another one.

  • Shields deliver attack damage equivalent to their Block damage, but do not factor in Blocking skill to the damage.

  • Thrown (and melee) tankard attacks don't require mead in your inventory.

  • If StackableWeapons is true, all stacked items amount text will appear in the color configured by ItemAmountColor

  • Sorry, but throwing weapon trails and shield rotation/decoration in flight are not visible to other players

  • Shameless plugs for other mods (mirror on Thunderstore):

  • Your comments and feedback are always welcome. Please feel free to post or send a note on NexusMods.

Available versions

Please note that the install buttons only work if you have compatible client software installed, such as the Thunderstore Mod Manager. Otherwise use the zip download links instead.

Upload date Version number Downloads Download link  
2022-8-2 0.2.0 418 Version 0.2.0 Install
2022-7-8 0.1.10 680 Version 0.1.10 Install
2022-6-30 0.1.9 298 Version 0.1.9 Install
2022-6-14 0.1.8 472 Version 0.1.8 Install
2022-6-7 0.1.7 322 Version 0.1.7 Install
2022-5-28 0.1.6 364 Version 0.1.6 Install
2022-5-15 0.1.5 390 Version 0.1.5 Install
2022-5-15 0.1.4 152 Version 0.1.4 Install
2022-5-5 0.1.3 338 Version 0.1.3 Install
2022-3-21 0.1.2 444 Version 0.1.2 Install
2022-3-21 0.1.1 28 Version 0.1.1 Install
2022-3-20 0.1.0 62 Version 0.1.0 Install