Villager Guard Gunners 1.2

Sidearms, squads, field commands, Village Armories, and expanded natural loadouts for Minecraft 1.20.1 Forge.

Added in 1.2

• Automatic sidearms
  Guards now have a dedicated slot for an eligible non-explosive pistol. A guard can switch to it when its primary is confirmed dry, when its orders prohibit an explosive primary, or when a target is inside that weapon's safe blast distance.
  
  
• Sidearm-aware ammunition logistics
  Manual ammunition handoff, passive dropped-ammo pickup, emergency sharing, reserve protection, and operator diagnostics now understand both the configured primary and sidearm.
  
  
• Natural-loadout format 3
  Datapack authors can opt individual entries into an eligible pistol sidearm. This gives the primary and sidearm one full compatible ammunition stack each, while invalid definitions or insufficient space leave the guard unchanged.
  
  
• Stable guard squads
  A craftable, reusable Squad Command Ledger creates named squads and assigns authorized guards without replacing their equipment, ownership, patrol, or persistent per-guard orders.
  
  
• Temporary field commands
  Squads can receive Rally, Defend, Hold, Focus Target, Fall Back, and Resume Orders commands. Commands affect only bounded nearby loaded members and never bypass rules of engagement, ally protection, explosive safety, or TaCZ weapon state.
  
  
• Village Armory
  Added a craftable nine-slot ammunition-only storage block with a compact screen, hopper and Forge item-pipe support, comparator output, persistent contents, safe drops, and optional Squad Command Ledger association. Automatic guard travel and withdrawal are not included in 1.2.
  
  
• Squad registry maintenance
  Added permission-gated /vgg squads list and /vgg squads unregister commands for inspecting and reclaiming abandoned squad metadata.
  
  

Improved in 1.2

• Sidearm swaps preserve the complete TaCZ weapon stack, including magazine, chamber, attachments, fire mode, durability, and other weapon data.
  
  
• Sidearm, squad-command, and Armory behavior is server-authoritative, bounded, cache-backed, and event-driven. Commands do not force chunks, and Village Armories do not use a block-entity ticker.
  
  
• The guard inventory now exposes the authorized sidearm slot and a visible Recover Weapons action for contradictory or unreadable stored-weapon states.
  
  

Fixed in 1.2

• Natural loadout assignment now waits until Guard Villagers finishes its native starting-equipment pass, fixing structure guards that tracked enemies but spawned without the configured TaCZ weapon.
  
  
• Fixed sidearm rollback, save/load, death, conversion, shield, target-change, external weapon-replacement, and both-weapons-dry edge cases so failures preserve equipment or enter explicit recovery instead of silently losing or overwriting a weapon.
  
  
• Fixed stale squad commands when membership changes, unsafe Focus Target retention, damaged Armory lock persistence, and Armory menus remaining open after their block was replaced.
  
  

Required Dependencies

• Minecraft 1.20.1
• Forge 47.4.23
• Guard Villagers 1.20.1-1.6.19
• Timeless and Classics Zero 1.1.8-hotfix
• Fzzy Config 0.7.6 for Minecraft 1.20.1
• Kotlin for Forge 4.12.0

Install the mod and every dependency on both the client and server. This release is intentionally locked to the reviewed versions above.