Auto Swap
Managing a hotbar mid-fight or deep in a mining session is one of the small frustrations that adds up fast in Minecraft. Auto Swap is a client-side add-on that handles that busywork for you, quietly equipping the right tool, weapon, or armor piece the moment you need it. Nothing about your world changes for other players, and no server-side installation is required.
What Auto Swap Does
The core idea is simple: you keep playing, and the mod keeps your inventory organized. Auto Swap watches for durability loss, empty stacks, and block-breaking actions, then equips the correct item from your inventory without you touching the number keys.
- Smart Tool Selection — continuously picks the best tool while you mine, even when you move between different block types without releasing the button.
- 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 Auto Swap 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.
- Double-Jump Elytra — equips an elytra from your inventory on double jump, and swaps your chestplate back on landing.
- 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.
Supported Versions and Loaders
Auto Swap for Minecraft ships for the major mod loaders, so you can run it on Fabric, NeoForge, or Forge depending on your setup. On Fabric and NeoForge, Architectury API is required as a dependency; the Forge build needs no additional dependencies at all. Because everything runs on the client, the mod is fully compatible with singleplayer and works on multiplayer servers without any configuration on the host side. If you play across several profiles, the foxygame.net launcher keeps each instance's copy of Auto Swap current automatically, so you never have to chase a matching build by hand.
Configuration and Customization
Every feature is modular and can be toggled individually. You can adjust behavior through the in-game settings screen, edit the config file directly, or bind keys under Controls → AutoSwap. All settings are stored locally in your game config folder, which means your preferences travel with your client rather than your world. Auto Swap is also translated into 10 languages, with English and Russian complete and other locales in progress.
Keybinds and In-Game Toggles
If you prefer quick control during play, the keybind menu lets you flip individual behaviors on and off without opening a config file. This is handy when you want Smart Tool Selection active for a mining trip but would rather handle weapon swaps yourself during a boss fight.
How to Install Auto Swap
Installation follows the standard mod workflow. First, confirm which loader your profile uses and grab the matching build. Next, place Architectury API in your mods folder if you are on Fabric or NeoForge. Then drop the Auto Swap file into the same folder and launch the game. If you want a shortcut, the foxygame.net launcher offers a one-click install path that pulls Auto Swap and its dependencies into the right profile without manual file shuffling. After launching, open the settings screen to confirm the mod loaded and tune the toggles to your liking.
Dependencies at a Glance
- Fabric — requires Architectury API
- NeoForge — requires Architectury API
- Forge — no additional dependencies
Modpack Use and Feedback
Auto Swap is free to use in any modpack, public or private, and no permission is needed to include it. That makes it an easy quality-of-life addition for pack authors who want smoother inventory handling without scripting their own solution. Bug reports, errors, and feature suggestions are welcome on the project's Discord server, and more mods from the same author include Auto Torch and Swing Through Grass.
Final Thoughts
Auto Swap removes a layer of micromanagement that most players tolerate rather than enjoy. By automating tool selection, gear replacement, offhand refills, and elytra deployment, it lets you focus on building, fighting, and exploring instead of cycling through hotbar slots. Whether you download Auto Swap for a single survival world or add it to a large modpack, the result is the same: the right item in your hand at the right moment.