1.12.2-3.2.0

[1.12.2-3.2.0]

• Add 4 new break modes backported from 1.21.11: FALL_ITEM, FALL_ITEM_STRAIGHT, FALL_BLOCK, FALL_ALL_BLOCK
  • FALL_ITEM: Logs drop as items with a falling block animation (random spread)
  • FALL_ITEM_STRAIGHT: Same as FALL_ITEM but blocks fall straight down
  • FALL_BLOCK: Logs fall as blocks and drop items on landing; leaves drop as items
  • FALL_ALL_BLOCK: Both logs and leaves fall as blocks (leaves don't drop items)
• All FALL modes respect DurabilityMode, minSize, maxSize, and MaxSizeAction settings
• Speed multiplier now applies to FALL modes as well
• Updated config comments and lang files (en_us, ja_jp, fr_fr) with new mode descriptions

Full Changelog: 1.12.2-3.1.0...1.12.2-3.2.0

1.12.2-3.1.0

FallingTree (Unofficial) [1.12.2-3.1.0] - 2026-02-18

Added

• SneakMode enum (SNEAK_DISABLE, SNEAK_ENABLE, IGNORE) — replaces the old reverse_sneaking boolean. Allows more flexible control over sneaking behavior.
• NotificationMode enum (CHAT, ACTION_BAR, NONE) — choose how notifications are displayed to the player. Default: ACTION_BAR.
• DurabilityMode enum (ABORT, SAVE, NORMAL, BYPASS) — replaces the old preserve boolean. Provides fine-grained control over tool durability handling.
• MaxSizeAction enum (ABORT, CUT) — configures behavior when a tree exceeds logs_max_count. ABORT cancels felling (old behavior), CUT fells up to the max size.
• max_scan_size config option (default: 500) — limits BFS scan during tree detection to prevent lag on very large structures.
• min_size config option (default: 0) — minimum number of logs required for tree felling. Smaller trees are broken normally.
• chat.falling_tree.tree_too_small chat message for all 3 languages (en_us, ja_jp, fr_fr).
• Japanese and French translations for all new config options.

Changed

• reverse_sneaking (boolean) replaced by sneak_mode (SneakMode enum) in general config.
• preserve (boolean) replaced by durability_mode (DurabilityMode enum) in tools config.
• All player notifications now go through notifyPlayer() helper, respecting notification_mode setting.
• Updated README.md with current config documentation, backport attribution, and license compatibility note (LGPL-3.0 → GPL-3.0).

Removed

• reverse_sneaking config option and isReverseSneaking() getter (replaced by sneak_mode).
• preserve config option and isPreserve() getter (replaced by durability_mode).
• Old lang entries for reverse_sneaking and preserve.

Notes

• Features backported from FallingTree 1.21.11 (LGPL-3.0, by RakSrinaNa). Compatible with GPL-3.0 per LGPL-3.0 Section 2(b).
• Breaking change: Existing config files with reverse_sneaking or preserve will need to be updated to use the new enum values.

[1.12.2-3.0.0] - 2026-02-18

Added

• minimum_leaves_ratio config option (default: 0.1) — minimum ratio of logs that must have at least one adjacent leaf block. Distinguishes natural trees from player-placed log columns. Set to 0 to disable.
• @Config.LangKey annotations for all config entries.
• Lang entries (en_us, ja_jp, fr_fr) for minimum_leaves_ratio and all existing config options.

Changed

• Migrated build environment to ForgeDevEnv (RetroFuturaGradle). Updated Gradle wrapper, build scripts, and project structure.
• Leaf detection now ignores player-placed (persistent) leaves — only naturally decayable leaves count for tree validation.
• Extracted config sync logic into ConfigEventHandler class.

Fixed

• Fixed minimumLeavesRatio not working correctly on large trees.
• Fixed leaves ratio default value (changed from 1.0 to 0.1 for practical use).

---

Full Changelog: https://github.com/Sumire-Labs/FallingTree-Unofficial/commits/1.12.2-3.1.0