Logically - Realistic Tree Cutting v1.29.1

#
#     /$$                           /$$                     /$$ /$$
#    | $$                          |__/                    | $$| $$
#    | $$        /$$$$$$   /$$$$$$  /$$  /$$$$$$$  /$$$$$$ | $$| $$ /$$   /$$
#    | $$       /$$__  $$ /$$__  $$| $$ /$$_____/ |____  $$| $$| $$| $$  | $$
#    | $$      | $$  \ $$| $$  \ $$| $$| $$        /$$$$$$$| $$| $$| $$  | $$
#    | $$      | $$  | $$| $$  | $$| $$| $$       /$$__  $$| $$| $$| $$  | $$
#    | $$$$$$$$|  $$$$$$/|  $$$$$$$| $$|  $$$$$$$|  $$$$$$$| $$| $$|  $$$$$$$
#    |________/ \______/  \____  $$|__/ \_______/ \_______/|__/|__/ \____  $$
#                         /$$  \ $$                                 /$$  | $$
#                        |  $$$$$$/                                |  $$$$$$/
#                        \______/                                  \______/
#
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!