🛡️ 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
Join the world — On your first login, you automatically receive a Guide Book, an Empty Medallion, and a pre-filled Spawn Medallion.
Bind it — Right-click with the Empty Medallion in your hand to permanently bind it to you.
Summon — Right-click the ground with the Filled Medallion to summon your knight.
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.
