Mobs Use Shields

Mobs Use Shields

This mod allows certain mobs to actively use shields in combat instead of only holding them as equipment.

When a compatible mob equips a shield in its offhand, it gains AI behavior that allows it to raise the shield to block incoming attacks, creating short defensive windows before returning to normal combat.

The design goal is to make shield usage feel like a natural extension of vanilla combat, adding defensive moments without turning mobs into permanent blockers.

---

Features

• Mobs can raise shields to block attacks
• Shielding has a configurable duration and cooldown
• Mobs face their target while blocking
• Shield blocks play proper shield sound effects
• Knockback from blocked hits is reduced
• Humanoid mobs display the correct blocking animation
• Mobs can anticipate certain threats and raise shields preemptively
• Axes can disable mob shields, similar to player shield interactions
• By default, only Husk, Zombie, Vindicator and Wither Skeleton would have a chance to spawn with a shield.
• Users can customize which mobs may spawn with shields
• Users can adjust per-mob shield behavior through data-driven configs

---

General Configuration

Several global behaviors can be configured:

• mobConsumeShieldDurability Whether mobs consume shield durability when blocking.

• mobAlwaysAnticipate Forces mobs to always use anticipation logic. If set to false, anticipation logic only activates when local difficulty × recent HP loss exceeds a random threshold.

---

Entity Tag Configuration

You may add entity types that you do not want to be affected by this mod to the mobsuseshields:disable_shield tag. This disables the mod's shield behavior injection for those entities.

This is useful for preventing AI conflicts with mobs that already have their own shield-using goals, such as Guard Villagers.

Data Pack Configuration

This mod supports data-driven mob shield configs through JSON files.

Example: https://www.curseforge.com/minecraft/data-packs/mobs-use-shield-expansion

You can define:

• whether a mob may spawn with a shield
• the chance that it spawns with one
• the minimum local difficulty required
• which shield item it uses
• how long it keeps blocking
• how long its shield cooldown lasts
• how often it checks whether it should continue blocking

Folder Structure

Place your JSON files under:

data/<namespace>/mob_shield/<path>.json

Examples:

data/minecraft/mob_shield/zombie.json
data/minecraft/mob_shield/piglin.json
data/yourmod/mob_shield/custom_mob.json

These files are resolved by path into entity-type-style ids. For example:

data/minecraft/mob_shield/zombie.json   -> minecraft:zombie
data/yourmod/mob_shield/foo/bar.json    -> yourmod:foo/bar

In practice, this means the file path should match the mob id you want to configure.

Example JSON

{
  "use_duration": 60,
  "cooldown_duration": 60,
  "check_continue_to_use_interval": 30,
  "shield_id": "minecraft:shield",
  "shield_stack": "{id:\"minecraft:shield\",count:1}",
  "chance": 0.15,
  "min_difficulty": 2.25
}

Field Description

• use_duration How long the mob keeps actively using the shield.

• cooldown_duration How long the mob waits before it can use the shield again.

• check_continue_to_use_interval How often the mob checks whether it should continue blocking.

• shield_id The item id of the shield to equip when the mob spawns with one. If shield_stack is not provided, invalid, or results in an empty item stack, the mod uses this item id as the fallback shield item. If the item is missing or invalid, the mod falls back to minecraft:shield.

• shield_stack Optional full ItemStack SNBT string used to define the exact shield stack equipped by the mob. This allows custom NBT/component data such as banner patterns, names, damage, or other item data supported by the current Minecraft version. If this field is present and can be parsed into a non-empty ItemStack, it takes priority over shield_id.

• chance The spawn chance for that mob to receive a shield in its offhand.

• min_difficulty Minimum local difficulty required before the mob may spawn with a shield.

Notes About Local Difficulty

min_difficulty uses Minecraft's effective local difficulty, not just the selected world difficulty setting.

For reference:

• The raw regional difficulty is always 0.0 on Peaceful and ranges from 0.75 to 1.5 on Easy, 1.5 to 4.0 on Normal, and 2.25 to 6.75 on Hard. (ref: Minecraft Wiki)
• lower values allow shield spawning earlier or under easier conditions
• higher values make shielded spawns rarer and more progression-sensitive

---

Compatibility

Vanilla shield interactions remain unchanged.

• For example, Hoglins and Ravagers still interact with shields using their vanilla mechanics.

Fresh Animations / EMF

• Proper blocking poses can be displayed with Fresh Animations.
• This mod overwrites entity arm poses in the EMF render pipeline while shields are being used.

Spartan Weaponry

• Weapons with the Shield Breach trait can disable mob shields, similar to vanilla axes.

---

Notes

Shield behavior is designed around vanilla-style combat flow, with Zombies serving as the primary reference for timing and pacing.

Because different mobs use different vanilla AI structures, some variation in behavior is expected. Compatibility improvements and edge-case fixes may still be added over time.

If you encounter mobs with unusually broken or inconsistent shield behavior, feel free to report them.

---

Support

If you'd like to support my modding work, including maintenance, updates, and compatibility work, Patreon is available here: https://patreon.com/vomiter_scp