Timbr

Fixed an issue where the plugin failed to load on Folia. Credit: Sonikki (Bug report.)

Timbr 1.2.3

Total startup fix, unified scheduling, and improved runtime stability.

Added

- Added a unified scheduler abstraction for Bukkit, Spigot, Paper, and Folia. - Added region-aware task scheduling. - Added entity-based task scheduling for Folia-compatible entity operations. - Added global scheduler support for server-wide tasks. - Added asynchronous task and CompletableFuture support. - Added runtime detection for modern Paper/Folia scheduler APIs. - Added automatic fallback to the traditional Bukkit scheduler on older platforms. - Added a unified SchedulerTask interface for scheduler task handling.

Changed

- Updated scheduler handling to use the appropriate scheduler based on task context. - Improved cross-platform scheduler compatibility without requiring separate plugin JARs. - Improved scheduler task cancellation handling through the unified SchedulerTask interface. - Improved compatibility with Folia's regionised threading model. - Reworked tree chopping execution to separate world, entity, global, and asynchronous operations. - Improved startup initialisation to prevent scheduler and component initialisation issues. - Improved runtime scheduler detection and compatibility handling. - Improved durability handling when Unbreaking is enabled. - Improved mining fatigue handling with the modern MINING_FATIGUE API.

Fixed

- Fixed potential incompatibilities caused by directly using BukkitScheduler on Folia. - Fixed entity scheduling so entity operations can be executed through the entity's scheduler on Folia. - Fixed location-based scheduling so block and world operations can be executed on the correct region. - Prevented the scheduler abstraction from directly depending on Folia-only classes during normal Bukkit/Spigot startup. - Fixed unsafe asynchronous tree detection accessing Bukkit world and block data from the wrong thread. - Fixed player and entity operations being executed through inappropriate generic schedulers. - Fixed concurrent placeholder statistics updates with thread-safe counters. - Fixed cooldown placeholder output to report remaining cooldown time instead of the stored timestamp. - Improved placeholder handling for tool statistics and invalid inventory slots. - Added safer handling for entities that can no longer be scheduled. - Added additional validation around tree detection, protection checks, tools, and player state.

Timbr 1.2.2

Bug Fixes

- Fixed PaperSchedulerImpl to reflect on actual scheduler instances returned by the Bukkit API. - Fixed ToolMetadataManager by using lazy initialization for NamespacedKey creation.

Improvements

- Improved compatibility with modern Paper scheduler implementations. - Improved reliability of tool metadata initialization.

Timbr 1.2.1

Bug Fixes

Fixed PlaceholderAPI `NoClassDefFoundError`* * Fixed an issue where PlaceholderAPI was incorrectly relocated by the Maven Shade Plugin. * PlaceholderAPI is now left unshaded and uses the server-provided dependency as intended. Fixed Paper Detection* * Updated Paper detection to use Bukkit.getAsyncScheduler() instead of checking for the PaperAsyncScheduler class. * This improves compatibility with newer Paper builds.

Improvements

* Improved compatibility across different Paper versions. * Improved reliability of PlaceholderAPI integration.

Timbr 1.2.0

A more modern, configurable, and properly instrumented Timbr.

What's New

Modern Paper/Spigot API Support

Timbr now uses modern scheduler APIs where available, with automatic fallback to the traditional Bukkit scheduler for compatibility. Added support for FolioScheduler / BukkitAsyncScheduler* Automatic Bukkit Scheduler fallback* * Better compatibility across modern Paper/Spigot environments * Cleaner asynchronous task handling

Custom Trees

Timbr now supports custom tree configurations. * Added a dedicated custom tree configuration file * Define and configure your own tree types * More flexibility for servers with custom world-generation setups

Persistent Tool Metadata

Tool data is now stored using Minecraft's PersistentDataContainer (PDC). Timbr can persist important tool metadata such as: * Tool level * Cooldown information * Other Timbr-specific tool data This replaces less reliable approaches and allows tool metadata to remain attached to the actual item.

PlaceholderAPI Integration

Timbr now integrates with PlaceholderAPI. This allows Timbr-related information to be displayed dynamically in supported plugins and interfaces.

bStats Custom Charts

Timbr already uses bStats (Plugin ID: 31389), and 1.2.0 expands its metrics with custom charts. These charts provide more useful, aggregated statistics about Timbr usage and enabled features, helping guide future development. Timbr 1.2.0 More trees. Less scheduler nonsense.

Timbr 1.1.5

Let Trees Fall Properly.

A fairly big update from 1.1.1 -> 1.1.5, bringing a revamped animation system, better performance, and plenty of improvements behind the scenes.

Added

New modular Animation System* Action Bar progress* with percentage & status feedback Config versioning & automatic migration* New LAYDOWN* configuration options * New animation direction modes: PLAYER, LEAN, NATURAL, RANDOM

Improved

Tree detection now runs asynchronously* for better performance BlockDisplay* animations now have smoother rotation, sway & movement FallingBlock* animations now properly slide and settle on the ground * Cleaner animation architecture for easier future updates * Better animation progress tracking

Bug Fixed

* Fixed LAYDOWN animations breaking instantly instead of properly falling * Fixed BlockDisplayAnimator generating a new animation ID, breaking progress tracking * Fixed various animation and configuration handling issues Timbr 1.1.5 is now ready.

Changelog

1.1.1

Bug Fixed

- Resolved a server crash that could occur while felling trees. Under rather unfortunate circumstances, the protection verification found itself trapped in an endless loop, eventually bringing the server down. A tree ought to fall, not the entire server. - Reworked the internal protection simulation to prevent recursive event handling. Verification now completes safely without repeatedly triggering itself, which is generally how sensible software is expected to behave. - Replaced an abandoned implementation with a more reliable internal safeguard after discovering the original approach relied on functionality that simply does not exist. Reality has a habit of objecting to optimistic assumptions.

Improved

- Protection compatibility now performs its checks only once per affected block, ensuring integrations remain accurate without unnecessary reprocessing. - Internal stability has been strengthened, making tree felling considerably more dependable across supported protection plugins.

Timbr Update 1.1.0

Fixed

- Corrected server version detection to ensure modern display features are identified reliably across supported Minecraft versions. - Fixed an issue where breaking an axe during tree felling could trigger an unexpected server error. - Mining Fatigue removal now affects only effects applied by Timbr, leaving potion and third-party plugin effects untouched. - Improved compatibility with protection plugins by preventing unnecessary event spam and eliminating rare startup issues. - Significantly improved tree detection performance while enforcing configured tree size limits correctly. - Fixed version comparison for update checks, ensuring new releases are detected accurately. - Added additional safety checks to prevent errors when plugin information is unavailable. - Improved particle compatibility on older server versions with graceful fallbacks where newer effects are unsupported. - Prevented rare issues caused by invalid item drops and introduced a hard limit on animated entities to safeguard server performance. - Fixed animated tree remnants persisting after /reload. All temporary entities are now cleaned up properly during shutdown. - Resolved several issues introduced during internal refactoring, improving overall stability. - Corrected tree-felling calculations so the final log is always processed correctly, even if the player's axe breaks at the last moment. ---

Added

- Laydown Mode - Trees may now fall naturally and come to rest on the ground instead of disappearing immediately. - Branches and leaves that collide with the terrain can break into drops, whilst the remaining trunk stays intact until mined. - Added new configuration options for: - Fell mode (INSTANT or LAYDOWN) - Fall speed - Slide distance - Ground collision behaviour - Clear-path requirements - Automatic Configuration Upgrades - Missing configuration options are now added automatically during startup without overwriting existing user settings. - Because configuration files should evolve, not self-destruct. - Improved Plugin Compatibility - Added official soft dependency support for common protection plugins, ensuring a more reliable loading order. ---

Changed

- Internal systems have been reorganised to improve maintainability and reduce duplicated logic. - Improved thread safety for tree-felling operations, resulting in greater stability under heavy server load.

Timbr | Changelog - v1.0.6

This update mainly focuses on one thing: making the plugin behave properly across multiple Minecraft versions. Apparently, that's considered ambitious these days.

Added

Full support for Minecraft 1.16-latest*. * Automatic version detection to select the appropriate animation system. * Separate animation backends for modern and legacy Minecraft versions. * Startup logging to indicate which animation backend is currently in use.

Improved

* Fixed choppy tree animations caused by interpolation being reset every tick. Animations are now considerably smoother. * Improved entity tracking and processing for better stability and cleaner execution. * Refactored metadata handling to support multiple entity types. * Improved material handling to safely support both old and new Minecraft versions. * Updated the configuration to support the new cross-version animation system.

Fixed

* Prevented startup errors on older Minecraft versions caused by materials that don't exist yet. * Added version-safe particle handling with automatic fallbacks when newer particles are unavailable. * Legacy versions now use a simplified falling animation where modern rendering features are not available. One plugin. One build. Minecraft 1.16 through latest. Imagine that.

Timbr 1.0.5

This update significantly improves tree detection for large and naturally generated trees while introducing a built-in update checker.

New Features

- Added a built-in Update Checker with asynchronous version checking. - Supports both Modrinth and SpigotMC version lookup. - Added the `/timbr check` command for operators and players with the `timbr.update` permission. - Automatic update checking when the plugin starts (configurable). - Can automatically open the plugin's update page instead of downloading files directly. - Added configurable update notifications for the console. - Added configurable join notifications for operators when a new version is available.

Improvements

- Added two-queue BFS traversal to prioritize trunk detection before branches. - Improved support for 2×2 thick trunks with automatic trunk width detection. - Added height-adaptive leaf scanning for better tall tree detection. - Improved structural analysis with additional tree metrics for smarter validation. - Expanded branch support detection for thick-trunk trees. - Improved natural tree recognition, including better handling of tall conical trees. - Refactored internal tree analysis for improved reliability and maintainability.

Fixes

- Fixed a support detection issue where normal (1×1) trees could incorrectly fail structural validation. - Fixed edge cases affecting large tree harvesting. - Various internal optimizations and code cleanup.

Smarter tree detection. Built-in update notifications. Better harvesting.

Timbr v1.0.4 Changelog

What's New

- Added smoother and more natural falling tree animations. - Trees now feel heavier with improved acceleration and impact timing. - Falling direction is now influenced by the tree's natural lean. - Added subtle wind sway for a less rigid and more dynamic appearance. - Added leaf drag effects to make canopies feel softer while falling. - Added improved dust trails and leaf particle feedback. - Added staged cracking sounds before impact. - Added a new shockwave effect when trees hit the ground.

Improvements

- Improved overall animation smoothness for a cleaner visual experience. - Better particle pacing to keep effects immersive without being excessive. - Enhanced cinematic tree falling while maintaining a vanilla-friendly style. - Updated plugin version to 1.0.4.

Recommended

- Regenerate or review your config to access the new animation options.

Timbr v1.0.3

Realistic Tree Falling Animation & Java 21 Upgrade

A smoother, heavier, and more cinematic tree falling experience has arrived for Timbr ---

What's New

Fully Reworked Tree Falling Animation

Timbr now uses modern BlockDisplay rendering for dramatically smoother and more realistic tree falling animations inspired by advanced physics-based tree systems.

Rigid-Body Rotation

Entire trees now rotate naturally as one connected structure instead of collapsing in disconnected pieces.

Ultra Smooth Motion

Client-side interpolation now makes animations feel fluid and cinematic, even at high FPS.

Realistic Falling Acceleration

Trees slowly begin tipping before rapidly accelerating downward, creating a heavier and more believable collapse effect.

Advanced Rotation Physics

Custom quaternion-based rotation allows trees to tilt naturally instead of staying locked to rigid axis movement.

Cleaner Visuals

Removed floating entity shadows during animations for a cleaner and more polished appearance.

Improved Landing Impact

Heavy wood impact sounds now play when trees hit the ground or water.

Internal Cleanup

Removed obsolete FallingBlock-related handling and simplified the animation system internally.

Java 21 Support

Timbr now officially targets Java 21 for modern runtime compatibility and future stability. ---

Technical Improvements

- Migrated animation engine from FallingBlock → BlockDisplay - Improved interpolation handling - Better rotational math using JOML quaternions - Reduced visual jitter during animations - Removed deprecated listener logic - General cleanup & optimization ---

Result

Tree felling now feels: - Smoother - Heavier - More immersive - More modern - More cinematic --- Thanks for using Timbr

Timbr v1.0.2 Changelog

Realistic Rigid-Body Sideways Tree Falling Animation

---

New Features & Improvements

- Enhanced Rigid-Body Rotation Physics Trees no longer break instantly or collapse into a vertical pile. They now tilt and fall sideways based on the player's facing direction, creating a much more natural and immersive falling animation. - Custom Proportional Feedback Controller Added a custom real-time feedback controller that continuously overrides Minecraft's default gravity and entity drag to maintain precise tree alignment while rotating. - Connected Leaf Canopy Animations Leaf canopies are now included in the felling animation. An optimized single-pass BFS scanner detects and animates connected leaves falling together with the trunk. - Immersive Trailing Leaf Particles Falling leaves now emit matching environmental particles depending on tree type: - Cherry → pink petals - Crimson → crimson spores - Warped → warped spores - Overworld leaves → green spore blossom particles - Accurate Item Drop Simulation Block drops are pre-calculated before the fall animation begins, ensuring: - Fortune works correctly - Silk Touch is respected - Axe durability behaves properly - Drops appear at the final landing location - Stability & Anti-Glitch Protection Temporary FallingBlock entities are marked as non-persistent to prevent ghost blocks or chunk corruption during restarts and unloads. ---

Configuration & Customization

New options added to config.yml:

# Falling tree animation settings.
animation:
  # Enable realistic falling tree animation.
  enabled: true

  # Maximum logs to animate at once.
  max-animated-logs: 128

  # Maximum leaves to animate at once.
  max-animated-leaves: 150

  # Horizontal speed multiplier of the falling tree.
  fall-speed: 1.0

  # Enable trailing particles on falling leaves.
  leaf-particles: true

Timbr v1.0.1

A lightweight, high-performance, and vanilla-balanced tree felling plugin designed for modern Spigot/Paper servers. ---

What's New in v1.0.1?

This update introduces enterprise-grade protection integrations, smarter balancing systems, anonymous analytics, and a more immersive tree chopping experience while maintaining excellent server performance. ---

Dynamic Scaling Chopping Difficulty

Chopping down a massive jungle giant should not feel identical to breaking a single wooden fence block. Timbr now applies a seamless dynamic Mining Fatigue system while chopping natural trees.

Features

- Breaking speed scales dynamically based on tree size - Fully seamless implementation: - No potion particles - No inventory status icons - Effect instantly clears when: - the log is broken - the player switches items - the player walks away - Permanent effects from: - Elder Guardians - Beacons - other plugins are safely preserved ---

Enterprise-Grade Protection Hooks

Timbr now includes lightweight direct integrations with popular protection and locking plugins.

Supported Plugins

- WorldGuard (v7+) - GriefPrevention - Towny - LWC

Highlights

- Uses dynamic reflection to remain lightweight - No heavy external dependencies required - Compile-safe integration architecture - Automatically falls back to simulated safety events when needed - Prevents illegal tree felling inside protected regions ---

Integrated bStats Support

Integrated shaded bStats Metrics support for anonymous analytics and server statistics.

Included

- Anonymous plugin usage tracking - Secure statistics collection - Proper relocation/shading to prevent class-loading conflicts with other plugins ---

Durability Safety & Unbreaking Logic

Tree felling now follows proper vanilla durability behavior.

Features

- Axes lose durability block-by-block - Full vanilla Unbreaking calculations supported

Chance of durability damage = 1 / (Unbreaking Level + 1)

- Felling instantly stops if the axe breaks - Prevents “free chopping” exploits without a valid tool ---

Smart Natural Tree Detection

Timbr now uses an optimized BFS-based natural tree detection system.

Improvements

- Maps Minecraft 1.20 wood types directly to their natural leaves - Examples: - Oak Logs → Oak / Azalea Leaves - Crimson Stems → Nether Wart Blocks - Prevents accidental destruction of: - player builds - wooden structures - decorative log constructions ---

Updated config.yml

Add the following configuration blocks to your config.yml to enable the new systems:

# Compatibility settings for third-party land protection and lock plugins.
# If enabled, Timbr will directly query these plugins' APIs to ensure full block protection.
compatibility:
  worldguard: true
  griefprevention: true
  towny: true
  lwc: true

# Dynamic chopping difficulty:
# makes larger trees take longer to break by applying scaling mining fatigue.
chopping-difficulty:
  enabled: true

  # Mining Fatigue Level = min(max-amplifier, tree_logs / scale-factor)
  # Example:
  # With scale-factor 15,
  # a 30-log tree gives Fatigue II (amplifier 1)
  scale-factor: 15

  # Maximum Mining Fatigue amplifier
  # 0 = Level I
  # 1 = Level II
  # Recommended maximum: 4 (Level V)
  max-amplifier: 4

---

Thank You for Using Timbr

Timbr

Modern tree cutting for Minecraft. Timbr is a lightweight, fast, and vanilla-friendly timber plugin built for modern survival servers. Cut down entire trees smoothly using intelligent tree detection, sneak-to-chop mechanics, vanilla balancing, and optimized performance. No overpowered instant-tree exploits. No accidental house destruction. No laggy chain-breaking chaos. Just clean, satisfying tree felling that feels like it belongs in vanilla Minecraft. ---

Sneak-to-Chop

By default, players must crouch/sneak while breaking a log with an axe to trigger tree felling. This simple mechanic acts as a natural safety system: * normal building remains safe, * accidental destruction is prevented, * and tree felling always feels intentional. Configurable modes: * REQUIRED * INVERTED * DISABLED ---

Natural Tree Detection

Timbr intelligently checks for matching leaves before felling a tree. This prevents: * log cabin destruction, * decorative pillar breaking, * accidental structure griefing, * and other common timber plugin disasters. No leaves? No full tree felling. Simple. ---

Vanilla-Friendly Balancing

Timbr is designed to respect Minecraft survival gameplay.

Features:

* Axe durability is consumed per log * Fully supports Unbreaking enchantments * Optional hunger exhaustion * Automatic stop when the axe breaks Large trees should feel satisfying to chop, not free. ---

Optimized Performance

Large jungle and dark oak trees are handled using an optimized BFS traversal system designed to minimize lag spikes. Performance optimizations include: * Single-pass tree scanning * Smart leaf short-circuiting * Configurable max log limits * Optional downward-breaking restriction Built for modern Paper servers. ---

Protection Plugin Compatibility

Timbr safely integrates with protection plugins by triggering BlockBreakEvent checks for every broken log. Compatible with: * WorldGuard * GriefPrevention * Towny * LWC * and many more If another plugin cancels the block break, Timbr safely skips that block. ---

Immersive Effects

Optional cosmetic feedback includes: * Wood breaking sounds * Tree creaking sounds * Block particles Simple, subtle, and satisfying. ---

Supported Platforms

* Paper 1.20+ * Purpur * Pufferfish Experimental Folia support may arrive in future versions. ---

Why Timbr?

Most timber plugins: * feel outdated, * ignore survival balance, * break player builds, * or cause unnecessary lag. Timbr focuses on doing one thing properly:

Making tree cutting feel smooth, intentional, balanced, and modern.

---

Planned Features

* Automatic sapling replanting * Expanded animations * Additional balancing options * Custom tree compatibility * Experimental Folia support ---

Timbr

Fast. Smart. Natural.