Allowed logs |
Allows you to define a list of allowed blocks that are considered as logs by the mod. By default, every block tagged as #minecraft/logs (Minecraft Wiki) will be recognized by default. If it doesn’t, you’ll have to add it yourself or ask the mod author to tag its blocks accordingly.
Note
|
This will only add values in allow list on top of the already existing default recognized blocks, if you need to exclude logs look for the Denied logs .
|
The list will contain values under the minecraft resource location format :
Tip
|
You can find this info by enabling detailed info on blocks by pressing F3 + H and hover the block in your inventory.
|
|
Denied logs |
This works similarly to the Allowed logs section except that here you define blocks that will never be considered as logs by the mod.
Note
|
Deny list takes over the values defined in allow list. So if you defined the same block in allow and deny lists it’ll end up denied.
|
|
Allowed leaves |
Allows you to define a list of allowed blocks that are considered as leaves by the mod. By default, every block tagged as #minecraft/leaves (Minecraft Wiki) will be recognized by default. If it doesn’t, you’ll have to add it yourself or ask the mod author to tag its blocks accordingly.
Note
|
This will only add values in allow list on top of the already existing default recognized blocks, if you need to exclude leaves look for the Denied leaves .
|
The list will contain values under the minecraft resource location format :
Tip
|
You can find this info by enabling detailed info on blocks by pressing F3 + H and hover the block in your inventory.
|
|
Allowed leaves (needs breaking) |
This is similar to Allowed leaves except that here you define values of leaves that needs to be broken because they do not decay over time. This would for example be the case fot the nether trees that got warts as leaves, and it doesn’t decay.
|
Denied leaves |
This works similarly to the Denied leaves section except that here you define blocks that will never be considered as leaves by the mod.
Note
|
Deny list takes over the values defined in allow list. So if you defined the same block in allow and deny lists it’ll end up denied.
|
|
Break mode |
Defines how the tree will be cut when you chop down one of its logs.
Note
|
In the screenshots the axe indicates where the tree is being cut by you.
|
-
INSTANTANEOUS: The whole tree will be chopped at once.
![break mode instantaneous](https://github.com/RakambdaOrg/FallingTree/wiki/assets/behavior/break-mode-instantaneous.png)
-
FALL_ITEM: Same as INSTANTANEOUS but blocks will look like falling on the ground. Best used with break_order=LOWEST_FIRST .
-
FALL_BLOCK: Same as INSTANTANEOUS but blocks will fall on the ground and not all will be broken, leaves will drop as items. Best used with break_order=LOWEST_FIRST .
-
FALL_ALL_BLOCK: Same as INSTANTANEOUS but logs will fall on the ground and not all will be broken. Best used with break_order=LOWEST_FIRST .
-
SHIFT_DOWN: The furthest log will be broken. This allows you to still cut the tree one by one, but you don’t have to climb to get all the logs; just aim at one spot and cut it multiple times.
![break mode shift down](https://github.com/RakambdaOrg/FallingTree/wiki/assets/behavior/break-mode-shift-down.png)
Note
|
Those modes are conditioned by Detection mode .
|
|
Detection mode |
Defines how the tree is being scanned.
Note
|
In the screenshots the axe indicates where the tree is being cut by you, and the red signs indicates the logs that WON’T be broken.
|
-
WHOLE_TREE: The whole tree will be scanned, searching in all 6 directions.
![detection mode whole tree](https://github.com/RakambdaOrg/FallingTree/wiki/assets/behavior/detection-mode-whole-tree.png)
-
ABOVE_CUT: Will search in all directions except at the cutting point where it’ll only look up.
![detection mode above cut](https://github.com/RakambdaOrg/FallingTree/wiki/assets/behavior/detection-mode-above-cut.png)
-
ABOVE_Y: Will search in all directions but retain only logs with a y value greater than the cutting point.
![detection mode above y](https://github.com/RakambdaOrg/FallingTree/wiki/assets/behavior/detection-mode-above-y.png)
|
Max scan size |
The maximum number of blocks to scan when trying to detect a tree. If there’s more than this value the tree won’t be cut.
|
Max (break) size |
The maximum size of a tree. If a tree with more elements than this value is attempted to be cut, the mod will refuse to do it.
Note
|
Only applied in Instantaneous breaking mode.
|
|
Max size action |
What to do when the max size of a tree is reached.
|
Maximum leaf distance from log |
The maximum distance a leaf can be from the tree. This only affects scanning a tree.
|
Max size order |
In what order logs are broken.
This only makes sense if maxSize < maxScanSize .
-
FURTHEST_FIRST: The furthest log will be broken first.
-
CLOSEST_FIRST: The closest log will be broken first.
-
LOWEST_FIRST: The lowest log will be broken first.
Note
|
Only applied in Instantaneous breaking mode.
|
|
Minimum leaves around required |
Defines how many leaves should be around the top most log of the tree. If not enough leaves are found, then the broken block won’t be considered as part of a tree.
This value can be useful for people that have houses made of logs and doesn’t want to chop it all down in one cut.
Note
|
Only applied in Instantaneous breaking mode.
|
|
Include persistent leaves in required count |
If this is true leaves with the persistent flag (player placed or sheared) will be counted in the minimum leaves required counter. Otherwise, they won’t.
|
Trunk breaking |
Defines if the mod should cut trees in one cut.
|
Leaves breaking |
Define if leaves should decay faster than they normally do.
|
Leaves breaking force radius |
If you want leaves to be broken (and no decayed) by the mod, you can define a radius around which leaves are broken.
I highly discourage using this feature as it’ll cut leaves in a not so elegant way. You should probably first try to add the problematic leaves in Allowed leaves (needs breaking) .
Warning
|
This will break leaves placed by a player.
|
Note
|
Leaves breaking must be activated.
NOTE: This only works in the Instantaneous breaking mode.
|
|
Allow trunks with mixed log blocks |
Defines if a tree can be composed of different log types or not.
|
Break nether tree warts |
Defines if the nether tree warts should be broken when the trunk is cut.
Note
|
Durability will be used
|
Note
|
The warts don’t decay, so they will be broken with a predefined radius which may leave things a bit ugly if you cut nether trees that are close to each other.
|
|
Instantly break nether tree warts |
When set to true nether tree warts (leaves) will be broken with only one hit.
Note
|
Only applied in Shift down breaking mode.
|
|
Break mangrove roots |
Defines if the mangrove roots should be broken when the trunk is cut.
Note
|
Durability will be used
|
|
Search area radius |
Defines the radius in which the tree is scanned.
|
Adjacent blocks allowed |
Defines a list of blocks that are allowed to be next to the trunk. If a block that isn’t allowed is encountered, the behavior defined in Adjacent stop mode will be applied.
Note
|
If the list is empty, then no restrictions will be applied (ie: all blocks are allowed).
|
The list will contain values under the minecraft resource location format :
Tip
|
You can find this info by enabling detailed info on blocks by pressing F3 + H and hover the block in your inventory.
|
|
Adjacent stop mode |
Defines the behavior to apply when a not allowed adjacent block is found.
|