AutoSwitch Mod — Guide

Combat and Entities

AutoSwitch optimizes combat by selecting weapons based on the target's entity group and the enchantments available on your weapons. This ensures maximum damage per hit.

Entity Group Priorities

The mod recognizes specific Minecraft entity groups and applies the following logic:

If no specialized enchantment is found, the mod defaults to the weapon with the highest base damage or DPS (Damage Per Second). In combat scenarios, the switchback delay is synchronized with the weapon's attack speed to ensure the player does not lose damage potential by switching too early.

Core Mechanics

The fundamental behavior of AutoSwitch is governed by a selection hierarchy that prioritizes efficiency and item safety.

Tool Selection Logic

When an action is initiated, the mod scans the player's hotbar for a tool that satisfies the following conditions: * Durability Safety: By default, the mod will not select a tool with 5 or fewer durability remaining. This threshold is fully configurable to prevent accidental breakage of high-value gear. * Hotbar Presence: Only items currently on the active hotbar are eligible for automatic swapping. * Mining Capability: For blocks, the tool must be technically capable of harvesting the block (e.g., a pickaxe for ore, an axe for wood). * Efficiency Rating: If multiple valid tools are found, the mod selects the one with the highest mining speed or damage output.

Switchback Mechanic

One of the mod's most powerful features is the Switchback system. Once enabled, AutoSwitch will remember the item you were holding before the swap. As soon as the interaction ends (when the hand-swinging animation stops and, in combat, when the attack cooldown has passed), the mod automatically returns the player to their original hotbar slot. This allows for a seamless experience where the player can hold a torch or building block while mining, only switching to a pickaxe for the duration of the break.

Block Interaction

When attacking or interacting with a block, AutoSwitch evaluates the block's material and matches it against the player's inventory. The mod uses Material Configuration to determine the best tool for every block type.

Advanced Block Logic

• Silk Touch & Fortune: AutoSwitch can be configured to recognize specific blocks that require Silk Touch (like Grass Blocks or Glass) or Fortune (like Diamond Ore). It will prioritize tools with these enchantments when interacting with the respective blocks.
• Creative Mode: Switching can be toggled independently for Creative mode to prevent unwanted swaps while building.