Offhand Tweaks

Offhand Tweaks

Stop accidental shield blocks and misplacing torches! Offhand Tweaks is a lightweight, highly customizable Quality of Life (QoL) mod that gives you complete control over your offhand slot. Selectively disable offhand right-click interactions based on item categories, freeing up your Right Mouse Button (RMB) for interacting with the world, opening chests, or tweaking machinery without constantly unequipping your offhand item.

✨ Features

Every player can configure their own independent settings. The mod allows you to toggle offhand right-click interactions for specific categories:

• 🛡️ Shields: Disable right-click blocking. Perfect when you only want the shield for passive stats or are working with complex block interactions.
• 💡 Light Sources: Stop accidentally placing torches, lanterns, or lamps while trying to interact with blocks in front of you.
• 🍖 Food: Toggle the ability to eat food directly from your offhand.
• 🧱 Other Blocks & Items: A global toggle to restrict placing or using any other unspecified blocks and items from the offhand slot.

⚙️ How It Works (Zero Desync)

Unlike simple client-side macros or basic server-side scripts that cause annoying "ghost blocks," inventory desyncs, or jittery animations, Offhand Tweaks uses a robust Client-Server synchronization system. When you change your settings, your client immediately notifies the server via a custom network packet. This ensures that the event is gracefully canceled on both logical sides at the exact same time.

• No ghost blocks.
• No fake hand-swing animations.
• No wasted items.

🔧 Configuration & Setup

• Client-Side Config: Players can easily change their preferences through the standard Forge config menu (or by editing the config file directly).
• Multiplayer Ready: Each player on the server has their own isolated configuration. Disabling your offhand shield won't affect your friends!
• Installation: For multiplayer, this mod must be installed on BOTH the Client and the Server. In singleplayer, just drop it into your mods folder.

📦 Requirements

• Minecraft 1.20.1
• Minecraft Forge