Changelog

All notable changes to this project are documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

Nothing yet.

1.1.0 - 2026-08-24

Build protection release. Player-built log structures are no longer mistaken for trees.

Fixed

• Player-built log structures were felled as if they were trees. Leaf validation swept a 9x9x9 cube around the treetop and accepted any matching leaves it found anywhere inside it, so a log wall, pillar or cabin standing near foliage passed as a valid tree (scripts/leafScanner.js).

Added

• Canopy attachment check. Leaves only count when they directly touch the upper logs, and the topmost log must itself be covered by leaves. Config: minimumCanopyLeaves, canopyAnchorDepth, requireLeavesOnTopLog, minimumTopLogLeaves.
• Foundation check. A log cluster resting on planks, bricks, cobblestone, concrete or other build materials is never felled. Config: rejectStructureFoundation, groundSearchDepth.
• Build-material contact check. Build blocks touching the log cluster are counted; past the threshold the cluster is treated as part of a structure. Config: detectPlayerStructures, maxStructureContacts.
• Wall-shape check. Clusters made of many tall log columns are treated as walls rather than trunks. Config: maxTallColumns.
• Minimum tree shape requirements. Config: minimumLogCount, minimumTrunkHeight.
• scripts/structureGuard.js holding the build-detection helpers, including natural-block exemptions for pale moss carpet, bee nests and mangrove roots.
• columnsWithHeightThreeOrMore metric in buildTreeMetrics.

Changed

• Canopy validation reads 26 neighbours per top log instead of 729 offsets per anchor, removing up to several thousand synchronous block reads per break.
• validateTreeCandidate now takes canopy, foundation and structureContacts instead of validationLeafCount.
• Debug logging reports canopy counts, the detected foundation block and the structure contact count.
• Build protection runs before the safeMode early return, so disabling safeMode no longer disables house protection.

Removed

• minimumLeafCount and leafDetectionRadius config options, superseded by the canopy settings above.
• countValidationLeaves, replaced by inspectCanopy.

Known limitations

• A build made only of bare logs, standing on natural ground, with leaves resting on top and nothing else attached, remains indistinguishable from a grove and can still be felled. Sneak while breaking, or build with bark (_wood) blocks, which the pack never fells.

1.0.0 - 2026-08-18

Initial release.

Added

• Behavior pack built on the stable @minecraft/server Script API.
• Bounded tree scanning with safety validation.
• Supported overworld tree definitions and vanilla axes.
• Vanilla loot generation for extra logs and leaves.
• Unbreaking-aware durability handling.
• Multi-tick tree felling with concurrency protection.
• README and packaged .mcpack output target.

Changed

• Lowered the manifest dependency floor to @minecraft/server 2.2.0 for broader Bedrock compatibility while keeping LootTableManager support.