Better Tools

## Installation 1. **Requirements** - Paper **1.21.9** (compatible upwards, including 1.21.10+) - Java **21** 2. **Build/Deploy** - Drop the JAR in `/plugins`, start the server. ## Controls & Feedback - **Per-player toggle** via the **F** key (Swap-Hand) while the matching tool is in the **main hand**. - **Actionbar feedback** (English), e.g. `Vein Mining: ENABLED` / `DISABLED`, `Tree Capitator: ENABLED` / … ## Features ### Pickaxe – Vein Mining - **Goal:** Mine entire ore veins with one action. - **Toggle:** Hold a pickaxe → press **F**. - **Lore stats:** - “Mined:” total + **per ore type**. - All names appear in the **client language**. --- ### Axe – Tree Capitator (+ Replant) - **Goal:** Fell entire **natural** trees quickly. - **Toggle:** Hold an axe → press **F**. - **Natural tree detection:** - Enough **non-persistent leaves** nearby (radius & distance checks). - **Valid soil** under the base (e.g., Dirt/Grass/Podzol/**Sand/Red Sand**). - **Replanting:** - Replants **1×1** or **2×2** (e.g., Spruce / Dark Oak) **after a short delay**. - Finds base coordinates and places saplings **exactly** (if space & soil are valid). - **Lore stats:** - “Chopped:” total + **per wood family** (Oak, Spruce, Birch, Jungle, Acacia, Dark Oak, Mangrove, Cherry, Pale Oak, Bamboo, Crimson, Warped). - **Client language** via translatable keys. --- ### Hoe – Right-Click Harvest & 3×3 Tilling - **Goal:** Comfortable harvesting without destroying farmland. - **Harvest (Right-Click):** - **Always available:** **1×1** harvest/replant (even if the Hoe feature is off). - **With toggle (F)** and allowed hoe: **3×3** around the clicked crop. - Harvests **only mature**: Wheat, Carrots, Potatoes, Beetroots, Nether Wart. - **Tilling (Shift + Right-Click):** - Creates **3×3** farmland (sneak requirement configurable). - **Anti-trample:** - With a hoe in main hand, **farmland trampling is canceled**. --- ### Shovel – Plane Excavator (3×3) - **Goal:** Dig 3×3 planes efficiently. - **Toggle:** Hold a shovel → press **F** (if enabled). - **Lore stats (per material):** - “Dug:” total + **single lines** for: Dirt, Grass Block, Coarse Dirt, Rooted Dirt, **Dirt Path**, Podzol, Mycelium, Moss Block, Sand, Red Sand, Gravel, Clay, Mud, Snow, Snow Block, **Soul Sand**, **Soul Soil**. - **Client language** via translatable keys. --- ### Weapons – Lore Stats - **Tracked:** - **Damage** total - **Kills** (Players, Undead, Arthropods, Illagers, Bosses, Others) - **Bow/Crossbow:** **Accuracy** (Hits/Shots) & **Longest Distance Kill** --- ### Item Origin in Lore (“Crafted” / “Traded” / “Looted”) - **Crafted** — when the item was **crafted** by a player (name + date). - **Traded** — when the item was **acquired via villager trade** (actor + date). *(Villager profession/type shown when available.)* - **Looted** — when the item was **looted from a generated chest** (container type + date). - **Language:** Labels use **translatable keys** to display in the player’s **client language**. --- ## Configuration (`config.yml`) **Example (excerpt):** ```yaml features: pickaxe: vein_mining: enabled: true max_blocks: 96 durability_safety_buffer: 5 include_diagonals: true tools: WOODEN_PICKAXE: true STONE_PICKAXE: true IRON_PICKAXE: true GOLDEN_PICKAXE: true DIAMOND_PICKAXE: false NETHERITE_PICKAXE: true axe: tree_capitator: enabled: true collect_drops_at_base: true break_leaves: true include_diagonals: true max_logs: 256 max_leaves: 512 durability_safety_buffer: 5 tools: WOODEN_AXE: true STONE_AXE: true IRON_AXE: true GOLDEN_AXE: true DIAMOND_AXE: true NETHERITE_AXE: true hoe: harvest_3x3: enabled: true tools: WOODEN_HOE: true STONE_HOE: true IRON_HOE: true GOLDEN_HOE: true DIAMOND_HOE: true NETHERITE_HOE: true till_3x3: enabled: true require_sneak: true tools: WOODEN_HOE: true STONE_HOE: true IRON_HOE: true GOLDEN_HOE: true DIAMOND_HOE: true NETHERITE_HOE: true shovel: excavator: enabled: true tools: WOODEN_SHOVEL: true STONE_SHOVEL: true IRON_SHOVEL: true GOLDEN_SHOVEL: true DIAMOND_SHOVEL: true NETHERITE_SHOVEL: true messages: vein_enabled: "Vein Mining: ENABLED" vein_disabled: "Vein Mining: DISABLED" vein_halted: "Vein mining halted to protect your tool" vein_summary: "Vein mined: {count} blocks" axe_enabled: "Tree Capitator: ENABLED" axe_disabled: "Tree Capitator: DISABLED" axe_halted: "Tree felling halted to protect your tool" axe_summary: "Tree felled: {logs} logs, {leaves} leaves" hoe_tilled: "Created 3x3 farmland" hoe_no_space: "No space to create farmland" hoe_harvested: "Harvested: {c