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):

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

• Silk Touch / Fortune: honored everywhere that uses vanilla drops.
• Unbreaking: reduces durability consumption probabilistically, vanilla-like.
• Localization: Lore and actionbar names use translatable keys → show in the player’s client language.