AirSwap

Air Swap

Minecraft 1.21.11 | Fabric | Client-side

Air Swap automatically switches your sword or spear to a mace before a qualifying airborne attack. It searches your hotbar for a mace and can optionally switch back to your original weapon afterward.

The mod features customizable combat conditions, live JSON configuration, a toggle keybind, and an optional in-game settings screen powered by YACL and integrated with Mod Menu.

⚠️ Public Server Warning

Air Swap automates combat input and may violate public-server rules. Automatic weapon switching and attribute-swap techniques can result in anti-cheat flags, kicks, temporary suspensions, or permanent bans.

• Use it in single-player or on private servers with the owner's explicit permission.

• Check server rules and ask staff before connecting with the mod enabled.

• The mod does not bypass anti-cheat, hide itself, or guarantee server acceptance.

• No claim of being undetectable, ban-safe, or universally compatible with multiplayer servers is made.

✨ Features

• Automatic swapping: Switch to a mace before qualifying airborne attacks.

• Swap-back: Optionally restore your original weapon after the attack.

• Customizable conditions: Configure fall distance, cooldown, target filtering, sneaking restrictions, and Elytra behavior.

• Sword and spear support: Recognizes vanilla and properly tagged modded weapons.

• Main-inventory mode: Optionally search your main inventory when no hotbar mace is available.

• In-game configuration: Adjust settings through Mod Menu and YACL.

• Live JSON configuration: Edit settings without restarting or rejoining.

• Toggle keybind: Enable or disable the mod quickly.

⚔️ How It Works

Air Swap changes the selected hotbar slot inside the same client attack call, before vanilla synchronizes the selected slot and sends the attack packet.

This does not guarantee a mace smash or combined weapon attributes. The server controls damage calculations, attack cooldowns, fall-distance validation, smash eligibility, inventory validation, and packet processing.

An airborne attack while rising or gliding does not automatically qualify as a smash. Lag, server plugins, anti-cheat, and other combat mods can affect the outcome.

Air Swap does not modify damage packets, fabricate fall distance, change weapon statistics, or add server-side combat logic.

📥 Installation

1. Install Minecraft 1.21.11.

2. Install Fabric Loader 0.19.2 or newer.

3. Install Fabric API for Minecraft 1.21.11.

4. Place the Air Swap JAR in your client's mods folder.

5. Launch the game.

For the in-game configuration screen, also install compatible versions of Mod Menu and YACL.

Both are optional. Without them, Air Swap still works through its JSON configuration and toggle keybind. Mod Menu without YACL does not provide the configuration screen.

Do not install Air Swap on a dedicated server.

🎮 Usage

1. Obtain a sword or spear and a mace.

2. Place them in your hotbar.

3. Hold your sword or spear.

4. While airborne, attack only in a world where you have permission to test the mod.

5. Air Swap selects the first eligible mace in hotbar slots 1–9 before the attack.

By default, the player must be airborne, not climbing or touching water or lava, and meet the configured activation conditions. Elytra gliding is allowed by default.

If no eligible mace is available or a condition fails, the attack proceeds normally.

Toggle Key

Open Options → Controls → Key Binds → Miscellaneous → Toggle Air Swap and assign a key.

The key is unbound by default. Pressing it toggles the mod, saves the setting, and displays an action-bar message. New configurations start enabled.

Configuration Screen

With Mod Menu and YACL installed, open:

Mods → Air Swap → Config

Changes update the live configuration without restarting. The screen supports tooltips, adjustable sliders, saving, and resetting to defaults.

⚙️ Configuration

The JSON file is located at:

config/airswap.json

Available settings include:

Setting	Default
Enable mod	On
Swap back	On
Swap-back delay	0 ticks
Players only	On
Minimum fall distance	0.0 blocks
Allow spear attacks	On
Allow Elytra gliding	On
Recognize all tagged swords	On
Hotbar-only mace search	On
Show swap message	Off
Disable while sneaking	Off
Swap cooldown	0 ticks

Swap-back delay supports 0–10 client ticks, minimum fall distance supports 0.0–10.0 blocks, and swap cooldown supports 0–20 client ticks.

Configuration changes are checked every 20 client ticks. Invalid settings fall back to defaults, while malformed JSON preserves the last valid in-memory configuration and logs a warning.

Edit the JSON file with the settings screen closed to avoid conflicting changes.

🔄 Important Behavior

• Manual hotbar changes cancel pending automatic returns.

• Opening a screen cancels a pending return to prevent unexpected inventory interactions.

• Repeated attacks do not replace an existing pending return.

• Inventory exchanges are conditional and may be rejected or corrected by the server.

• Joining or disconnecting clears pending returns and the mod's swap cooldown.

• Vanilla attack behavior and attack cooldowns are preserved.

🛠️ Technical Information

• Minecraft: 1.21.11

• Loader: Fabric 0.19.2+

• Java: 21

• Yarn: 1.21.11+build.5

• Fabric API: 0.141.4+1.21.11

• Fabric Loom: 1.14

The project uses client-side mixins to handle attack timing, slot synchronization, and manual selection changes. Mod Menu and YACL are optional compile-time integrations, not bundled inside the Air Swap JAR.

🔧 Compatibility

Air Swap specifically targets Fabric 1.21.11 with Yarn mappings. It is not a Forge/NeoForge mod or a server plugin, and compatibility with other Minecraft versions is not guaranteed.

Mods that alter attacks, hotbar behavior, or inventory synchronization may affect its functionality.

Always test in a permitted private world, and never assume a client-side swap was accepted by the server.