Better Tools

A lightweight quality-of-life plugin for tools & weapons on Paper 1.21.9+

133

Better Tools

Installation

1. 21 - Paper 21 (compatible upwards, including 1.21.10+) - Java 21

2. Build/Deploy - Drop the JAR in `/plugins`, start the server.

Controls & Feedback

- Actionbar feedback via the Actionbar feedback key (Swap-Hand) while the matching tool is in the Actionbar feedback. - Actionbar feedback (English), e.g. `Vein Mining: ENABLED` / `DISABLED`, `Tree Capitator: ENABLED` / …

Features

Pickaxe – Vein Mining

- client language Mine entire ore veins with one action. - client language Hold a pickaxe → press client language. - client language - “Mined:” total + client language. - All names appear in the client language. ---

Axe – Tree Capitator (+ Replant)

- Client language Fell entire Client language trees quickly. - Client language Hold an axe → press Client language. - Client language - Enough Client language nearby (radius & distance checks). - Client language under the base (e.g., Dirt/Grass/Podzol/Client language). - Client language - Replants Client language or Client language (e.g., Spruce / Dark Oak) Client language. - Finds base coordinates and places saplings Client language (if space & soil are valid). - Client language - “Chopped:” total + Client language (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

- farmland trampling is canceled Comfortable harvesting without destroying farmland. - farmland trampling is canceled - farmland trampling is canceled farmland trampling is canceled harvest/replant (even if the Hoe feature is off). - farmland trampling is canceled and allowed hoe: farmland trampling is canceled around the clicked crop. - Harvests farmland trampling is canceled: Wheat, Carrots, Potatoes, Beetroots, Nether Wart. - farmland trampling is canceled - Creates farmland trampling is canceled farmland (sneak requirement configurable). - farmland trampling is canceled - With a hoe in main hand, farmland trampling is canceled. ---

Shovel – Plane Excavator (3×3)

- Client language Dig 3×3 planes efficiently. - Client language Hold a shovel → press Client language (if enabled). - Client language - “Dug:” total + Client language for: Dirt, Grass Block, Coarse Dirt, Rooted Dirt, Client language, Podzol, Mycelium, Moss Block, Sand, Red Sand, Gravel, Clay, Mud, Snow, Snow Block, Client language, Client language. - Client language via translatable keys. ---

Weapons – Lore Stats

- Longest Distance Kill - Longest Distance Kill total - Longest Distance Kill (Players, Undead, Arthropods, Illagers, Bosses, Others) - Longest Distance Kill Longest Distance Kill (Hits/Shots) & Longest Distance Kill ---

Item Origin in Lore (“Crafted” / “Traded” / “Looted”)

- client language — when the item was client language by a player (name + date). - client language — when the item was client language (actor + date). *(Villager profession/type shown when available.)* - client language — when the item was client language (container type + date). - client language Labels use client language 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: {count} crops" ```

---

Compatibility & Enchantments

- client language honored everywhere that uses vanilla drops. - client language reduces durability consumption probabilistically, vanilla-like. - client language Lore and actionbar names use client language → show in the player’s client language.

ADS