The Magnet Weapons

The Magnet Weapons adds throwable, recallable magnetic weapons — swords, pickaxes, axes, shovels, hoes and a mace — across 7 material tiers.

Requirements

Optional Dependencies

• Ore My God (>= 1.1.0): adds the three extra tiers End Meteorite, Chang’e Jade and Doomsday Crystal. Without it these tiers and their smithing recipes simply do not appear; every other tier and all gameplay features are unaffected.

Contents

• Tools: iron, gold, diamond, netherite, end meteorite, Chang’e jade and doomsday crystal — 7 tiers x 5 tool types, plus one magnetic mace.
• Throwing: right-click while holding a tool to charge and throw it. While the magnetic link is active you can mine and attack remotely. When the link breaks, an enchantment decides whether the tool comes back.
• Magnets: meteorite magnets with red / blue polarity, which set the direction of the polarity field’s attraction and repulsion.
• Polarity field: same poles repel at close range, opposite poles attract; at least one side must be in the attached state.
• Unstable zone: a faster-mining area forms around the landing point of a thrown tool.
• Fool’s gold ore: overworld and deepslate variants, with matching drops and raw ore.

Enchantments

• Loyalty — returns the tool instantly when the link breaks; costs 80 / 60 / 35 durability by level.
• Wriggler — slides along surfaces while sprinting until it reaches the pickaxe.
• Stabilizer — a thrown pickaxe no longer breaks blocks in stable mode.
• Reach — +7% throw velocity per level.
• Impact — +10% shockwave damage per level.
• Siphon — 3% chance per level to restore 1 durability when breaking a block.
• Precision — lets shovels mine pickaxe-class blocks.
• Harvester — pickaxe / axe / hoe drops go straight into your inventory.

Compatibility Notes

• This mod’s Loyalty is a separate enchantment (themagnetweapons:loyalty). It does not override the vanilla minecraft:loyalty data, so vanilla trident Loyalty keeps working.
• An anvil-applied vanilla Loyalty book on a magnetic tool is also recognised; the code takes the higher of the two levels.
• The legacy namespaces themagnetpickaxe / magneticweapons are no longer registered. Items from those namespaces in upgraded worlds become invalid — recover or replace them first.

Installation

Drop themagnetweapons-1.0.0.jar into your mods/ folder. Required on both client and server.

Acknowledgements

Core framework implemented by cu6醋 (Bilibili content creator), originally commissioned; multi-tier expansion, throw/recall mechanics, polarity field and enchantment system by THEDIMS.

License: MIT. The copyright notice for the core framework is kept intact.