Responsive Shields Mod Wiki

Responsive Shields is a lightweight utility mod designed to fix one of the most common frustrations in Minecraft combat: the shield delay. In vanilla Minecraft, there is a hardcoded delay of 5 ticks (approximately 0.25 seconds) between the moment a player right-clicks to raise their shield and the moment the game actually registers the block. This often leads to situations where a player visually sees their shield up but still takes full damage from projectiles or melee attacks.

This mod provides a configurable solution, allowing players to reduce this delay to zero for instant blocking or adjust it to a custom value that suits their gameplay style. It is particularly popular in adventure modpacks and high-energy combat scenarios where "clutch" blocks are essential for survival.

The mod functions by injecting code into the game's internal blocking logic. Specifically, it targets the LivingEntity class and the isBlocking method.

Vanilla Logic

In the standard game, Minecraft tracks a 'use time' for items. When you hold the use button (right-click), the game stores a base use time and decrements it every tick. The game only considers an attack 'blocked' if the following condition is met:

return item.getUseDuration(this.useItem) - this.useItemRemaining >= 5;

This means the shield must have been active for at least 5 ticks before it functions.

Modded Logic

Responsive Shields uses a Mixin to replace the constant value of 5 with a dynamic variable pulled from the mod's configuration file. By changing this value to 0, the shield becomes active the exact millisecond the player begins the 'use' action.

The mod is highly customizable through its configuration file, located at .minecraft/config/responsive-shields.toml. Changes to this file allow players to balance responsiveness against game difficulty.

Configuration Details

• Raise Time (0): Shields block instantly. This is the recommended setting for fast-paced combat and adventure packs.
• Raise Time (1-2): A middle ground. Since the client-side animation takes roughly one tick, this feels responsive while preventing "block-hitting" from being too exploitative.
• Raise Time (5): This effectively restores vanilla behavior while keeping the mod installed.

Adjusting the shield delay significantly alters the flow of combat in several ways:

• Reactionary Defense: Players can react to incoming projectiles (like Skeleton arrows) or sudden Creeper ignitions in real-time. In vanilla, you often have to predict the attack 0.25 seconds in advance.
• Clutch Moments: Allows for high-skill plays where a shield is raised at the last possible moment to negate a lethal blow.
• Modded Compatibility: The mod is designed to work with any item that uses the standard Minecraft blocking system. This includes modded shields from other equipment or weapon mods, ensuring a consistent combat experience across different content packs.
• Multiplayer Usage: While the mod is most effective when installed on both the client and server, it can be used in various configurations to improve the feel of local combat prediction.

Responsive Shields is built using the Mixin framework, which allows it to modify the game's bytecode at runtime without overwriting core files. This ensures high compatibility with other mods that modify combat or entities.

Key Technical Features:

• Lightweight: The mod has a negligible impact on performance as it only changes a single integer comparison in the blocking logic.
• Server-Side Logic: Because damage calculation is handled by the server, the mod must be installed on the server for the reduced delay to apply to actual damage taken. If installed only on the client, the animation may appear faster, but the server may still register damage during the 5-tick window.