Give your players a new, entertaining, and highly customizable way to chop down trees.
Part of the Ultimate Series.
Getting Started
To install Ultimate Timber you will need to:
- Turn your server off.
- Add the required dependencies: Vault.
- Add the optional dependencies: mcMMO, Jobs.
- Add in the latest version of Ultimate Timber which you can find in our marketplace.
- Turn your server back on.
Plugin Files
#____ ___ __ __ __ __ ___________ __ ___ #| | \ |_/ |_|__| _____ _____ _/ |_ ___\__ ___/|__| _____\_ |__ ___________ #| | / |\ __\ |/ \\__ \\ __\/ __ \| | | |/ \| __ \_/ __ \_ __ \ #| | /| |_| | | | Y Y \/ __ \| | \ ___/| | | | Y Y \ \_\ \ ___/| | \/ #|______/ |____/__| |__|__|_| (____ /__| \___ |____| |__|__|_| /___ /\___ >__| #The type of server you are running in relation to this plugin #Do not change this value #Default: CURRENT server-type: CURRENT #The locale to use in the /locale folder #Default: en_US locale: en_US #A list of worlds that the plugin is disabled in #Default: #- disabled_world_name disabled-worlds: - disabled_world_name #The max number of logs that can be broken at one time #Default: 150 max-logs-per-chop: 150 #The minimum number of leaves required for something to be considered a tree #Default: 5 leaves-required-for-tree: 5 #If leaves should be destroyed #Default: true destroy-leaves: true #Apply realistic damage to the tools based on the number of logs chopped #If false, only one durability will be removed from the tool #Default: true realistic-tool-damage: true #Protect the tool used to chop down the tree from breaking #Prevents the tree from being toppled if the tool would break #Default: false protect-tool: false #Use the silk touch enchantment if the tool has it #Logs and leaves will drop their original block 100% of the time #Default: true apply-silk-touch: true #Damage the tool extra for each leaf block broken, this is vanilla behavior but can be disabled here #Does nothing if realistic-tool-damage is false #Default: true apply-silk-touch-tool-damage: true #Require the entire base of the tree to be broken before it topples #Default: false break-entire-tree-base: false #Don't drop a block for the block that initiates the tree fall #Default: false destroy-initiated-block: false #Only detect logs above the initiated block #Default: true only-detect-logs-upwards: true #Only topple trees while the player is doing something #Valid values: SNEAKING, NOT_SNEAKING, ALWAYS #Default: ALWAYS only-topple-while: ALWAYS #Allow toppling trees in creative mode #Default: true allow-creative-mode: true #Require the player to have the permission 'ultimatetimber.chop' to topple trees #Default: false require-chop-permission: false #If a player should only be allowed to chop one tree per cooldown length #Default: false player-tree-topple-cooldown: false #The amount of seconds a player has to wait before they can chop a tree again #Does nothing if player-tree-topple-cooldown is false #The time is in seconds and must be a postive whole number #Default: 5 player-tree-topple-cooldown-length: 5 #Allow players to topple trees regardless of what they are holding in their hand #Default: false ignore-required-tools: false #Automatically replant saplings when a tree is toppled #Default: true replant-saplings: true #Always replant saplings for base tree blocks, regardless of player permissions #Default: false always-replant-sapling: false #How many seconds to prevent players from breaking replanted saplings #Set to 0 to disable #Does nothing if replant-saplings is false #The time is in seconds and must be a postive whole number #Default: 3 replant-saplings-cooldown: 3 #Give fallen leaf blocks a chance to replant saplings when they hit the ground #Default: true falling-blocks-replant-saplings: true #The percent chance that fallen leaves have of planting a sapling #Does nothing if falling-blocks-replant-saplings is false #The chance is out of 100 and may contain decimals #Default: 1 falling-blocks-replant-saplings-chance: 1 #Make falling tree blocks deal damage to players if they get hit #Default: true falling-blocks-deal-damage: true #The amount of damage that falling tree blocks do #This does nothing if falling-blocks-deal-damage is false #Default: 1 falling-block-damage: 1 #Automatically add tree blocks to the player's inventory instead of dropping them #Default: false add-items-to-inventory: false #Use custom sounds when toppling trees #Default: true use-custom-sounds: true #Use custom particles when toppling trees #Default: true use-custom-particles: true #The bonus loot multiplier when a player has the permission ultimatetimber.bonusloot #Multiplies the chance of tree drops by this value #Decimal values are allowed #Default: 2 bonus-loot-multiplier: 2 #If placed blocks should be ignored for toppling trees #Note: This only keeps track of blocks placed during the current server load #If your server restarts, the placed tree blocks could be toppled again #Default: true ignore-placed-blocks: true #The maximum number of blocks to keep track of in memory at once #Use a lower number if this starts to take up too much memory or trees start taking too long to detect #Default: 5000 ignore-placed-blocks-memory-size: 5000 #Applies experience when using Jobs/mcMMO #Only does something if Jobs or mcMMO is installed #Default: true hooks-apply-experience: true #Applies extra drops passive ability when using mcMMO #Only does something if mcMMO is installed #Default: true hooks-apply-extra-drops: true #Requires the tree feller ability in mcMMO to be active to use timber #Only does something if mcMMO is installed #Default: false hooks-require-ability-active: false #The type of animation to use for tree toppling #Types: FANCY, DISINTEGRATE, CRUMBLE, NONE tree-animation-type: FANCY #If the tree-animation-type is FANCY or CRUMBLE, make the blocks stick to the ground #Does nothing if tree-animation-type is not FANCY or CRUMBLE #Default: false scatter-tree-blocks-on-ground: false #Tree configuration #Allows for extreme fine-tuning of tree detection and what are considered trees #Multiple log and leaf types are allowed, only one sapling type is allowed #You can add your own custom tree types here, just add a new section trees: oak: logs: - OAK_LOG - STRIPPED_OAK_LOG - OAK_WOOD - STRIPPED_OAK_WOOD leaves: - OAK_LEAVES sapling: OAK_SAPLING plantable-soil: [] max-log-distance-from-trunk: 6 max-leaf-distance-from-log: 6 search-for-leaves-diagonally: false drop-original-log: true drop-original-leaf: false log-loot: [] leaf-loot: 0: material: OAK_SAPLING chance: 5 1: material: APPLE chance: 0.5 entire-tree-loot: [] required-tools: [] spruce: logs: - SPRUCE_LOG - STRIPPED_SPRUCE_LOG - SPRUCE_WOOD - STRIPPED_SPRUCE_WOOD leaves: - SPRUCE_LEAVES sapling: SPRUCE_SAPLING plantable-soil: [] max-log-distance-from-trunk: 2 max-leaf-distance-from-log: 6 search-for-leaves-diagonally: false drop-original-log: true drop-original-leaf: false log-loot: [] leaf-loot: 0: material: SPRUCE_SAPLING chance: 5 entire-tree-loot: [] required-tools: [] birch: logs: - BIRCH_LOG - STRIPPED_BIRCH_LOG - BIRCH_WOOD - STRIPPED_BIRCH_WOOD leaves: - BIRCH_LEAVES sapling: BIRCH_SAPLING plantable-soil: [] max-log-distance-from-trunk: 1 max-leaf-distance-from-log: 4 search-for-leaves-diagonally: false drop-original-log: true drop-original-leaf: false log-loot: [] leaf-loot: 0: material: BIRCH_SAPLING chance: 5 entire-tree-loot: [] required-tools: [] jungle: logs: - JUNGLE_LOG - STRIPPED_JUNGLE_LOG - JUNGLE_WOOD - STRIPPED_JUNGLE_WOOD leaves: - JUNGLE_LEAVES sapling: JUNGLE_SAPLING plantable-soil: [] max-log-distance-from-trunk: 6 max-leaf-distance-from-log: 6 search-for-leaves-diagonally: false drop-original-log: true drop-original-leaf: false log-loot: [] leaf-loot: 0: material: JUNGLE_SAPLING chance: 2.5 entire-tree-loot: [] required-tools: [] acacia: logs: - ACACIA_LOG - STRIPPED_ACACIA_LOG - ACACIA_WOOD - STRIPPED_ACACIA_WOOD leaves: - ACACIA_LEAVES sapling: ACACIA_SAPLING plantable-soil: [] max-log-distance-from-trunk: 4 max-leaf-distance-from-log: 5 search-for-leaves-diagonally: false drop-original-log: true drop-original-leaf: false log-loot: [] leaf-loot: 0: material: ACACIA_SAPLING chance: 5 entire-tree-loot: [] required-tools: [] dark_oak: logs: - DARK_OAK_LOG - STRIPPED_DARK_OAK_LOG - DARK_OAK_WOOD - STRIPPED_DARK_OAK_WOOD leaves: - DARK_OAK_LEAVES sapling: DARK_OAK_SAPLING plantable-soil: [] max-log-distance-from-trunk: 3 max-leaf-distance-from-log: 5 search-for-leaves-diagonally: false drop-original-log: true drop-original-leaf: false log-loot: [] leaf-loot: 0: material: DARK_OAK_SAPLING chance: 5 1: material: APPLE chance: 0.5 entire-tree-loot: [] required-tools: [] brown_mushroom: logs: - MUSHROOM_STEM leaves: - BROWN_MUSHROOM_BLOCK sapling: BROWN_MUSHROOM plantable-soil: - MYCELIUM max-log-distance-from-trunk: 4 max-leaf-distance-from-log: 4 search-for-leaves-diagonally: false drop-original-log: false drop-original-leaf: false log-loot: [] leaf-loot: 0: material: BROWN_MUSHROOM chance: 25 entire-tree-loot: [] required-tools: [] red_mushroom: logs: - MUSHROOM_STEM leaves: - RED_MUSHROOM_BLOCK sapling: RED_MUSHROOM plantable-soil: - MYCELIUM max-log-distance-from-trunk: 4 max-leaf-distance-from-log: 4 search-for-leaves-diagonally: true drop-original-log: false drop-original-leaf: false log-loot: [] leaf-loot: 0: material: RED_MUSHROOM chance: 25 entire-tree-loot: [] required-tools: [] #All soil types that the tree type's saplings can be planted on global-plantable-soil: - GRASS_BLOCK - DIRT - COARSE_DIRT - PODZOL #Custom loot that is available for all tree types #The loot applies to each log broken in the tree #To add more, increment the number by 1 #The chance is out of 100 and can contain decimals #The default examples here are to show what you can do with custom loot #Valid command placeholders: %player%, %type%, %xPos%, %yPos%, %zPos% global-log-loot: 0: material: DIAMOND chance: 0 1: command: 'eco give %player% 5' chance: 0 2: material: GOLDEN_APPLE command: 'broadcast %player% found a golden apple in a %type% tree at %xPos% %yPos% %zPos%!' chance: 0 #Custom loot that is available for all tree types #The loot applies to each leaf broken in the tree #To add more, increment the number by 1 #The chance is out of 100 and can contain decimals #Valid command placeholders: %player%, %type%, %xPos%, %yPos%, %zPos% global-leaf-loot: 0: material: GOLDEN_APPLE chance: 0.1 #Custom entire tree loot that is available for all tree types #The loot will be dropped only one time for the entire tree #To add more, increment the number by 1 #The chance is out of 100 and can contain decimals #Valid command placeholders: %player%, %type%, %xPos%, %yPos%, %zPos% global-entire-tree-loot: 0: material: DIAMOND chance: 0 #Tools that must be used to topple over a tree #Applies to all tree types global-required-tools: - WOODEN_AXE - STONE_AXE - IRON_AXE - GOLDEN_AXE - DIAMOND_AXE
#____ ___ __ __ __ __ ___________ __ ___ #| | \ |_/ |_|__| _____ _____ _/ |_ ___\__ ___/|__| _____\_ |__ ___________ #| | / |\ __\ |/ \\__ \\ __\/ __ \| | | |/ \| __ \_/ __ \_ __ \ #| | /| |_| | | | Y Y \/ __ \| | \ ___/| | | | Y Y \ \_\ \ ___/| | \/ #|______/ |____/__| |__|__|_| (____ /__| \___ |____| |__|__|_| /___ /\___ >__| #The type of server you are running in relation to this plugin #If you ever upgrade from a legacy version of Minecraft to a current version, you will need to reset this config #Do not change this value #Default: LEGACY server-type: LEGACY #The locale to use in the /locale folder #Default: en_US locale: en_US #A list of worlds that the plugin is disabled in #Default: #- disabled_world_name disabled-worlds: - disabled_world_name #The max number of logs that can be broken at one time #Default: 150 max-logs-per-chop: 150 #The minimum number of leaves required for something to be considered a tree #Default: 5 leaves-required-for-tree: 5 #If leaves should be destroyed #Default: true destroy-leaves: true #Apply realistic damage to the tools based on the number of logs chopped #If false, only one durability will be removed from the tool #Default: true realistic-tool-damage: true #Protect the tool used to chop down the tree from breaking #Prevents the tree from being toppled if the tool would break #Default: false protect-tool: false #Use the silk touch enchantment if the tool has it #Logs and leaves will drop their original block 100% of the time #Default: true apply-silk-touch: true #Damage the tool extra for each leaf block broken, this is vanilla behavior but can be disabled here #Does nothing if realistic-tool-damage is false #Default: true apply-silk-touch-tool-damage: true #Require the entire base of the tree to be broken before it topples #Default: false break-entire-tree-base: false #Don't drop a block for the block that initiates the tree fall #Default: false destroy-initiated-block: false #Only detect logs above the initiated block #Default: true only-detect-logs-upwards: true #Only topple trees while the player is doing something #Valid values: SNEAKING, NOT_SNEAKING, ALWAYS #Default: ALWAYS only-topple-while: ALWAYS #Allow toppling trees in creative mode #Default: true allow-creative-mode: true #Require the player to have the permission 'ultimatetimber.chop' to topple trees #Default: false require-chop-permission: false #If a player should only be allowed to chop one tree per cooldown length #Default: false player-tree-topple-cooldown: false #The amount of seconds a player has to wait before they can chop a tree again #Does nothing if player-tree-topple-cooldown is false #The time is in seconds and must be a postive whole number #Default: 5 player-tree-topple-cooldown-length: 5 #Allow players to topple trees regardless of what they are holding in their hand #Default: false ignore-required-tools: false #Automatically replant saplings when a tree is toppled #Default: true replant-saplings: true #Always replant saplings for base tree blocks, regardless of player permissions #Default: false always-replant-sapling: false #How many seconds to prevent players from breaking replanted saplings #Set to 0 to disable #Does nothing if replant-saplings is false #The time is in seconds and must be a postive whole number #Default: 3 replant-saplings-cooldown: 3 #Give fallen leaf blocks a chance to replant saplings when they hit the ground #Default: true falling-blocks-replant-saplings: true #The percent chance that fallen leaves have of planting a sapling #Does nothing if falling-blocks-replant-saplings is false #The chance is out of 100 and may contain decimals #Default: 1 falling-blocks-replant-saplings-chance: 1 #Make falling tree blocks deal damage to players if they get hit #Default: true falling-blocks-deal-damage: true #The amount of damage that falling tree blocks do #This does nothing if falling-blocks-deal-damage is false #Default: 1 falling-block-damage: 1 #Automatically add tree blocks to the player's inventory instead of dropping them #Default: false add-items-to-inventory: false #Use custom sounds when toppling trees #Default: true use-custom-sounds: true #Use custom particles when toppling trees #Default: true use-custom-particles: true #The bonus loot multiplier when a player has the permission ultimatetimber.bonusloot #Multiplies the chance of tree drops by this value #Decimal values are allowed #Default: 2 bonus-loot-multiplier: 2 #If placed blocks should be ignored for toppling trees #Note: This only keeps track of blocks placed during the current server load #If your server restarts, the placed tree blocks could be toppled again #Default: true ignore-placed-blocks: true #The maximum number of blocks to keep track of in memory at once #Use a lower number if this starts to take up too much memory or trees start taking too long to detect #Default: 5000 ignore-placed-blocks-memory-size: 5000 #Applies experience when using Jobs/mcMMO #Only does something if Jobs or mcMMO is installed #Default: true hooks-apply-experience: true #Applies extra drops passive ability when using mcMMO #Only does something if mcMMO is installed #Default: true hooks-apply-extra-drops: true #Requires the tree feller ability in mcMMO to be active to use timber #Only does something if mcMMO is installed #Default: false hooks-require-ability-active: false #The type of animation to use for tree toppling #Types: FANCY, DISINTEGRATE, CRUMBLE, NONE tree-animation-type: FANCY #If the tree-animation-type is FANCY or CRUMBLE, make the blocks stick to the ground #Does nothing if tree-animation-type is not FANCY or CRUMBLE #Default: false scatter-tree-blocks-on-ground: false #Tree configuration #Allows for extreme fine-tuning of tree detection and what are considered trees #Multiple log and leaf types are allowed, only one sapling type is allowed #You can add your own custom tree types here, just add a new section trees: oak: logs: - LOG:0,4,8,12 leaves: - LEAVES:0,4,8,12 sapling: SAPLING:0 plantable-soil: [] max-log-distance-from-trunk: 6 max-leaf-distance-from-log: 6 search-for-leaves-diagonally: false drop-original-log: true drop-original-leaf: false log-loot: [] leaf-loot: 0: material: SAPLING:0 chance: 5 1: material: APPLE chance: 0.5 entire-tree-loot: [] required-tools: [] spruce: logs: - LOG:1,5,9,13 leaves: - LEAVES:1,5,9,13 sapling: SAPLING:1 plantable-soil: [] max-log-distance-from-trunk: 2 max-leaf-distance-from-log: 6 search-for-leaves-diagonally: false drop-original-log: true drop-original-leaf: false log-loot: [] leaf-loot: 0: material: SAPLING:1 chance: 5 entire-tree-loot: [] required-tools: [] birch: logs: - LOG:2,6,10,14 leaves: - LEAVES:2,6,10,14 sapling: SAPLING:2 plantable-soil: [] max-log-distance-from-trunk: 1 max-leaf-distance-from-log: 4 search-for-leaves-diagonally: false drop-original-log: true drop-original-leaf: false log-loot: [] leaf-loot: 0: material: SAPLING:2 chance: 5 entire-tree-loot: [] required-tools: [] jungle: logs: - LOG:3,7,11,15 leaves: - LEAVES:3,7,11,15 sapling: SAPLING:3 plantable-soil: [] max-log-distance-from-trunk: 6 max-leaf-distance-from-log: 6 search-for-leaves-diagonally: false drop-original-log: true drop-original-leaf: false log-loot: [] leaf-loot: 0: material: SAPLING:3 chance: 2.5 entire-tree-loot: [] required-tools: [] acacia: logs: - LOG_2:0,4,8,12 leaves: - LEAVES_2:0,4,8,12 sapling: SAPLING:4 plantable-soil: [] max-log-distance-from-trunk: 4 max-leaf-distance-from-log: 5 search-for-leaves-diagonally: false drop-original-log: true drop-original-leaf: false log-loot: [] leaf-loot: 0: material: SAPLING:4 chance: 5 entire-tree-loot: [] required-tools: [] dark_oak: logs: - LOG_2:1,5,9,13 leaves: - LEAVES_2:1,5,9,13 sapling: SAPLING:5 plantable-soil: [] max-log-distance-from-trunk: 3 max-leaf-distance-from-log: 5 search-for-leaves-diagonally: false drop-original-log: true drop-original-leaf: false log-loot: [] leaf-loot: 0: material: SAPLING:5 chance: 5 1: material: APPLE chance: 0.5 entire-tree-loot: [] required-tools: [] brown_mushroom: logs: - HUGE_MUSHROOM_1:15,10 leaves: - HUGE_MUSHROOM_1:14,0,1,2,3,4,5,6,7,8,9 sapling: BROWN_MUSHROOM plantable-soil: - MYCEL max-log-distance-from-trunk: 4 max-leaf-distance-from-log: 4 search-for-leaves-diagonally: false drop-original-log: false drop-original-leaf: false log-loot: [] leaf-loot: 0: material: BROWN_MUSHROOM chance: 25 entire-tree-loot: [] required-tools: [] red_mushroom: logs: - HUGE_MUSHROOM_2:15,10 leaves: - HUGE_MUSHROOM_2:14,0,1,2,3,4,5,6,7,8,9 sapling: RED_MUSHROOM plantable-soil: - MYCEL max-log-distance-from-trunk: 4 max-leaf-distance-from-log: 4 search-for-leaves-diagonally: true drop-original-log: false drop-original-leaf: false log-loot: [] leaf-loot: 0: material: RED_MUSHROOM chance: 25 entire-tree-loot: [] required-tools: [] #All soil types that the tree type's saplings can be planted on global-plantable-soil: - GRASS - DIRT:0 - DIRT:1 - DIRT:2 #Custom loot that is available for all tree types #The loot applies to each log broken in the tree #To add more, increment the number by 1 #The chance is out of 100 and can contain decimals #The default examples here are to show what you can do with custom loot #Valid command placeholders: %player%, %type%, %xPos%, %yPos%, %zPos% global-log-loot: 0: material: DIAMOND chance: 0 1: command: 'eco give %player% 5' chance: 0 2: material: GOLDEN_APPLE command: 'broadcast %player% found a golden apple in a %type% tree at %xPos% %yPos% %zPos%!' chance: 0 #Custom loot that is available for all tree types #The loot applies to each leaf broken in the tree #To add more, increment the number by 1 #The chance is out of 100 and can contain decimals #Valid command placeholders: %player%, %type%, %xPos%, %yPos%, %zPos% global-leaf-loot: 0: material: GOLDEN_APPLE chance: 0.1 #Custom entire tree loot that is available for all tree types #The loot will be dropped only one time for the entire tree #To add more, increment the number by 1 #The chance is out of 100 and can contain decimals #Valid command placeholders: %player%, %type%, %xPos%, %yPos%, %zPos% global-entire-tree-loot: 0: material: DIAMOND chance: 0 #Tools that must be used to topple over a tree #Applies to all tree types global-required-tools: - WOOD_AXE - STONE_AXE - IRON_AXE - GOLD_AXE - DIAMOND_AXE
Translations
We offer translated versions of this plugin! In order to use them, enter the corresponding Language Code into your config.yml.
Language | Language code |
---|---|
Arabic | ar_EG |
German | de_DE |
English | en_US |
Spanish | es_ES |
French | fr_FR |
Hebrew | he_IL |
Italian | it_IT |
Dutch | nl_NL |
Norwegian | no_NO |
Russian | ru_RU |
Turkish | tr_TR |
Commands and Permissions
Command | Description | Permission Node |
---|---|---|
/ut | Shows the plugin's information. | Default |
/ut reload | Reloads the Configuration and Language files for UltimateTimber. | ultimatetimber.reload |
/ut toggle | Toggles tree chopping. | ultimatetimber.toggle |
Allows your players to chop down trees with the plugin. | ultimatetimber.chop | |
Allows potential of bonus items dropping from tree loot. | ultimatetimber.bonusloot | |
Allows a player to bypass the tree chopping cooldown | ultimatetimber.bypasscooldown |
Supported Plugins
- mcMMO Classic
- mcMMO Overhaul
- Jobs Reborn
- Custom World Generation Plugin
Tutorial
Build 2.0.6
Frequently Asked Questions
Make sure that the world name isn't disabled in the config.yml.
In order for UltimateTimber to work correctly with custom trees or world generators, you'll have to edit the tree settings. Open the config.yml and find the "trees" section. You can add custom trees here that either match your custom world generator's trees, or any custom trees that you want to make. If the entire tree isn't cutting down correctly, setting the max long distance from trunk to a much higher number should fix the issue.
Additionally, if you want to modify the default settings for trees, you can feel free to do so in the same section.