Your Knight — Companion Mod

🛡️ Your Knight Companion

Ever felt lonely exploring the deep caves or vast forests of Minecraft? Your Knight brings a fully customizable, leveling AI companion directly into your world!

Summon your personal guard using a special medallion, equip him with armor and weapons, and watch him grow into a powerful ally. He remembers your name, warns you when his inventory is full, and adapts to your playstyle through dedicated skill trees.

⚙️ Requirements

• Minecraft: 1.20.1

• Forge: 47.3+

• GeckoLib: 4.4+

🚀 Getting Started

1. Join the world — On your first login, you automatically receive a Guide Book, an Empty Medallion, and a pre-filled Spawn Medallion.

2. Bind it — Right-click with the Empty Medallion in your hand to permanently bind it to you.

3. Summon — Right-click the ground with the Filled Medallion to summon your knight.

4. Command — Right-click your new companion directly to open the management GUI.

🖥️ Companion GUI & Inventory

The custom GUI is the command center for your companion. You can name him, switch behavior modes, allocate skill points, and manage his gear.

Equipment Slots:

• ⚔️ Weapon: The sword used for combat.

• ⛏️ Pickaxe: Used when in Gather (mining) mode.

• 🪓 Axe: Used when in Gather (woodchopping) mode.

• 🕯️ Torch: Consumed by the Auto-Torch feature.

• 🛡️ Armor & Shield: Helmet, Chestplate, Leggings, Boots, and Shield (fully renders on the model).

• 🍖 Food: Auto-consumed to heal when HP drops.

• 🎒 Backpack: 12 slots for storing all gathered resources.

🤖 Behavior Modes

• 🗡️ Idle: The default state. Follows and defends you, but won't pick fights.

• 🛡️ Protect: Active combat mode. Patrols within 20 blocks, actively hunting hostile mobs. Returns to you after a fight.

• ⛏️ Gather: Your personal gatherer. Scans for logs, stone, and ores (prioritizes diamonds!). Chops the base of a tree 6 times to fell it completely.

• 🚫 Stand: Locks position and equips shield. Perfect for guarding doorways.

📈 Progression & Skill Trees

Your knight gains XP by killing mobs, mining, and chopping wood. Every level-up grants 1 Skill Point (Max Level: 20).

⚔️ Warrior Branch

• Damage I & II: Grants +1, then +2 attack damage.

• Health I & II: Boosts max HP by +10, then +20.

• Speed: Increases base movement speed.

• Armor: Grants a permanent passive armor bonus.

⛏️ Miner Branch

• Speed I & II: Significantly reduces block-breaking time.

• Radius: Expands the scanning range for gatherable resources.

• Fortune I & II: Applies Fortune 1, then Fortune 3 to ore drops.

🔮 Sorcerer Branch

• Freeze: 15% chance on hit to apply Slowness X and an ice effect.

• Aura of Haste: Emits a 16-block aura that grants you Haste I.

• Void Strike: 10% chance on hit to apply Levitation and Wither.

• Lightning (Ultimate): 15% chance to strike the enemy with real lightning!

✨ Features & Immersion

Quality of Life:

• 📦 Vacuum Mode: Automatically sucks up dropped items within 5 blocks if there's space.

• 🕯️ Auto-Torch: Automatically places torches in dark spots (light level < 8).

• 🍖 Auto-Healing & Blocking: Eats food automatically to heal. 50% chance to block damage with a shield in Protect/Stand modes.

Bonding & Revival:

• 💬 Immersion: Spending time near your knight increases your Bond Level. He will warn you of ambushes, drop idle quotes, and send special messages as your bond grows.

• 💀 Revival: If your knight falls, he drops his inventory and a Bloody Medallion. Right-click it on the ground to revive him with all stats and progression fully intact!

🔧 Technical Notes

• Persistent entity (will never randomly despawn).

• Fully multiplayer compatible (tied to owner's UUID).

• Powered by smooth GeckoLib 4 animations.

• Anti-stuck teleportation logic included.

• Limitation: Cannot swim (pathfinds around water). Fortune applies via tool copying and won't degrade the pickaxe's durability.