🔪 Fervente's Butcher Knife

A utility weapon mod that lets you efficiently harvest meat from animals with a specialized tool!

---

📖 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)

Any type of meat work in the corners

Step 2: Butcher Knife (Final Tool)

Shapeless Recipe:
- 1x Butcher Knife Cleaver
- 1x Stick

⚙️ Configuration

All values are fully configurable via ferventes_butcher_knife-common.toml:

[damage]
    harvestDamage = 10.0        # Damage dealt per harvest (10.0 = 5 hearts)
    weaponDamage = 6.0           # Base attack damage (for reference)

[durability]
    maxDurability = 250          # Total tool durability
    harvestDurabilityCost = 20   # Durability used per harvest

[cooldown]
    harvestCooldownTicks = 60    # Cooldown after harvest (60 = 3 seconds)

[particles]
    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 design - consumable tool)
• Does not work on hostile mobs
• Enchantment restrictions cannot be bypassed (even via commands after application)

---

📜 Credits & License

Mod Author: Fervente
Version: 1.0.0
Minecraft Version: 1.20.1
Forge Version: 47.3.0+
License: All Rights Reserved

Can i use it on my ModPack/Server?
> Sure!

---

🐛 Bug Reports & Suggestions

Found a bug or have a suggestion? Please report issues on Modrinth & Curseforge comments!

---

🎯 Future Plans

Potential features for future updates (not confirmed):

• More harvestable entities (Modded options)
• Custom particle textures
• Achievement system
• Butcher Knife variants (materials/tiers)
• Advanced enchantments

---

For Servers and Modpacks: This mod is balanced for survival gameplay with reasonable durability costs and cooldowns. Adjust config values to match your progression.