Vein Farming: Universal Farming QoL Toolkit

# 🌾 Vein Farming: Universal Farming QoL Toolkit (NeoForge 1.21.1)

**Vein Farming: Universal Farming QoL Toolkit** is a lightweight, all-in-one Smart Farming mod that turns tedious agricultural chores into an intuitive, automated, and satisfying experience.

It works **100% Standalone** with zero required library dependencies, while also offering seamless deep integration with **LiteMiner** and **FTB Ultimine**.

---

### 🌟 Key Features

### 1. 🌾 Mass Harvesting & Instant Replanting
* **Right-Click Harvest:** Hold the mass action key (default: `Left Shift`, or your `LiteMiner` / `FTB Ultimine` key if installed) and right-click mature crops to harvest the entire field and **instantly replant** them at age 0 using dropped or inventory seeds.
  * Left-Click mass destroy aggregates and merges all dropped items at the clicked block, or directly deposits them into your inventory.

* **💧 Smart Water Bucket Irrigation:**
  * Hold a Hoe in main hand and a Water Bucket in off hand to till the soil and automatically carve water holes with optimal 8-block spacing.
  * 2-Pass Hybrid Hydration Solver guarantees 100% farmland moisture, even in narrow corners and irregular terrain.

* **🌿 Intelligent Planting Algorithms:**
  * **40/40 Melon & Pumpkin Pattern:** Places stems in a checkerboard layout, reserving adjacent spots for fruit growth.
  * **Contextual Intercropping:** Hold two seed types in both hands to plant alternating parallel rows for optimal Vanilla growth speed.
  * **Sapling Spacing:** Anti-overcrowding algorithm ensures saplings maintain at least a 4-block distance.
  * **Organic Meadow Noise:** Scatters flowers, ferns, and mushrooms in natural organic densities.
  * **Dense Cactus (MIS):** Mathematically places cacti in the densest legal pattern without self-breaking.
  * **4-Sided Cocoa Wrapping:** Wraps cocoa beans around all jungle log faces automatically.

* **🛠️ Essential Farming QoL:**
  * **Farmland Trample Protection:** Jumping players and mobs will no longer turn farmland back to dirt.
  * **Auto Foliage Clearing:** Automatically sweeps tall grass and weeds when tilling soil.
  * **Tool Breaking Protection:** Halts mass actions when tools reach 1 durability.
  * **Batch Composter:** Dump up to 128 compostable items in a single click.
  * **Bedrock Flower Bonemeal:** Bone-mealing 1-block flowers spreads duplicates onto nearby grass.

* **🖥️ Built-In In-Game Config & 3D Preview:**
  * Native Vanilla-style configuration menu accessible via `Esc -> Mods -> Config`.
  * Real-time 3D wireframe bounding box preview with zero FPS impact.

---

### ⚙️ Compatibility & Requirements
* **Platform:** NeoForge 1.21.1
* **Optional Integrations:** LiteMiner, FTB Ultimine (works fully standalone if neither is installed).
* **Default Activation Key:** `~` (Grave / Tilde, fully rebindable in Controls).