https://github.com/zetaplugins/timberz
The best Lumberjack Axe (Treecapitator) plugin for Minecraft
https://github.com/zetaplugins/timberz
lumberjack minecraft minecraft-plugin paper-plugin timberz treecapitator
Last synced: 3 months ago
JSON representation
The best Lumberjack Axe (Treecapitator) plugin for Minecraft
- Host: GitHub
- URL: https://github.com/zetaplugins/timberz
- Owner: ZetaPlugins
- License: gpl-3.0
- Created: 2025-04-30T04:43:27.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-11-28T19:31:49.000Z (7 months ago)
- Last Synced: 2025-11-30T21:13:13.964Z (7 months ago)
- Topics: lumberjack, minecraft, minecraft-plugin, paper-plugin, timberz, treecapitator
- Language: Java
- Homepage: https://modrinth.com/project/timberz
- Size: 392 KB
- Stars: 2
- Watchers: 0
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
---
[](https://github.com/ZetaPlugins/TimberZ)
[](https://modrinth.com/project/timberz)
[](https://strassburger.org/discord)
[](https://docs.zetaplugins.com/timberz)
[](https://gitlocalize.com/repo/10274)
TimberZ is a Minecraft plugin that let's you cut down trees in an instant. You can either have it always active, toggleable, make special lumberjack axes or have a custom enchantment.
## Features
- ✅ Advanced Tree Detection
- ✅ Custom Enchantment
- ✅ Customizable Tree Types
- ✅ Cutting down animation
- ✅ Instant Leaf Decay
- ✅ Toggleable Timber mode
- ✅ Custom item support
- ✅ HEX Colors
- ✅ Highly customizable
- ✅ Customizable messages
- ✅ Easy setup
- ✅ Multiple languages
## Permissions
- `timberz.usetimber` - Allows the player to use TimberZ. (true by default)
- `timberz.admin` - Allows the player to use admin commands. (Only for OPs by default)
## Compatability
### ✅ PlaceholderAPI
TimberZ supports PlaceholderAPI, allowing you to use placeholders in your messages and configurations:
- `%timberz_can_timber%` - Returns true if the player can use TimberZ. This takes permissions, regions and other restrictions into account.
### ✅ WorldGuard
TimberZ supports WorldGuard, allowing you to restrict TimberZ usage in certain regions. You can use the `timber` flag to allow or disallow TimberZ usage in a region.
### ✅ AuraSkills
Using TimberZ with AuraSkills, gives players the correct amount of experience when cutting down trees. You can also add a custom XP multiplier to the TimberZ configuration file.
## Configuration
You can find the configuration files in the `plugins/TimberZ` folder. The main configuration file is `config.yml`, and you can also find a `blocks.yml` file that contains the block mappings for logs, leaves, and saplings.
config.yml
```yml
# _______ _ _ ______
# |__ __(_) | | |___ /
# | | _ _ __ ___ | |__ ___ _ __ / /
# | | | | '_ ` _ \| '_ \ / _ \ '__| / /
# | | | | | | | | | |_) | __/ | / /__
# |_| |_|_| |_| |_|_.__/ \___|_| /_____|
# === COLOR CODES ===
# This plugin supports old color codes like: &c, &l, &o, etc.
# It also supports MiniMessage, a more advanced way to format messages:
# https://docs.advntr.dev/minimessage/format.html
# With MiniMessage, you can add HEX colors, gradients, hover and click events, etc.
# === GENERAL SETTINGS ===
# If set to true, TimberZ will check for updates and let you know if there's a newer version
checkForUpdates: true
# Set the language to any code found in the "lang" folder (don't add the .yml extension)
# You can add your own language files. Use https://github.com/ZetaPlugins/TimberZ/tree/main/src/main/resources/lang/en-US.yml as a template
# If you want to help translating the plugin, please refer to this article: https://docs.zetaplugins.com/#contributing
# | en-US | de-DE | pl-PL | ru-RU |
lang: "en-US"
# The accent color of the plugin. This color replaces %ac% in the lang files.
accentColor: "<#00D26A>"
# === TIMBER SETTINGS ===
# Regardless of the settings below, you can disallow TimberZ for a specific player by disallowing them the "timberz.usetimber" permission.
# If set to true, players can enable or disable timber mode by pressing F with a qualifying axe in hand
toggleTimber: true
# If set to true, you can only use axes that have the "Timber" enchantment which can be applied like a normal Enchantment.
requireCustomEnchant: true
# If set to true, you can only use axes with a customModelData value in the list below
restrictAxeModelData: false
# If restrictAxeModelData is set to true, you can only use axes with a customModelData value in this list
allowedModelData:
- 100
# If set to true, Leaves will decay instantly when cutting down a tree
instantLeafDecay: true
# If set to true, TimberZ will replant the tree after cutting it down
replant: true
# Modify how much durability is removed from the axe when cutting down a tree
# Formula: logCount * durabilityMultiplier
durabilityMultiplier: 1.0
# The minimum durability the axe must have after cutting down a tree
minDurability: 10
# If set to true, Players will need to use an axe (defined in the blocks.yml file) to use TimberZ
# When this is set to false, you can no longer toggle TimberZ by pressing F
requireAxeMaterial: true
# If set to true, you can insta mine leaves when the TimberZ conditions are met
instaBreakLeavesWithTimber: false
# Send a message to the player when they try to use timber mode in a WorldGuard region that does not allow it
messageOnRegionViolation: false
# If using AuraSkills, you can have a custom XP multiplier for the Foraging skill
# Example: If you set this to 2.0, players will receive double the XP for using TimberZ
# Example2: If you set this to 0.5, players will receive half the XP for using TimberZ
auraSkillsXPMultiplier: 1.0
# === TREE DETECTION ===
# Only change these settings if you know what you are doing!
# These are used to detect trees and their leaves and are already fine tuned.
leavesSearchRadius: 4
maxTreeSize: 500
maxSearchRadius: 1
diagonalSearchRange: 2
minLeavesRequired: 5
minLogsRequired: 3
```
blocks.yml
```yml
logToLeafMap:
- "OAK_LOG:OAK_LEAVES"
- "BIRCH_LOG:BIRCH_LEAVES"
- "SPRUCE_LOG:SPRUCE_LEAVES"
- "JUNGLE_LOG:JUNGLE_LEAVES"
- "ACACIA_LOG:ACACIA_LEAVES"
- "DARK_OAK_LOG:DARK_OAK_LEAVES"
- "MANGROVE_LOG:MANGROVE_LEAVES"
- "CHERRY_LOG:CHERRY_LEAVES"
- "STRIPPED_OAK_LOG:OAK_LEAVES"
- "STRIPPED_BIRCH_LOG:BIRCH_LEAVES"
- "STRIPPED_SPRUCE_LOG:SPRUCE_LEAVES"
- "STRIPPED_JUNGLE_LOG:JUNGLE_LEAVES"
- "STRIPPED_ACACIA_LOG:ACACIA_LEAVES"
- "STRIPPED_DARK_OAK_LOG:DARK_OAK_LEAVES"
- "STRIPPED_MANGROVE_LOG:MANGROVE_LEAVES"
- "STRIPPED_CHERRY_LOG:CHERRY_LEAVES"
- "PALE_OAK_LOG:PALE_OAK_LEAVES"
logToSaplingMap:
- "OAK_LOG:OAK_SAPLING"
- "BIRCH_LOG:BIRCH_SAPLING"
- "SPRUCE_LOG:SPRUCE_SAPLING"
- "JUNGLE_LOG:JUNGLE_SAPLING"
- "ACACIA_LOG:ACACIA_SAPLING"
- "DARK_OAK_LOG:DARK_OAK_SAPLING"
- "MANGROVE_LOG:MANGROVE_PROPAGULE"
- "CHERRY_LOG:CHERRY_SAPLING"
- "STRIPPED_OAK_LOG:OAK_SAPLING"
- "STRIPPED_BIRCH_LOG:BIRCH_SAPLING"
- "STRIPPED_SPRUCE_LOG:SPRUCE_SAPLING"
- "STRIPPED_JUNGLE_LOG:JUNGLE_SAPLING"
- "STRIPPED_ACACIA_LOG:ACACIA_SAPLING"
- "STRIPPED_DARK_OAK_LOG:DARK_OAK_SAPLING"
- "STRIPPED_MANGROVE_LOG:MANGROVE_PROPAGULE"
- "STRIPPED_CHERRY_LOG:CHERRY_SAPLING"
- "PALE_OAK_LOG:PALE_OAK_SAPLING"
axes:
- "WOODEN_AXE"
- "STONE_AXE"
- "GOLDEN_AXE"
- "IRON_AXE"
- "DIAMOND_AXE"
- "NETHERITE_AXE"
```
## Support
If you need help with the setup of the plugin, or found a bug, you can join our discord [here](https://strassburger.org/discord).
[](https://strassburger.org/discord)
[](https://docs.zetaplugins.com/timberz)
---
[](https://bstats.org/plugin/bukkit/TimberZ/25743)