Fervente's Butcher Knife

# **🔪 Fervente's Butcher Knife** **<span style="color: rgb(224, 62, 45);">A utility weapon mod that lets you efficiently harvest meat from animals with a specialized tool!</span>** !(https://cdn.modrinth.com/data/cached_images/fad8ed912cd64e1610fd7eebe4e15ee02aa5976e.png) (https://shockbyte.com/billing/aff.php?aff=10999) *** ## **📖 Overview** Fervente's Butcher Knife adds a unique utility weapon designed for efficient meat harvesting. Right-click passive animals with the Butcher Knife to instantly harvest meat without the hassle of traditional combat. Perfect for farms, survival gameplay and Modpack implementation! *** ## **✨ Features** ### 🔪 **The Butcher Knife** A specialized tool that combines combat and utility: * **Attack Damage:** 6.0 (3 hearts) * **Attack Speed:** 1.0 attacks/second (axe speed) * **Durability:** 250 uses * **Special Ability:** Right-click to harvest animals ### 🐄 **Harvest Mechanic** Right-click any compatible animal to perform a harvest: * **Harvest Damage:** 10.0 (5 hearts) - configurable * **Durability Cost:** 20 per harvest (12 total harvests) * **Cooldown:** 3 seconds between harvests * **Loot Compatibility:** Works with Looting enchantment for extra drops * **Fire Aspect Compatibility:** Automatically cooks meat when harvesting ### 🐷 **Compatible Animals** The Butcher Knife can harvest the following entities: * Cow * Pig * Sheep * Chicken * Rabbit * Mooshroom * Goat * Llama * Donkey * Horse * Mule * **Target Dummy** (from MmmMmmMmmMmm mod - for testing/debugging) ### ✨ **Enchantment Support** The Butcher Knife has **restricted enchantments** for balance: **Allowed Enchantments:** * ⚔️ **Sharpness** - Increases both combat and harvest damage * 🔥 **Fire Aspect** - Sets animals on fire, producing cooked meat * 💎 **Looting** - Increases meat drops from harvests * 🛡️ **Unbreaking** - Extends tool durability **Blocked Enchantments:** * ❌ Any other sword enchantments ### 🧰 **Crafting System** **Step 1: Butcher Knife Cleaver** (Crafting Component) !(https://media.forgecdn.net/attachments/description/null/description_4e6f9fce-e6e8-481d-84dd-db35b93efc9a.png) _Any type of meat work in the corners_ **Step 2: Butcher Knife** (Final Tool) ``` Shapeless Recipe: - 1x Butcher Knife Cleaver - 1x Stick ``` ### !(https://media.forgecdn.net/attachments/description/null/description_a2a0ea55-cc43-4e8e-bffb-eb2a28baa5bb.png) ⚙️ **Configuration** All values are fully configurable via `ferventes_butcher_knife-common.toml`: ```toml harvestDamage = 10.0 # Damage dealt per harvest (10.0 = 5 hearts) weaponDamage = 6.0 # Base attack damage (for reference) maxDurability = 250 # Total tool durability harvestDurabilityCost = 20 # Durability used per harvest harvestCooldownTicks = 60 # Cooldown after harvest (60 = 3 seconds) particleCount = 20 # Blood particles spawned per harvest ``` *** ## **🎮 Gameplay Tips** ### 🌾 **Farming Strategy** 1. Build an animal pen with 12+ animals (one full knife worth) 2. Use Fire Aspect to get cooked meat directly 3. Apply Looting III for maximum meat yields 4. Keep a backup knife in your inventory ### ⚔️ **Combat vs Harvest** * **Combat:** Lower damage (6.0) but no durability penalty per hit * **Harvest:** High damage (10.0) but costs 20 durability per use * **Strategy:** Use combat for cleanup, harvest for efficient farming ### 💎 **Looting Optimization** Looting III can drop up to **5-7 meat per harvest** from cows/pigs! * Standard drop: 1-3 meat * Looting I: 2-4 meat * Looting II: 3-5 meat * Looting III: 4-7 meat *** ## **🔧 Technical Details** ### 📊 **Mechanics Breakdown** * **Harvest Trigger:** `interactLivingEntity()` on right-click * **Server-Side Only:** All harvest logic runs server-side to prevent desync * **Position Caching:** Entity position cached before damage to ensure accurate particle spawning * **Enchantment Calculation:** Sharpness adds 1.25 damage per level to harvest * **Cooldown Display:** Visual cooldown bar appears in hotbar ### 🛡️ **Safety Features** * Dead entity check prevents harvesting corpses * Durability threshold check prevents over-use * Cooldown prevents spam harvesting * Client-side prediction for responsive feel *** ## **🔄 Compatibility** ### ✅ **Confirmed Compatible** * **Forge:** 1.20.1-47.3.0+ * **Minecraft:** 1.20.1 * **Java:** 17+ * **MmmMmmMmmMmm:** Target Dummy support for debugging ### 🤝 **Mod Compatibility** * **Enchantment Mods:** Fully compatible (restrictions enforced) * **Loot Mods:** Works with loot modification mods * **Combat Mods:** Damage scaling respects all modifiers ### ⚠️ **Known Limitations** * Cannot be repaired (by