Protect My Villager

The mod hooks the attack methods in the client and checks the entity type before an attack is sent. When the target is a villager, the attack packet is cancelled before it leaves the game, so a stray click cannot injure or kill the villager. Other entity types can still be attacked as usual.

Because the filter works entirely on the client, it can be added to any Fabric world or server without server-side changes, and players can keep using it on servers that do not run the mod. Settings are exposed through Mod Menu, where a player can adjust the options and toggle the hand swing animation that plays when attacking villagers. An option also lets a sword-type item in hand bypass the cancellation, for players who need to strike a villager on purpose.

Fabric API is required. Mod Menu is optional and only adds the configuration screen. The environment is client-side only, and the mod is released under the Creative Commons Attribution 4.0 license, so it is not open source. Files exist for 12 game versions, 1.21 – 1.21.11, with 1.2.4 for 1.21.11 as the latest Fabric file.