ВЕРСИИ (16)

### Fixed * Fixed `AnimationEngine` not working on Folia. * Replaced legacy Bukkit scheduler with `SchedulerUtil`. * Updated progress task handling to use `SchedulerTask`. Reported by Sonikki.

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`: ```yaml # 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 ```text 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: ```yaml # 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.