Aegisward

A configurable overhaul of the vanilla shield for Minecraft 1.20.1 (Forge).

Aegisward keeps the familiar right-click block but removes the shield's most frustrating drawbacks. Every change can be toggled in config/aegisward-common.toml, so it can be a small quality-of-life fix or a full perfect guard.

Features

• 360° blocking — attacks from behind, the sides and above are blocked
• Instant raise — no 5-tick (0.25 s) delay
• Piercing crossbow bolts and riptide tridents are blocked
• Axes and warden melee no longer disable the shield
• No knockback from melee, explosions, ravager or hoglin/zoglin while blocking
• Sonic booms, potion damage, guardian lasers, lightning and dragon breath are blocked by default
• Vanilla durability by default (attacks of 3+ damage consume durability); set shield_takes_damage = false for an unbreakable guard
• No movement slowdown while blocking (client-side; install the mod on the client too)
• Environmental damage is not blocked by default: fall, drown, void, hunger, fire/lava, cactus, sweet berries, stalagmites, falling blocks, cramming, suffocation. The list is editable
• Applies to every living entity holding a shield (affect_mobs = true), keeping PvP fair

Configuration

The config file is created at config/aegisward-common.toml; every option is documented. Changes require a game/server restart.

Installation

1. Install Forge 47.x for Minecraft 1.20.1 (Java 17).
2. Put aegisward-1.0.0-forge-1.20.1.jar into mods.
3. Launch the game; the Mods list should show Aegisward 1.0.0.

Works in singleplayer, LAN and dedicated servers. Core logic is server-side; only the "no slowdown" feature requires the mod on the client.

Compatibility

• Minecraft 1.20.1
• Forge 47.x (built against 47.4.28)
• Java 17
• Other shield overhauls (Responsive Shields, Shield Overhaul, Shield Expansion) overlap with this mod; remove them to avoid double behaviour

Notes

• Potion damage is blocked, but potion effects (poison, slowness, etc.) still apply
• Blocking is still active: hold right-click; it is not passive
• All living entities holding a shield get the same improvements by default

License & source

GNU Affero General Public License v3.0 (AGPL-3.0). Source code: https://github.com/Lin1848624/Aegisward

Aegisward（全能之盾）

Minecraft 1.20.1（Forge）原版盾牌强化模组。

保留“按住右键举盾”的原版玩法，把盾牌的限制做成可配置项：可以只修几个小毛病，也可以调成“完美格挡”。

主要功能

• 全方位格挡：背后、侧面、上方都能挡
• 零延迟：不再有 5 tick（0.25 秒）延迟
• 穿透弩箭、激流三叉戟：可挡
• 斧头 / 监守者近战：不再禁用盾牌
• 完全免击退：近战、爆炸、劫掠兽、疣猪兽/僵尸疣猪兽
• 监守者音波、药水伤害、守卫者激光、闪电、末影龙吐息：默认可挡
• 耐久默认按原版规则消耗（单次 ≥3 点伤害会扣）；把 shield_takes_damage 改成 false 可关闭
• 举盾不减速（客户端需安装）
• 环境伤害默认不挡：摔落、溺水、虚空、饥饿、火焰/岩浆、仙人掌、甜浆果丛、石笋、下落方块、挤压、窒息；列表可编辑
• 默认对所有持盾生物生效（affect_mobs = true），PvP 公平

配置

首次启动生成 config/aegisward-common.toml，所有选项都有注释；改完重启游戏/服务器生效。

安装

1. 安装 Forge 47.x（Minecraft 1.20.1），使用 Java 17。
2. 把 aegisward-1.0.0-forge-1.20.1.jar 放进 mods。
3. 启动游戏，Mods 列表应显示 Aegisward 1.0.0。

支持单人、局域网和专用服务器。核心逻辑在服务端；只有“举盾不减速”需要客户端也安装。

兼容性

• Minecraft 1.20.1
• Forge 47.x（基于 47.4.28 构建）
• Java 17
• 与 Responsive Shields、Shield Overhaul、Shield Expansion 等功能重叠，建议移除，避免重复行为

注意

• 药水伤害可挡，但药水效果（中毒、缓慢等）仍会生效
• 仍需按住右键举盾，不会变成被动格挡
• 默认对所有持盾生物生效

许可证与源码

GNU Affero General Public License v3.0（AGPL-3.0）。 源码：https://github.com/Lin1848624/Aegisward