🛡️ Auto Totem
Automatic Off-Hand Totem Swapper for Fabric
Auto Totem is a lightweight client-side utility mod that automatically moves a Totem of Undying into your off-hand when your health is critically low, and swaps it back when you recover.
A simple keybind lets you enable or disable the feature on the fly.
Supported versions: Minecraft 1.21.9 → 26.3
✨ Features
1. Health-Based Auto-Swap
When the feature is enabled:
| Condition | Action |
|---|---|
| Health ≤ 2 hearts (4.0 HP) | Instantly finds the first Totem in your inventory and moves it to the off-hand |
| Health > 5 hearts (10.0 HP) | Swaps the Totem back to the exact slot it came from |
2. Toggle Keybind
- Default key: V
- Pressing the key enables / disables the automatic swapping
- A clear status message appears on the action bar:
AutoTotem: EnabledAutoTotem: Disabled
You can change the key in
Options → Controls → Key Binds → AutoTotem
📦 Installation
- Install Fabric Loader for your Minecraft version
- Install the matching Fabric API
- Download the AutoTotem jar built for your version
- Place it in your
.minecraft/modsfolder - Launch the game with the Fabric profile
This is a client-side only mod. It does not need to be installed on the server.
Version note
Because Minecraft 26.1+ is unobfuscated (Mojang mappings) while 1.21.x used Yarn, separate builds are provided for:
- 1.21.9 – 1.21.11
- 26.1.x
- 26.2
- 26.3
Always download the jar that matches your game version.
⚙️ Configuration
Currently there is no config file.
All behaviour is controlled by the keybind and the built-in health thresholds (2 hearts / 5 hearts).
📜 Technical Details
| Item | Value |
|---|---|
| Mod ID | autototem |
| Package | com.noty.auto |
| Minecraft | 1.21.9 – 26.3 |
| Fabric Loader | ≥ 0.16 (1.21.x) / ≥ 0.19.5 (26.x) |
| Fabric API | Required (version matching your Minecraft version) |
| Java | 21 (1.21.x) · 25 (26.x) |
| License | GPL-3.0 |
🔗 Links
📄 License
This project is licensed under the GNU General Public License v3.0.
See the ) file for details.
How to Install Auto Totem-Optimized (Mod)
Auto Totem-Optimized by NotY215 is verified for Fabric across Minecraft versions 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5 (latest release: 1.5, file size: 1.9 MB). Follow the steps below to install it safely from ModCraft.tv:
- Click the Download button above and select your Minecraft version (1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5) and platform (Fabric).
- Make sure you have the compatible loader or environment installed for Fabric.
- Move the downloaded Auto Totem-Optimized file into your Minecraft
.minecraft/modsfolder and launch the game.
All Versions
+ Add Version- Minecraft 26.3**
### Changelog
- Updated to **Minecraft 26.3** (Wilderness Bound)
- Updated Gradle to **9.6.0**
- Updated Fabric Loader to **0.19.5**
- Updated Fabric API to **0.160.7+26.3**
- Updated input handling for the new SDL-based input system
InputConstants.Type.KEYBOARDInputConstants.KEY_V- Updated status message to use
sendOverlayMessage - Confirmed compatibility with 26.3 Mojang mappings
- No changes to core auto-swap logic or health thresholds
### Notes
- Client-side only
- Requires Fabric API for 26.3
- Default toggle key remains **V** (configurable in Controls)
- Health thresholds unchanged: swap in at ≤ 2 hearts, swap back at > 5 hearts
- Minecraft 26.2**
### Changelog
- Updated to **Minecraft 26.2**
- Updated Fabric Loader to
0.19.3 - Updated Fabric API to
0.158.0+26.2 - Updated Fabric Loom to
1.17-SNAPSHOT - Confirmed full compatibility with the 26.2 unobfuscated mappings
- No gameplay or logic changes — pure version update
### Notes
- Client-side only
- Requires Fabric API for 26.2
- Default toggle key remains **V** (configurable in Controls)
- Version 1.3 – Minecraft 26.1.2 Port**
- Fully updated to Minecraft **26.1.2** (unobfuscated / Mojang mappings)
- Switched to Java **25** and latest Fabric Loom / Fabric API
- Keybind (default **V**) now **toggles** the auto-swap feature on/off instead of performing a manual swap
- Clear action-bar status message when enabling or disabling
- Health-based swap logic preserved (≤ 2 hearts → swap in, > 5 hearts → swap back)
- License changed to **GPL-3.0**
- Updated README with badges and current information
Auto Totem is a simple yet essential client-side utility mod for Fabric that automatically moves a Totem of Undying into your off-hand when you need it most, based on your health or a custom keybind. Never panic-swap again!
✨ Features
This mod provides two primary ways to manage your Totems:
1. Health-Based Auto-Swap (Critical Survival)
When enabled, the mod continuously monitors your health and takes action when you are in critical danger:
Auto Swap In: If your health drops to 2 hearts (4.0 health points) or less, the mod will instantly search your inventory for the first available Totem of Undying and move it to your off-hand.
Auto Swap Back: If your health recovers to over 5.5 hearts (11.0 health points), the Totem will automatically be swapped back into the inventory slot where the original off-hand item was stored.
2. Manual Keybind Swap (Tactical Control)
The mod includes a customizable keybind for quick, manual swaps:
Keybind Action: Pressing the key will either swap a Totem into your off-hand (if one is available) or swap the existing Totem out, returning the previous item to its original inventory slot.
⚙️ Usage & Keybind Configuration
Before using the mod, you should configure your preferred key:
Start Minecraft with the mod installed.
Go to Options > Controls > Key Binds.
Scroll down to the AutoTotem category.
Change the key for "Toggle Totem Off-hand" (default is V) to your liking.
Important Notes:
Swap Back Priority: The mod remembers where the item that was displaced by the Totem came from. It will only swap back to that exact slot.
Manual Override: If you manually trigger the keybind, the automatic swap-back logic will be temporarily disabled until you either press the keybind again to swap the Totem out, or until the game state resets (e.g., player dies).
📦 Installation
This is a client-side Fabric mod and must be installed in your local Minecraft instance.
Install Fabric Loader: Ensure you have the Fabric Loader installed for Minecraft 1.21.
Download Mod: Download the latest version of AutoTotem.jar from the release page.
Move to Mods Folder: Place the downloaded .jar file into your Minecraft mods folder.
Run: Start Minecraft using the Fabric profile.
📜 Technical Details
Mod ID: autototem
Package: com.noty.auto
Development Environment: Fabric 1.21
📄 License
This mod is licensed under the MIT License.[**OUR DISCORD**](https://github.com/Pero215/AutoTotem)