Auto Swap

Client-side mod that automates inventory management and equipment swapping during gameplay. Detects durability loss, empty item stacks, and block-breaking actions to equip the correct items from your inventory automatically.

Client-side only — no server installation required. Works in singleplayer and on any server.

Dependencies: Fabric needs Fabric API and Architectury API. NeoForge needs Architectury API. Forge needs no additional dependencies.

Free to use in any modpack — public or private, no permission needed.

What it does

• Smart Tool Selection — continuously picks the best tool while you mine, even when moving between different block types without releasing the button.
• Keep the Tool You Picked — optionally sticks with the tool you put in your hand yourself wherever it can harvest the block: your iron pickaxe isn't swapped for a diamond one on plain stone, and after a shovel for dirt or a diamond pickaxe for obsidian, AutoSwap goes back to it. Another tool is taken only when a block needs a different kind or a higher tier.
• Only Switch From a Tool — optionally never pulls a tool out when your hand is empty or holds a block, food, or a sword, so punching never mines something by accident. Tool-to-tool switching works as usual.
• Match Silk Touch & Fortune — optionally switches only to a tool with the same Silk Touch and Fortune as the one you hold; if there is none, it keeps yours.
• Tool-Switch Blacklist — choose items that automatic tool selection should never swap away from.
• Auto Weapon on Attack — optionally draws your best sword the instant you start hitting a mob. Disable it and AutoSwap will never swap off your weapon while a mob is in your crosshair.
• Gear Replacement — automatically equips a matching tool, weapon, or armor piece when the currently equipped one breaks.
• Offhand Replenishment — refills your off-hand when the held item runs out. Add a Totem of Undying, shield, or any item via the built-in item picker or by item ID.
• Stack Refills — refills the active hotbar slot with identical blocks or torches when the current stack is depleted. A "Don't refill these items" list skips anything you add; it holds all shulker boxes by default, so placing one never pulls the next into your hand.
• Double-Jump Elytra — equips an elytra from your inventory on double jump, and swaps your chestplate back on landing.
• Elytra Take-Off Key — a key that does the same in the air (puts on the elytra, starts gliding, restores the chestplate after landing), even with double-jump elytra turned off — handy in PvP.
• Restore After Auto-Tool — restores the item you were originally holding after automatic tool selection is finished.
• Keep Tool While Sneaking — a toggle for controlling tool-switching behavior while sneaking.

Configuration

Every feature can be toggled individually through the in-game settings screen, the JSON config file, the /autoswap command, or its own keybind under Controls → AutoSwap (unbound by default).

Details

• All settings are stored locally in your game config folder.
• Keep same tool type never keeps a tool that can't harvest the block (for example, an iron pickaxe on obsidian).
• Translated into 10 languages: English, German, Spanish, French, Italian, Japanese, Korean, Portuguese (Brazil), Russian, and Chinese (Simplified).

Feedback

Please report any bugs, errors, or feature suggestions on Discord: https://discord.gg/HTkn94BXmA

More mods by Nikrecs: ElytraHUD · Shield Hider

My other mods that I recommend.