Auto Swap

Automatic tool, weapon, armor and totem swapping — equips the right item, auto-replaces broken gear, refills depleted stacks, and deploys your elytra on a double jump. Fully client-side.
item image
item image

Description

JOIN OUR DISCORD MODRINTH

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.

Auto Swap Team

profile avatar
Owner
Rising Builder tier icon
  • 11
    Followers
  • 44
    Projects
  • 758.2K
    Downloads

I help build the community

More from NikrecsView all