HammerThrow

Throw your great hammer like Mjolnir.

Two-handed clubs (great hammers, TwoHandedWeapon + Clubs) get a middle-mouse heavy attack: the character plays the one-handed mace heavy swing, the hammer leaves the hand a moment later, spins out toward your crosshair up to 25 m, damages everything it passes through on the way out and on the way back, then returns to your hand.

Behaviour

• Trigger: middle mouse button (ExtraKey adds a keyboard alternative).
• Animation: the one-handed mace heavy attack (mace_secondary), so the throw reads as an underhand sweep rather than the two-handed ground slam.
• Release timing: LaunchDelaySeconds (1.3 s) after the animation starts.
• Flight: outbound up to MaxRange, then it turns around; a ray along the path stops the outbound leg early when it meets terrain or a structure.
• Damage: 75% of the weapon's blunt damage (DamageMultiplier), once per target per leg, no knockback, with the hammer's ground-slam dust on every hit.
• While it is away: movement and jumping work normally, attacking is blocked (BlockAttackWhileFlying).
• Stamina: the same cost as a normal swing (scaled by StaminaMultiplier); the throw is refused when stamina is too low.
• Birds: ambient birds (RandomFlyingBird) are hit through their IDestructible.

Configuration

Notes

• Client-side damage goes through the vanilla Character.Damage path, so a dedicated server does not need the mod for the damage itself; only the flying model is local to the thrower.
• Works together with RainbowGear: the flying copy is registered so it keeps its rainbow colours.

Changelog

1.11.0

• Final tuning after in-game testing: the hammer leaves the hand a fixed LaunchDelaySeconds (1.3 s) after the throw animation starts, the model is oriented deterministically from its own grip→head axis with ModelRoll = 90, and it tumbles forward with SpinDirection = -1.
• Removed the peak-detection path from the defaults; LaunchAtPeak remains available for experiments.
• Verbose defaults to off, so the animation/item dumps no longer spam the log.

1.10.x

• Launch timing reworked (LaunchDelaySeconds, then a deterministic orientation): the roll used to depend on the pose at the moment the model was cloned, which moved when the launch was delayed.

1.9.x

• Peak-based launch, configurable spin axis (Tumble / Roll / Yaw), ModelRoll, F10 config reload, geometry logging.

1.8.0

• Head-aligned flight orientation, launch at the end of the animation.

1.7.0

• Uses the one-handed mace heavy attack (mace_secondary) instead of the two-handed slam.
• Stamina cost equal to a normal swing.

1.6.0

• Launch delay, model yaw offset.

1.5.0

• Real mace heavy-attack trigger (mace_secondary), world-space tumble axis.

1.4.0

• Diagnostics for club-class item attack triggers and animator parameters.

1.3.0

• One-handed mace animation, normal-swing stamina cost.

1.2.0

• Animation clip dump.

1.1.1

• RainbowGear integration (the flying copy keeps its colours).

1.1.0

• Fixed the phantom swing after catching the hammer.
• Hit dust effect, 25 m range, birds can be hit.

1.0.0

• First release: middle mouse throws a two-handed club like Mjolnir.