Compatibility
Minecraft: Java Edition
Platforms
75% of ad revenue goes to creators
Support creators and Modrinth ad-free with Modrinth+
Details
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
- ✅ Toggleable Timber mode
- ✅ Custom item support
- ✅ HEX Colors
- ✅ Highly customizable
- ✅ 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
# _______ _ _ ______
# |__ __(_) | | |___ /
# | | _ _ __ ___ | |__ ___ _ __ / /
# | | | | '_ ` _ \| '_ \ / _ \ '__| / /
# | | | | | | | | | |_) | __/ | / /__
# |_| |_|_| |_| |_|_.__/ \___|_| /_____|
# === 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, LifeStealZ 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 |
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, 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
# 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
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"
leafBlocks:
- "OAK_LEAVES"
- "BIRCH_LEAVES"
- "SPRUCE_LEAVES"
- "JUNGLE_LEAVES"
- "ACACIA_LEAVES"
- "DARK_OAK_LEAVES"
- "MANGROVE_LEAVES"
- "CHERRY_LEAVES"
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.
