Overview#
FallingTree is a modern utility mod designed to simplify the tedious process of wood gathering in Minecraft. By breaking a single log block of a tree, the mod triggers a chain reaction that breaks all connected log and leaf blocks. It is designed with compatibility in mind, supporting both vanilla trees and those added by other mods.
The mod is highly customizable, allowing server administrators and players to decide whether tools are required, how durability is affected, and whether the felling process should be instant or based on the tree's size.
Core Mechanics#
The primary mechanic of FallingTree is the 'Felling' action. When a player breaks a log block that is part of a valid tree structure, the mod scans for connected logs and leaves to destroy them simultaneously.
Felling Logic
- Tree Detection: The mod identifies a 'tree' as a vertical column of logs. It can distinguish between natural trees and player-placed blocks based on configuration settings.
- Tool Requirement: By default, an axe is required to trigger the felling effect. Breaking a log with a bare hand or a non-axe tool will only break that specific block.
- Sneaking Interaction: The mod includes a 'Sneak to Disable' (or 'Sneak to Enable') feature. By default, holding the sneak key (Shift) while chopping will prevent the tree from falling, allowing players to harvest single blocks for building.
- Leaf Decay: When a tree is felled, the mod can be configured to instantly destroy the associated leaves, dropping saplings and sticks as if they had decayed naturally.
Durability and Balancing
To maintain game balance, FallingTree applies the following rules:
- Durability Loss: The tool used to chop the tree loses durability for every single log block broken in the process. If the tool's durability reaches zero during the process, the felling stops.
- Mining Speed: The time it takes to break the initial log can be dynamically adjusted based on the total number of logs in the tree, simulating the effort required to take down a larger structure.
Items and Blocks#
FallingTree does not add new items or blocks to the game. Instead, it enhances the functionality of existing vanilla and modded items.
Affected Tools
| Tool Type | Effect |
|---|---|
| Axes | Triggers the felling mechanic. All tiers (Wood to Netherite) are supported. |
| Modded Axes | Any item tagged under minecraft:axes or forge:tools/axes will trigger the effect. |
Affected Blocks
| Block Category | Behavior |
|---|---|
| Logs | The primary trigger. Breaking one breaks all connected logs of the same type. |
| Leaves | Automatically destroyed when the parent tree is felled, provided the breakLeaves config is enabled. |
| Modded Logs | Compatible with blocks tagged as minecraft:logs. |
Configuration#
The mod is controlled via a configuration file (typically found in config/fallingtree-common.toml). This allows for extensive fine-tuning of the mod's behavior.
General Settings
| Option | Default | Description |
|---|---|---|
miningSpeedModifier |
1.0 | Multiplier for how much the tree size affects mining speed. |
ignoreItems |
false | If true, any tool (or hand) can fell a tree. |
damageMultiplier |
1.0 | Multiplier for durability damage dealt to the tool. |
Tree Settings
| Option | Default | Description |
|---|---|---|
breakLeaves |
true | Whether leaves should be destroyed along with the logs. |
maxLogCount |
200 | The maximum number of logs a tree can have before the mod ignores it (prevents lag). |
reverseSneaking |
false | If true, you must sneak to fell the tree. If false, sneaking disables felling. |
instantBreak |
true | If true, all blocks break at once. If false, they break sequentially. |
Whitelists and Blacklists
Players can define specific blocks or tools that should be ignored by the mod using the internal tag system or the config file's whitelistedTools and blacklistedLogs sections.
Commands#
FallingTree provides several commands for in-game management. These generally require Level 2 operator permissions.
/fallingtree help: Displays a list of available commands and their functions./fallingtree reload: Reloads the configuration file from the disk. This is useful for applying changes without restarting the server./fallingtree settings <setting> <value>: Allows players to change specific configuration values directly from the chat console.
Compatibility#
FallingTree is built to be highly compatible with the Minecraft ecosystem:
- Modded Biomes: Works seamlessly with trees from Biomes O' Plenty, Oh The Biomes You'll Go, and TerraBlender.
- Enchantments: Respects the Efficiency enchantment (increasing break speed) and the Silk Touch/Fortune enchantments (affecting leaf drops).
- Protection Plugins: Respects land claim mods (like FTB Chunks or GriefPrevention). If a player cannot break a block in a protected area, the felling mechanic will not trigger.
