🔪 Fervente's Butcher Knife

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

! https://shockbyte.com/billing/aff.php?aff=10999 Click Here

---

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

!Butcher Knife Cleaver

Any type of meat work in the corners

Step 2: Butcher Knife (Final Tool)

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

!Butcher Knife Recipe

⚙️ 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  
  
_<span style="color: rgb(236, 240, 241);"><strong>Can i use it on my ModPack/Server?<br>&gt;</strong></span>_ <span style="color: rgb(255, 255, 255);"><strong><em> Sure!</em></strong></span>

***

## **🐛 Bug Reports & Suggestions**

Found a bug or have a suggestion? Please report issues on <span style="color: rgb(45, 194, 107);"><strong>Modrinth</strong> </span> & **<span style="color: rgb(230, 126, 35);">Curseforge</span>** 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._