iTimber

🌲 iTimber

Project Status: BETA / INDEV

Security Notice: This plugin has been thoroughly tested, optimized, and verified safe for use in live production environments. However, due to the nature of dynamic block scanning, absolute safety under extreme edge cases cannot be unconditionally guaranteed. And this project is still In Development.

iTimber is an optimized, high-performance tree-felling solution engineered specifically for modern Paper, Spigot, and Purpur environments. By replacing traditional automatic breaking with a deliberate execution mechanism, it grants players precise operational control over timber actions—eliminating accidental structural damage while accelerating harvesting workflows.

📋 Key Technical Specifications

• Platform Support: Paper | Spigot | Purpur
• Target Environment: Minecraft 1.17.x - 1.21.x (Compiled, tested, and optimized for 1.21.11)
• Runtime Requirement: Java 21/17 or higher

⚡ System Features

• Intentional Activation Script

Manual Activation: Prevents accidental destruction of custom wooden assets. Players must explicitly prime the tool to queue the felling sequence by triggering the shift action.

• Large-Scale Structural Felling

Massive Tree Felling: Instantly processes and breaks contiguous log structures up to a safety limit of 500 blocks in a single tick transaction.

• Interactive Configuration Engine

Configurable GUI (/itimber | /timber): Opens a responsive GUI matrix for real-time user customization:

• Toggle: Enable or disable personal accessibility to the timber module instantly.
• Timeout: Dynamically adjust the axe prime duration cache from 1 to 60 seconds.

• Inventory Integration

Smart Item Collection: Intercepts dropped blocks and injects items straight into the player's inventory buffer. Overflow items are safely dropped at the base of the sequence to mitigate entity lag.

• Zero-Configuration Architecture

Zero-Config Setup: Out-of-the-box native support for all vanilla logs, woods, and specialized stems (including Mangrove, Cherry, and Pale Oak variants).

🕹️ Operational Workflow

📦 Step 1: Initialization

Equip: Hold any valid tool subclass: Wood, Stone, Iron, Gold, Diamond, or Netherite axe.

🔋 Step 2: Priming Phase

Prime: Execute Sneak (Shift) + Right Click to register the axe state change and receive a clear action confirmation message in chat.

🪓 Step 3: Execution

Chop: Break any log or wood node within your configured timeout window to fell the entire tree structure instantly!

🔌 Step 4: Interruption / Expiration

Cancel: Sneak + Right Click again to lower your axe manually, or simply let the countdown loop terminate automatically.