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.
- ✅ 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
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)
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.
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.
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.
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, 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: 3blocks.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"If you need help with the setup of the plugin, or found a bug, you can join our discord here.
