?
Host a serverModrinth App
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
BetterTimber

BetterTimber

Tree feller / TreeCapitator for Paper & Folia 26.x: chop down a whole tree by breaking one log. Protection-plugin safe, player-built logs stay safe. Optional Timber enchantment add-on.

3.2Kdownloads
8followers
3.2Kdownloads
8followers

Compatibility

Minecraft: Java Edition

26.3
26.2
26.1.x
1.21.10–1.21.11
1.21–1.21.4

Platforms

Links

Buy Me a Coffee

Tags

Creators

Details

Licensed MIT
Published 2 years ago
Updated 2 days ago

BetterTimber

bStats Servers bStats Players Minecraft versions

Tree feller / TreeCapitator for Paper, Purpur and Folia 26.x. Break one log and the whole tree comes down - with a smooth, vanilla-style animation. Completely customizable.

Preview

Preview Preview

How it works

If a player has a netherite axe with Efficiency V, Fortune III, Unbreaking III and Mending (default, change it in the config), the whole tree is felled by breaking only one log.

You can also allow every axe - enchanted or not - or even bare hands.

Timber enchantment (add-on)

Want players to earn the lumberjack ability? Install the add-on BetterTimberEnchantment: it adds the Timber enchantment for axes (enchanting table, librarian villagers, loot) and only axes with Timber fell whole trees. Without the add-on BetterTimber works exactly as before.

Features

  • Automatically recognises world-generated trees, also 2x2 and larger trees and all new wood types
  • Built-in animation that keeps the vanilla survival style, speed depends on the axe type
  • Safe for your builds: player-placed logs and log houses next to trees are never felled (also after a restart)
  • Respects protection plugins like WorldGuard or GriefPrevention - every log fires its own block break event, so logging plugins like CoreProtect record it too
  • Correct durability: per tree or per log, respects Unbreaking, the axe breaks when it's used up
  • Sneaking skips the animation (can be disabled)
  • Dropping the axe stops the animation
  • Folia support - one jar for Paper, Purpur and Folia
  • MiniMessage formatting: gradients, hex colors and more - classic & codes still work
  • English, German, French, Spanish, Polish, Russian, Portuguese, Turkish and Chinese included, add your own language with one file
  • Lightweight: no recursion, cached materials, nothing runs while no tree is felled
  • Optional auto update from Modrinth (off by default, checked with SHA-512) - new config options are added automatically, your values are kept
  • Fast leaf decay - the leaves of a felled tree decay within seconds (leaves of other trees and placed leaves stay)

Commands & permissions

  • /bettertimber reload (alias /bt) - reloads config and messages, permission bettertimber.reload (OP by default)
  • Players need no permission - everyone with a valid axe can fell trees.

Requirements

  • Paper, Purpur or Folia 26.1 - 26.3
  • Java 25

Bug report & support

If you need help or have a bug please contact me via discord (add hassanbwo). I will guarantee quick help - Thanks for supporting :)

config.yml

Add the axe types that may fell trees and the enchantments they need. Leave both lists empty to allow every axe.

# ==========================================
# BetterTimber – config.yml
# ==========================================
# You can customise the axes and enchantments here:
# If both are left blank, each axe is accepted regardless of whether it is enchanted or not.
# If only one field is left empty, either every axe is accepted or every enchantment or none.
# Check the plugin page for correct values:
# https://modrinth.com/plugin/bettertimber
# ==========================================
# Add-on "BetterTimberEnchantment" (https://modrinth.com/plugin/bettertimberenchantment):
# adds the enchantment "Timber" (enchanting table, villagers, loot). If it is installed, only axes with
# the Timber enchantment fell whole trees and valid_axes / required_enchantments below are not used.
# ==========================================
# If you need help or have a bug please contact me via discord (add hassanbwo).
# I will guarantee quick help - Thanks for supporting :)
# ==========================================

valid_axes:
  - NETHERITE_AXE

required_enchantments:
  unbreaking: 3
  efficiency: 5
  fortune: 3
  mending: 1

# ==========================================
# Here you can decide whether bare hands can trigger the animation
# ==========================================

use_hand: false

# ==========================================
# When a player sneaks, the animation is not triggered. true by default.
# Deactivate it here (replace true with false), the message can be changed in the messages file.
# ==========================================

sneak_skip_enabled: true

# ==========================================
# Here you can choose if only one durability point should be taken per tree or as many as the tree has logs
# Example: If the tree has 5 logs, 5 durability points are taken (default = true)
# If you want only 1 durability point to be taken per tree, set this to false
# ==========================================

durability_per_log: true

# ==========================================
# The leaves of a felled tree decay quickly (within a few seconds instead of minutes).
# Leaves that still belong to another tree and leaves placed by players stay.
# The drops (saplings, sticks, apples) are the same as in vanilla.
# ==========================================

fast_leaf_decay: true

# ==========================================
# Here you can select if the speed of the wood chopping should be according to the type of axe (default = true)
# ==========================================

axe_type_speed_enabled: true

# ==========================================
# Here you can adjust the speeds, the higher the number the slower the animation
# ==========================================

axe_speed_multipliers:
  WOODEN_AXE: 10
  STONE_AXE: 8
  IRON_AXE: 6
  GOLDEN_AXE: 4
  DIAMOND_AXE: 3
  NETHERITE_AXE: 2

# ==========================================
# Language of all messages: en (English), de (Deutsch), fr (Français), es (Español),
# pl (Polski), ru (Русский), pt (Português), tr (Türkçe) or zh (简体中文)
# The texts are in messages_en.yml / messages_de.yml and support MiniMessage (<red>, <gradient:...>)
# and the classic color codes (&c). You can add your own language, e.g. messages_it.yml -> language: it
# /bettertimber reload (permission bettertimber.reload) reloads config and messages.
# ==========================================

language: en

# Updates from Modrinth: a newer version is always announced in the console.
# enabled: download new versions automatically. Downloads are checked with the SHA-512 checksum from Modrinth
#          and installed on the next server restart (plugins/update folder). Only releases for your
#          Minecraft version and server software (Paper, Purpur, Folia) are downloaded.
# major_versions: also download big updates (e.g. 2.x -> 3.0) automatically, otherwise they are only announced.
auto_update:
  enabled: false
  major_versions: false

messages_en.yml

All texts support MiniMessage (<red>, <bold>, <gradient:#ff5555:#ffaa00>Text</gradient>) and the classic & color codes. Translations are included for German, French, Spanish, Polish, Russian, Portuguese, Turkish and Chinese - switch with language: de, fr, es, pl, ru, pt, tr or zh in the config.

# ==========================================
# BetterTimber - messages (English)
# ==========================================
# Formatting: MiniMessage - https://docs.advntr.dev/minimessage/format
#   Colors:    <red>, <gold>, <#ff8800>
#   Styles:    <bold>, <italic>, <underlined>
#   Gradients: <gradient:#ff5555:#ffaa00>Text</gradient>
#   Rainbow:   <rainbow>Text</rainbow>
# Classic color codes like &c, &l or &#ff8800 still work as well.
#
# Select the language in config.yml (language: en). You can also create your own
# file, e.g. messages_fr.yml, and set "language: fr". Missing texts fall back to English.
# Leave a message empty ("") to disable it.
# ==========================================

# Action bar when the player drops the axe during the animation
axe_dropped: "<gray>You've dropped your axe, stopped your <gradient:#ffaa00:#ff5500>lumberjack</gradient> action!"

# Action bar when the player sneaks (sneak_skip_enabled in config.yml)
sneak_skip: "<gray>You have sneaked, you are no longer a <gradient:#ffaa00:#ff5500>lumberjack</gradient>!"

# /bettertimber reload
reload_success: "<gradient:#ffaa00:#ff5500><bold>BetterTimber</bold></gradient> <gray>config reloaded successfully!"
no_permission: "<red>You do not have permission to use this command."
usage: "<red>Usage: /bettertimber reload"
Possible axes and enchantments

Axes: WOODEN_AXE, STONE_AXE, COPPER_AXE, IRON_AXE, GOLDEN_AXE, DIAMOND_AXE, NETHERITE_AXE

Enchantments (key: level): efficiency (1-5), unbreaking (1-3), fortune (1-3), mending (1), silk_touch (1), sharpness (1-5), smite (1-5), bane_of_arthropods (1-5), fire_aspect (1-2), vanishing_curse (1)

The axe must have exactly the listed enchantments with the listed levels.

More plugins by BetterPlugins

All for Paper, Purpur and Folia 26.x, in English, German, French, Spanish, Polish, Russian, Portuguese, Turkish and Chinese - see the whole BetterPlugins collection:
BetterAFK BetterAFK - Stylish AFK holograms, auto-AFK, kick and more
BannerForLabyMod BannerForLabyMod - Custom image banner above the tab list for LabyMod
BetterCarry BetterCarry - Carry and throw players, mobs and chests
BetterTimberEnchantment BetterTimberEnchantment - Timber enchantment for BetterTimber - enchanting table, villagers, loot
BetterRIP BetterRIP - Graves that keep your items in their slots and your experience
BetterSort BetterSort - Sort chests with one click, hotbar refill and quick stack
BetterWaystones BetterWaystones - Build, discover and travel between waystones - own 3D model, no resource pack