🌲⛏️ SimpleTimber

Speed up resource gathering without sacrificing survival fairness.
SimpleTimber adds two core mechanics to your Paper server:

• Timber: break full trees at once
• VeinMiner: mine connected ore veins in one go

It is designed to be fast, predictable, and admin-friendly.

---

✨ Features

🌳 Timber Mode

• Breaks full trees from the lowest trunk block
• Handles wider tree shapes (including acacia-style branching)
• Optional leaf inclusion
• Uses configurable horizontal scan distance to avoid missing side branches

🪨 VeinMiner Mode

• Mines connected ore blocks of the same type
• Configurable maximum blocks per chain
• Optional Auto-Smelt for supported drops:
  • RAW_IRON → IRON_INGOT
  • RAW_GOLD → GOLD_INGOT
  • RAW_COPPER → COPPER_INGOT
  • ANCIENT_DEBRIS → NETHERITE_SCRAP

⚖️ Survival Balance & Anti-Exploit Behavior

• Requires proper tools:
  • Axes for logs
  • Pickaxes for ores
• Optional sneak requirement
• Chain action only starts if the first block is actually mineable
  • Example: no chain trigger when trying to mine diamond ore with a stone pickaxe

🎒 Drop Behavior

• Send drops to inventory or drop naturally on ground
• Overflow handling: if inventory is full, only leftover items are dropped

🧩 Admin-Friendly Config

• Enable/disable Timber and VeinMiner independently
• Tune max blocks, radius, auto-smelt, drop mode, and general behavior
• Works cleanly with normal survival progression

---

⚙️ Example Config

timber:
  enabled: true
  max-blocks: 256
  max-horizontal-distance: 7
  include-leaves: false
  drop-mode: "INVENTORY" # INVENTORY or DROP

veinminer:
  enabled: true
  max-blocks: 128
  auto-smelt: true
  drop-mode: "INVENTORY" # INVENTORY or DROP

general:
  require-sneak: true
  tools-only: true

  ✅ Requirements
Paper 1.21+
Java 21

💡 Why SimpleTimber?
SimpleTimber focuses on what servers actually need:

Faster gathering
Consistent gameplay rules
Minimal setup
No unnecessary complexity