Might not be 100% up-to-date as new features might have been added
Code (YAML):
#
# /$$ /$$ /$$ /$$
# | $$ |__/ | $$| $$
# | $$ /$$$$$$ /$$$$$$ /$$ /$$$$$$$ /$$$$$$ | $$| $$ /$$ /$$
# | $$ /$$__ $$ /$$__ $$| $$ /$$_____/ |____ $$| $$| $$| $$ | $$
# | $$ | $$ \ $$| $$ \ $$| $$| $$ /$$$$$$$| $$| $$| $$ | $$
# | $$ | $$ | $$| $$ | $$| $$| $$ /$$__ $$| $$| $$| $$ | $$
# | $$$$$$$$| $$$$$$/| $$$$$$$| $$| $$$$$$$| $$$$$$$| $$| $$| $$$$$$$
# |________/ \______/ \____ $$|__/ \_______/ \_______/|__/|__/ \____ $$
# /$$ \ $$ /$$ | $$
# | $$$$$$/ | $$$$$$/
# \______/ \______/
#
debug
: false
update-checker
: true
# Currently available languages: en_US, es_ES, uk_UA, cs_CZ, pl_PL, bg_BG, ro_RO, ca_ES, fr_FR, ru_RU
locale
: en_US
# Whether to have the tree cutting enabled
# for new players (as the default)
first-join-enable
: true
heuristics
:
# Each entry defines a tree type: which log/leaf/sapling materials it uses,
# and the initial bounding box (diameter + height) for log discovery.
# Materials unknown to the running server version are silently ignored,
# so version-gated entries (e.g. PALE_OAK) are safe to leave here for all servers.
#
# Both values should not be bigger than the smallest specimen of that tree type.
#
# diameter — total horizontal search width; the plugin searches diameter/2 blocks
# in each of the 4 horizontal directions from the chopped log.
# height — maximum upward search distance from the base log.
#
# Custom / mixed-wood type example:
# MIXED:
# logs: [OAK_LOG, BIRCH_LOG, OAK_WOOD, BIRCH_WOOD]
# leaves: [OAK_LEAVES, BIRCH_LEAVES]
# sapling: OAK_SAPLING
# diameter: 2
# height: 4
tree-types:
OAK:
logs
:
- OAK_WOOD
- STRIPPED_OAK_WOOD
- OAK_LOG
- STRIPPED_OAK_LOG
leaves
:
- OAK_LEAVES
- BEE_NEST
- AZALEA_LEAVES
- FLOWERING_AZALEA_LEAVES
sapling
: OAK_SAPLING
diameter
: 2
height
: 4
BIRCH:
logs
:
- BIRCH_WOOD
- STRIPPED_BIRCH_WOOD
- BIRCH_LOG
- STRIPPED_BIRCH_LOG
leaves
:
- BIRCH_LEAVES
- BEE_NEST
sapling
: BIRCH_SAPLING
diameter
: 2
height
: 4
SPRUCE:
logs
:
- SPRUCE_WOOD
- STRIPPED_SPRUCE_WOOD
- SPRUCE_LOG
- STRIPPED_SPRUCE_LOG
leaves
:
- SPRUCE_LEAVES
sapling
: SPRUCE_SAPLING
diameter
: 6
height
: 16
JUNGLE:
logs
:
- JUNGLE_WOOD
- STRIPPED_JUNGLE_WOOD
- JUNGLE_LOG
- STRIPPED_JUNGLE_LOG
leaves
:
- JUNGLE_LEAVES
- COCOA
- VINE
sapling
: JUNGLE_SAPLING
diameter
: 6
height
: 24
DARK_OAK:
logs
:
- DARK_OAK_WOOD
- STRIPPED_DARK_OAK_WOOD
- DARK_OAK_LOG
- STRIPPED_DARK_OAK_LOG
leaves
:
- DARK_OAK_LEAVES
sapling
: DARK_OAK_SAPLING
diameter
: 4
height
: 12
ACACIA:
logs
:
- ACACIA_WOOD
- STRIPPED_ACACIA_WOOD
- ACACIA_LOG
- STRIPPED_ACACIA_LOG
leaves
:
- ACACIA_LEAVES
sapling
: ACACIA_SAPLING
diameter
: 6
height
: 14
CHERRY:
logs
:
- CHERRY_WOOD
- STRIPPED_CHERRY_WOOD
- CHERRY_LOG
- STRIPPED_CHERRY_LOG
leaves
:
- CHERRY_LEAVES
- BEE_NEST
sapling
: CHERRY_SAPLING
diameter
: 6
height
: 14
MANGROVE:
logs
:
- MANGROVE_WOOD
- STRIPPED_MANGROVE_WOOD
- MANGROVE_LOG
- STRIPPED_MANGROVE_LOG
leaves
:
- MANGROVE_LEAVES
- MOSS_CARPET
- BEE_NEST
sapling
: MANGROVE_PROPAGULE
diameter
: 2
height
: 4
PALE_OAK
:
# Requires Minecraft 1.21.4+; safely ignored on older versions
logs
:
- PALE_OAK_WOOD
- STRIPPED_PALE_OAK_WOOD
- PALE_OAK_LOG
- STRIPPED_PALE_OAK_LOG
leaves
:
- PALE_OAK_LEAVES
- CREAKING_HEART
- RESIN_CLUMP
sapling
: PALE_OAK_SAPLING
diameter
: 4
height
: 12
CRIMSON:
logs
:
- CRIMSON_HYPHAE
- STRIPPED_CRIMSON_HYPHAE
- CRIMSON_STEM
- STRIPPED_CRIMSON_STEM
leaves
:
- NETHER_WART_BLOCK
- SHROOMLIGHT
- WEEPING_VINES
sapling
: CRIMSON_FUNGUS
diameter
: 2
height
: 4
WARPED:
logs
:
- WARPED_HYPHAE
- STRIPPED_WARPED_HYPHAE
- WARPED_STEM
- STRIPPED_WARPED_STEM
leaves
:
- WARPED_WART_BLOCK
- SHROOMLIGHT
- TWISTING_VINES
sapling
: WARPED_FUNGUS
diameter
: 2
height
: 4
# Minima of each to be considered a tree
minimum-logs
: 4
minimum-leaves
: 12
# Less is better for performance, but too little won't capture the whole tree
# More might be needed for larger (custom world generated) trees
# 25 is a balanced value
search-attempts
: 25
# Checks whether leaves have been placed by a player (persistent)
# and excludes them from the search. Leave enabled unless It's causing problems
leaves-persistence-check
: true
# The same but for wood blocks
wood-player-placed-check
: true
# Good value is about 75% of total threads
leaf-proximity-threads
: 8
# Don't change unless you know what you're doing
leaf-voxel-size
: 4
break
:
# Materials used for chopping trees
# Will get overridden if you have special items plugin like Oraxen or Nexo, see integrations section
# If left empty, will work with any item including empty hand
materials
:
- WOODEN_AXE
- STONE_AXE
- COPPER_AXE
- IRON_AXE
- GOLDEN_AXE
- DIAMOND_AXE
- NETHERITE_AXE
# Available options:
# BOTH
# CROUCH
# STAND
pose
:
"BOTH"
# At what height above root can you chop down the whole tree
max-height
: 3
# Whether the axe damage is calculated for every trunk block of the tree
proportional-axe-damage
: true
axe-damage-multiplier
: 1.0
# If the act were to break the axe, leave it at 1 durability
axe-have-mercy
: true
# Slow-breaking animation proportional to tree size
slow:
enabled
: false
time-multiplier
: 1.0
# In seconds, max time it takes to chop down a tree, regardless of size
time-cap
: 20
# The actual text for bossbar and actionbar can be found in locales
# options:
# NONE
# BOSSBAR
# ACTIONBAR
progress-indicator:
type
:
"BOSSBAR"
# Precision in decimal places for %time% placeholder in text
time-decimals
: 2
bossbar
:
# options: PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE
color
:
"GREEN"
# options: PROGRESS, NOTCHED_6, NOTCHED_10, NOTCHED_12, NOTCHED_20
overlay
:
"PROGRESS"
animation
:
# Controls in which direction the tree falls.
# The plugin tries the preferred direction first; if it cannot be determined
# (e.g. perfectly centred bounding-box, or player standing exactly on the root)
# it falls back to the alternative direction.
#
# Options:
# HEAVIEST_SIDE — fall toward the side with the most blocks (legacy default)
# RANDOM — pick a random XZ direction each time
# AWAY_FROM_PLAYER — fall away from the player who chopped the tree
# TOWARDS_PLAYER — fall toward the player who chopped the tree
# NORTH / NORTH_EAST / EAST / SOUTH_EAST / SOUTH / SOUTH_WEST / WEST / NORTH_WEST — fixed cardinal directions
preferred-fall-direction
:
"HEAVIEST_SIDE"
alternative-fall-direction
:
"RANDOM"
# In degrees
initial-angle
: 0.06
# Gravitational constant
g
: 9.81
# In milliseconds, set to 0 to disable
# Amount of time the tree will spend lying on ground
# before being turned into items / blocks.
drop-items-delay
: 0
glow:
trunk:
enabled
: false
color
: AQUA
leaves:
enabled
: false
color
: YELLOW
collision-check:
sensitivity
: 1.1
particles:
enabled
: true
# Per block per tick
amount
: 1
# Percentage (yes, default is 2%)
chance
: 2.0
spread
: 0.5
# Whether falling tree should deal damage
damage:
players
: true
entities
: false
# At what min. angle should the tree start to damage
# Players / Entities in its path, in degrees
min-angle
: 15.0
# Damage in Hearts
value
: 3.0
post-fall:
drop-bee-nest
: false
# options:
# LOCAL(where each block fell)
# ORIGIN(where the tree was chopped)
# INVENTORY
# TURN_INTO_BLOCKS
drop-location
:
"LOCAL"
auto-replant:
enabled
: true
# When true, it will replant 2x2+, if false, then just 1 sapling
large-trees
: true
# Should auto-replanted saplings become unbreakable?
# Players with logically.replant.break can still break saplings
sapling-protection
: false
enchantment:
enabled
: false
name
:
"Fell_Strike"
# Higher weight means higher chance to get this enchantment
weight
: 5
min-cost:
base
: 1
per-level-above-first
: 1
max-cost:
base
: 51
per-level-above-first
: 10
anvil-cost
: 4
enchantment-table
: true
villager-trades
: true
loot
: true
# Tag of items this enchantment can be applied to via anvil / /enchant.
# Use a tag reference: "#minecraft:axes", "#minecraft:tools", etc.
supported-item
:
"#minecraft:axes"
# When true, players holding an item enchanted with Fell Strike do not need
# to have chopping enabled via commands (/log enable) to chop trees.
disable-commands
: false
# When true, players holding an item enchanted with Fell Strike bypass the
# logically.use permission check entirely.
disable-permissions
: false
sounds:
creak:
enabled
: true
volume
: 3.0
pitch
: 0.7
# If more than one sound is present, it will be chosen at random
keys
:
-
"entity.creaking.activate"
-
"entity.creaking.twitch"
-
"entity.creaking.sway"
-
"entity.creaking.ambient"
rustle:
enabled
: true
volume
: 1.0
pitch
: 1.0
keys
:
-
"block.azalea_leaves.fall"
-
"block.pale_hanging_moss.idle"
fall:
enabled
: true
volume
: 1.0
pitch
: 0.2
keys
:
-
"entity.zombie.break_wooden_door"
# Integrations with various third-party plugins
integrations
:
# Packet interception backend for the slow-break animation and tool-break FX.
# AUTO - Vanilla NMS on Paper 26.1+; PacketEvents if present, then ProtocolLib on older servers.
# VANILLA - Always use Vanilla NMS (requires Paper 26.1+, no extra plugin needed).
# PROTOCOL_LIB - Always use ProtocolLib (requires ProtocolLib to be installed).
# PACKET_EVENTS - Always use PacketEvents (requires PacketEvents to be installed).
packet-backend
:
"AUTO"
# If you uncomment any, don't forget to remove [] square brackets
protection
:
[
]
# - SimpleClaimSystem
# - ProtectionStones
# - GriefPrevention
# - CoreProtect
# - WorldGuard
# - AegisGuard
# - Lands
# - Towny
# - GriefDefender
# If enabled, only items with these IDs will be able to chop down trees
custom-items:
hook
:
"None"
# None
# Oraxen
# Nexo
# ItemsAdder
# MMOItems
item-ids
:
[
]
# Example
# - "onyx_axe"
misc:
WorldGuard-regions
:
# WHITELIST
# BLACKLIST
mode
:
"BLACKLIST"
# List of region names
list
:
[
]
# If enabled, only players with this ability will be able to chop down trees
# IMPORTANT: Add 'logically/lumbermaster' under abilities of a skill in skills.yml for this to work!
# I recommend to put this ability under skill 'Foraging'
# Changes here will only apply after server restart
AuraSkills:
enabled
: false
# How much skill xp should each block of broken tree with the ability give
xp-per-block
: 10.0
name
:
"Lumber Master"
description
:
"Chop down entire trees at once. Get more wood per level!"
info
:
"+{value}% extra items"
# Value when at level 1
baseValue
: 0
# Value added per ability level
valuePerLevel
: 10
# Skill level ability unlocks at
unlock
: 6
# Skill level interval between ability level ups
levelUp
: 5
# 0 = unlimited max level, but capped by the max skill level
maxLevel
: 10
# Will only take effect after server restart
command
:
# First name will be the main command name, and the rest will be aliases.
names
:
-
"logically"
-
"log"
-
"tc"
-
"treecutter"
description
:
"Toggle cutting trees whole."
usage
:
"/<command> <args>"
# Thank you for your purchase!