Back to mods
AutoSwap project artwork

Modrinth · Minecraft mod

AutoSwap

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.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which AutoSwap release should I use?

Updated 4 days ago
Latest stable file 1.5.2
Game version 26.3
Loader NeoForge

AutoSwap 1.5.2 targets 26.3 with NeoForge. It must be installed on the client. Do not install it on the dedicated server. All 1 required mods have matching files.

Where it goes

Is AutoSwap required on the client, server, or both?

It must be installed on the client. Do not install it on the dedicated server.

Client Required
Dedicated server Not supported
Loader for this release NeoForge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

This file is marked client-only.

What else does AutoSwap 1.5.2 need?

1.5.2. Change the file and its required mods may change too.

All 1 required mods have matching files

Install Architectury API first. We found matching files for this game-version and loader setup.

Architectury API Needed by AutoSwap 1.5.2
required
Matching file found Matched file: 22.0.2+neoforge

We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add AutoSwap without breaking your instance.

Built for AutoSwap 1.5.2. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 1.5.2. It targets 26.3 with NeoForge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    Install Architectury API first. We found matching files for this game-version and loader setup.

  3. 03

    Put it on the correct side

    It must be installed on the client. Do not install it on the dedicated server.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 1.5.2. It opens that exact file at the source.

About this project

What does AutoSwap add?

JOIN OUR DISCORD CurseForge

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.

Configuration

Client-side only (no server installation required). Fully compatible with singleplayer.
Dependencies: Fabric & NeoForge require Architectury API. Forge requires 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.
  • 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.
  • 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.

Configuration

All features are fully modular and can be toggled individually through the in-game settings screen, the config file, or via keybinds under Controls → AutoSwap.

Details

  • Client-side only.
  • All settings are stored locally in your game config folder.
  • Translated into 10 languages — English and Russian are complete; other locales are in progress.

Feedback

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

More mods by Nikrecs: Auto Torch · Swing Through Grass

Project description from Modrinth.

Pick your setup

AutoSwap by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

20 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

AutoSwap versions and loaders

100 of 100 releases match

Looking for an older file? The official Modrinth project page is in Resources.