Ck7 - Be My Sword

Be My Sword is a Minecraft mod inspired by Guard Villagers, but expanded and redesigned to better fit a more interactive and RPG-like experience.

The mod introduces human guardians to Minecraft villages that function as recruitable personal bodyguards. Recruit them with a Golden Apple, manage their equipment and inventory, and watch them grow stronger through combat.

## Key Features

- **Leveling system** — guardians start at Level 1 (20 HP) and grow up to Level 10, with stats (health, attack, armor, speed) and inventory capacity scaling as they level up.
- **Full equipment & inventory management** — armor, main hand, offhand, and a leveled inventory of items/potions, managed through a dedicated GUI.
- **Combat AI** — guardians proactively fight nearby monsters once tamed, block hits with a shield if equipped, switch to bow or (from level 5+) thrown tridents depending on what's in their hand.
- **Potion-savvy in combat** — guardians drink Strength/Speed/Regeneration potions from their own inventory when a fight starts, eat food to heal, and throw Regeneration splash potions at wounded allies.
- **Dialogue system** — guardians talk to you, tame or not.
- **Natural village spawning**, plus a dedicated `guardian_house` structure that can generate in villages.
- **Reproduction** using Glistering Melon Slices.
- **Follower behavior** with a sit/follow toggle, and they hold still while you manage their inventory so you don't have to chase them.
- Real player skins — each guardian gets a random skin (male/female) instead of a generic reskinned mob.

## Coming Soon (Version 3 roadmap)

- **Class system** for guardians, giving each one a distinct combat/support role instead of one-size-fits-all stats.
- **Deeper dialogue system**, building on the current one with more context and personality.
- **Visual feedback improvements** — clearer in-world indicators of what a guardian is doing at any given moment (eating, drinking a potion, about to attack, following, etc.), so you don't have to guess from the animation alone.
- **Attribute balance pass** across the level 1–10 curve.

## Known Issues

- Occasional delayed guardian spawn right after loading a world.
- Rare input stickiness.

**Compatibility:** Forge for Minecraft Java Edition 1.20.1–1.20.6