Village Militia Mod — Feature Guide & Documentation

Status: Under Active Development
Note: Tons of new features, behavior subroutines, and AI optimizations are currently being worked on. Stay tuned for future updates!

---

Getting Started

Village Militia Spawn Egg

• Location: Located at the very end of the vanilla Spawn Eggs creative tab.
• Cost-Efficient Recruitment: Activating the militia via Sneak (Shift) + Right-Click with an Iron Helemt on an unemployed villager

---

Command Modes

Hold an Emerald and (Shift) + Right-Click with a militia member to switch between the following modes. A distinct particle effect will appear around their feet to show their active mode instantly:

Mode	Visual Indicator	Behavior Description
IDLE	Free Roam	Wanders freely; stays relaxed.
FOLLOW	END_ROD	Follows and protects the player.
GUARD	ENCHANT	Holds ground and guards the spot.
PATROL	GLOW	Patrols nearby area for monsters.

---

Cavalry & Transport Mechanics

• Cavalry Mounting Conditions: A militia will automatically mount a horse if the horse meets three strict conditions:
  1. It has no current passengers.
  2. It is already saddled.
  3. It is not currently leashed.
• Forced Dismount Command: If a militia is currently riding a horse, you can order them to dismount instantly by Sneak (Shift) + Right-Clicking them with an empty hand.
• Tactical Leashing (Troop Transport): Once the militia is mounted, you can attach a lead to the horse. This allows you to drag both the horse and the militia together, making long-distance relocation a breeze!

---

Equipment Customization & Arsenal

1. Make sure the militia is not currently in combat.
2. Keep both of the player's hands empty.
3. Do not hold Shift.
4. Right-click the militia.

The equipment menu allows you to manage the militia's armor, main-hand item, and off-hand item.

---

Combat AI & Special Interactions

• Advanced Combat AI: Features smart positioning, directional strafing, tactical retreats, and timely shield-blocking to make your villagers viable combatants instead of punching bags.
• Hero of the Village: When you approach with the Hero of the Village effect, nearby militia will salute you!

Village Druid & Support Mechanics

Village Druid Spawn Egg & Recruitment

• Location: Located alongside the Militia at the very end of the vanilla Spawn Eggs creative tab.
• Golden Apple Transformation: Sneak (Shift) + Right-Click an unemployed, adult villager (profession: NONE) while holding a Golden Apple (Items.GOLDEN_APPLE) to convert them into a Village Druid.

---

Druid Spellcasting & AI Behaviors

The Druid acts as a backline battle-mage, actively cycling between support healing, crowd control, and offensive spells while maintaining dynamic positioning:

Spell Type	Trigger / Target	Spell Effects & Visuals
HEALING_LIGHT	Low HP Allies / Self	Restores 5.0 HP, grants Regeneration I (4s), and emits heart/cherry blossom particles.
THORN_BINDING	Ranged Enemies	Deals 4.0 magic damage, applies Slowness II (6s), and releases spore blossom particles.
ARCANE_RAY	Ranged Enemies	Fires a high-damage beam (6.0 magic damage), applies Glowing (5s), and emits amethyst resonance.
POISON_BLOOM	Ranged Enemies	Deals 2.0 magic damage, applies Poison I (5s) + Slowness II (5s) with crimson spore particles.
NATURE_BURST	Close Enemies	Single & AOE blast dealing magic damage and applying heavy knockback within 2.5 blocks.

• Tactical Movement & Kiting: Druids automatically retreat if enemies close in within 7 blocks, close the distance if targets stray beyond 11 blocks, and continuously strafe sideways while channeling to evade incoming attacks.
• Casting Circle FX: Renders a pulsing two-ring particle magic circle at the Druid's feet during spell channeling with spell-themed particles (END_ROD, SPORE_BLOSSOM_AIR, CRIMSON_SPORE, CHERRY_LEAVES).