Better Tools
A lightweight quality-of-life plugin for tools & weapons on Paper 1.21.9+
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.