## Installation<\/p>\n
1. **Requirements**
\n – Paper **1.21.9** (compatible upwards, including 1.21.10+)
\n – Java **21**<\/p>\n
2. **Build\/Deploy**
\n – Drop the JAR in `\/plugins`, start the server.<\/p>\n
## Controls & Feedback<\/p>\n
– **Per-player toggle** via the **F** key (Swap-Hand) while the matching tool is in the **main hand**.
\n– **Actionbar feedback** (English), e.g.
\n `Vein Mining: ENABLED` \/ `DISABLED`, `Tree Capitator: ENABLED` \/ \u2026<\/p>\n
## Features
\n### Pickaxe \u2013 Vein Mining
\n– **Goal:** Mine entire ore veins with one action.
\n– **Toggle:** Hold a pickaxe \u2192 press **F**.
\n– **Lore stats:**
\n – \u201cMined:\u201d total + **per ore type**.
\n – All names appear in the **client language**.
\n—
\n### Axe \u2013 Tree Capitator (+ Replant)
\n– **Goal:** Fell entire **natural** trees quickly.
\n– **Toggle:** Hold an axe \u2192 press **F**.
\n– **Natural tree detection:**
\n – Enough **non-persistent leaves** nearby (radius & distance checks).
\n – **Valid soil** under the base (e.g., Dirt\/Grass\/Podzol\/**Sand\/Red Sand**).
\n– **Replanting:**
\n – Replants **1\u00d71** or **2\u00d72** (e.g., Spruce \/ Dark Oak) **after a short delay**.
\n – Finds base coordinates and places saplings **exactly** (if space & soil are valid).
\n– **Lore stats:**
\n – \u201cChopped:\u201d total + **per wood family** (Oak, Spruce, Birch, Jungle, Acacia, Dark Oak, Mangrove, Cherry, Pale Oak, Bamboo, Crimson, Warped).
\n – **Client language** via translatable keys.
\n—
\n### Hoe \u2013 Right-Click Harvest & 3\u00d73 Tilling
\n– **Goal:** Comfortable harvesting without destroying farmland.
\n– **Harvest (Right-Click):**
\n – **Always available:** **1\u00d71** harvest\/replant (even if the Hoe feature is off).
\n – **With toggle (F)** and allowed hoe: **3\u00d73** around the clicked crop.
\n – Harvests **only mature**: Wheat, Carrots, Potatoes, Beetroots, Nether Wart.
\n– **Tilling (Shift + Right-Click):**
\n – Creates **3\u00d73** farmland (sneak requirement configurable).
\n– **Anti-trample:**
\n – With a hoe in main hand, **farmland trampling is canceled**.
\n—
\n### Shovel \u2013 Plane Excavator (3\u00d73)
\n– **Goal:** Dig 3\u00d73 planes efficiently.
\n– **Toggle:** Hold a shovel \u2192 press **F** (if enabled).
\n– **Lore stats (per material):**
\n – \u201cDug:\u201d 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**.
\n – **Client language** via translatable keys.
\n—
\n### Weapons \u2013 Lore Stats
\n– **Tracked:**
\n – **Damage** total
\n – **Kills** (Players, Undead, Arthropods, Illagers, Bosses, Others)
\n – **Bow\/Crossbow:** **Accuracy** (Hits\/Shots) & **Longest Distance Kill**
\n—
\n### Item Origin in Lore (\u201cCrafted\u201d \/ \u201cTraded\u201d \/ \u201cLooted\u201d)
\n– **Crafted** \u2014 when the item was **crafted** by a player (name + date).
\n– **Traded** \u2014 when the item was **acquired via villager trade** (actor + date).
\n *(Villager profession\/type shown when available.)*
\n– **Looted** \u2014 when the item was **looted from a generated chest** (container type + date).
\n– **Language:** Labels use **translatable keys** to display in the player\u2019s **client language**.
\n—<\/p>\n
## Configuration (`config.yml`)<\/p>\n
**Example (excerpt):**
\n“`yaml
\nfeatures:
\n pickaxe:
\n vein_mining:
\n enabled: true
\n max_blocks: 96
\n durability_safety_buffer: 5
\n include_diagonals: true
\n tools:
\n WOODEN_PICKAXE: true
\n STONE_PICKAXE: true
\n IRON_PICKAXE: true
\n GOLDEN_PICKAXE: true
\n DIAMOND_PICKAXE: false
\n NETHERITE_PICKAXE: true<\/p>\n
axe:
\n tree_capitator:
\n enabled: true
\n collect_drops_at_base: true
\n break_leaves: true
\n include_diagonals: true
\n max_logs: 256
\n max_leaves: 512
\n durability_safety_buffer: 5
\n tools:
\n WOODEN_AXE: true
\n STONE_AXE: true
\n IRON_AXE: true
\n GOLDEN_AXE: true
\n DIAMOND_AXE: true
\n NETHERITE_AXE: true<\/p>\n
hoe:
\n harvest_3x3:
\n enabled: true
\n tools:
\n WOODEN_HOE: true
\n STONE_HOE: true
\n IRON_HOE: true
\n GOLDEN_HOE: true
\n DIAMOND_HOE: true
\n NETHERITE_HOE: true
\n till_3x3:
\n enabled: true
\n require_sneak: true
\n tools:
\n WOODEN_HOE: true
\n STONE_HOE: true
\n IRON_HOE: true
\n GOLDEN_HOE: true
\n DIAMOND_HOE: true
\n NETHERITE_HOE: true<\/p>\n
shovel:
\n excavator:
\n enabled: true
\n tools:
\n WOODEN_SHOVEL: true
\n STONE_SHOVEL: true
\n IRON_SHOVEL: true
\n GOLDEN_SHOVEL: true
\n DIAMOND_SHOVEL: true
\n NETHERITE_SHOVEL: true<\/p>\n
messages:
\n vein_enabled: “Vein Mining: ENABLED”
\n vein_disabled: “Vein Mining: DISABLED”
\n vein_halted: “Vein mining halted to protect your tool”
\n vein_summary: “Vein mined: {count} blocks”<\/p>\n
axe_enabled: “Tree Capitator: ENABLED”
\n axe_disabled: “Tree Capitator: DISABLED”
\n axe_halted: “Tree felling halted to protect your tool”
\n axe_summary: “Tree felled: {logs} logs, {leaves} leaves”<\/p>\n
hoe_tilled: “Created 3×3 farmland”
\n hoe_no_space: “No space to create farmland”
\n hoe_harvested: “Harvested: {count} crops”
\n“`<\/p>\n
—<\/p>\n
## Compatibility & Enchantments<\/p>\n
– **Silk Touch \/ Fortune:** honored everywhere that uses vanilla drops.
\n– **Unbreaking:** reduces durability consumption probabilistically, vanilla-like.
\n– **Localization:** Lore and actionbar names use **translatable keys** \u2192 show in the player\u2019s **client language**.<\/p>\n","protected":false},"excerpt":{"rendered":"
A lightweight quality-of-life plugin for tools & weapons on Paper 1.21.9+<\/p>\n","protected":false},"featured_media":29531,"template":"","meta":{"_minecraft_slug":"better-tools-coa","_minecraft_project_id":"oLBGMHMm","_minecraft_author":"Trason","_minecraft_license":"Apache-2.0","_minecraft_downloads":133,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"better-tools-coa.zip","_minecraft_size_bytes":209449,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T18:55:47.505918Z","_minecraft_date_created":"2025-11-10T22:18:51.596301Z","_minecraft_date_modified":"2025-11-24T21:15:22.488955Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/better-tools-coa","_minecraft_icon_attachment_id":29531,"_minecraft_imported_at":"2026-06-01T12:10:46+00:00","_minecraft_import_hash":"79f73f74153c4b40d325cbfcbd8f3602","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,88,85,89,137,127,92],"mod_loader":[132],"minecraft_version":[62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-29530","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-equipment","mod_category-food","mod_category-game-mechanics","mod_category-mobs","mod_category-paper","mod_category-utility","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n