Ultimate Timber

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:

1. Turn your server off.
2. Add the required dependencies: Vault.
3. Add the optional dependencies: mcMMO, Jobs.
4. Add in the latest version of Ultimate Timber which you can find in our marketplace.
5. Turn your server back on.

Plugin Files

1.13+ config.yml

  1 #____ ___ __   __   __                __       ___________ __       ___
  2 #|    |   \  |_/  |_|__| _____ _____ _/  |_  ___\__    ___/|__| _____\_ |__   ___________
  3 #|    |   /  |\   __\  |/     \\__  \\   __\/ __ \|    |   |  |/     \| __ \_/ __ \_  __ \
  4 #|    |  /|  |_|  | |  |  Y Y  \/ __ \|  | \  ___/|    |   |  |  Y Y  \ \_\ \  ___/|  | \/
  5 #|______/ |____/__| |__|__|_|  (____  /__|  \___  |____|   |__|__|_|  /___  /\___  >__|
  6  
  7 #The type of server you are running in relation to this plugin
  8 #Do not change this value
  9 #Default: CURRENT
 10 
 11 server-type: CURRENT
 12  
 13 #The locale to use in the /locale folder
 14 #Default: en_US
 15 
 16 locale: en_US
 17  
 18 #A list of worlds that the plugin is disabled in
 19 #Default:
 20 #- disabled_world_name
 21 
 22 disabled-worlds:
 23   - disabled_world_name
 24  
 25 #The max number of logs that can be broken at one time
 26 #Default: 150
 27 
 28 max-logs-per-chop: 150
 29  
 30 #The minimum number of leaves required for something to be considered a tree
 31 #Default: 5
 32 
 33 leaves-required-for-tree: 5
 34  
 35 #If leaves should be destroyed
 36 #Default: true
 37 
 38 destroy-leaves: true
 39  
 40 #Apply realistic damage to the tools based on the number of logs chopped
 41 #If false, only one durability will be removed from the tool
 42 #Default: true
 43 
 44 realistic-tool-damage: true
 45  
 46 #Protect the tool used to chop down the tree from breaking
 47 #Prevents the tree from being toppled if the tool would break
 48 #Default: false
 49 
 50 protect-tool: false
 51  
 52 #Use the silk touch enchantment if the tool has it
 53 #Logs and leaves will drop their original block 100% of the time
 54 #Default: true
 55 
 56 apply-silk-touch: true
 57  
 58 #Damage the tool extra for each leaf block broken, this is vanilla behavior but can be disabled here
 59 #Does nothing if realistic-tool-damage is false
 60 #Default: true
 61 
 62 apply-silk-touch-tool-damage: true
 63  
 64 #Require the entire base of the tree to be broken before it topples
 65 #Default: false
 66 
 67 break-entire-tree-base: false
 68  
 69 #Don't drop a block for the block that initiates the tree fall
 70 #Default: false
 71 
 72 destroy-initiated-block: false
 73  
 74 #Only detect logs above the initiated block
 75 #Default: true
 76 
 77 only-detect-logs-upwards: true
 78  
 79 #Only topple trees while the player is doing something
 80 #Valid values: SNEAKING, NOT_SNEAKING, ALWAYS
 81 #Default: ALWAYS
 82 
 83 only-topple-while: ALWAYS
 84  
 85 #Allow toppling trees in creative mode
 86 #Default: true
 87 
 88 allow-creative-mode: true
 89  
 90 #Require the player to have the permission 'ultimatetimber.chop' to topple trees
 91 #Default: false
 92 
 93 require-chop-permission: false
 94  
 95 #If a player should only be allowed to chop one tree per cooldown length
 96 #Default: false
 97 
 98 player-tree-topple-cooldown: false
 99  
100 #The amount of seconds a player has to wait before they can chop a tree again
101 #Does nothing if player-tree-topple-cooldown is false
102 #The time is in seconds and must be a postive whole number
103 #Default: 5
104 
105 player-tree-topple-cooldown-length: 5
106  
107 #Allow players to topple trees regardless of what they are holding in their hand
108 #Default: false
109 
110 ignore-required-tools: false
111  
112 #Automatically replant saplings when a tree is toppled
113 #Default: true
114 
115 replant-saplings: true
116  
117 #Always replant saplings for base tree blocks, regardless of player permissions
118 #Default: false
119 
120 always-replant-sapling: false
121  
122 #How many seconds to prevent players from breaking replanted saplings
123 #Set to 0 to disable
124 #Does nothing if replant-saplings is false
125 #The time is in seconds and must be a postive whole number
126 #Default: 3
127 
128 replant-saplings-cooldown: 3
129  
130 #Give fallen leaf blocks a chance to replant saplings when they hit the ground
131 #Default: true
132 
133 falling-blocks-replant-saplings: true
134  
135 #The percent chance that fallen leaves have of planting a sapling
136 #Does nothing if falling-blocks-replant-saplings is false
137 #The chance is out of 100 and may contain decimals
138 #Default: 1
139 
140 falling-blocks-replant-saplings-chance: 1
141  
142 #Make falling tree blocks deal damage to players if they get hit
143 #Default: true
144 
145 falling-blocks-deal-damage: true
146  
147 #The amount of damage that falling tree blocks do
148 #This does nothing if falling-blocks-deal-damage is false
149 #Default: 1
150 
151 falling-block-damage: 1
152  
153 #Automatically add tree blocks to the player's inventory instead of dropping them
154 #Default: false
155 
156 add-items-to-inventory: false
157  
158 #Use custom sounds when toppling trees
159 #Default: true
160 
161 use-custom-sounds: true
162  
163 #Use custom particles when toppling trees
164 #Default: true
165 
166 use-custom-particles: true
167  
168 #The bonus loot multiplier when a player has the permission ultimatetimber.bonusloot
169 #Multiplies the chance of tree drops by this value
170 #Decimal values are allowed
171 #Default: 2
172 
173 bonus-loot-multiplier: 2
174  
175 #If placed blocks should be ignored for toppling trees
176 #Note: This only keeps track of blocks placed during the current server load
177 #If your server restarts, the placed tree blocks could be toppled again
178 #Default: true
179 
180 ignore-placed-blocks: true
181  
182 #The maximum number of blocks to keep track of in memory at once
183 #Use a lower number if this starts to take up too much memory or trees start taking too long to detect
184 #Default: 5000
185 
186 ignore-placed-blocks-memory-size: 5000
187  
188 #Applies experience when using Jobs/mcMMO
189 #Only does something if Jobs or mcMMO is installed
190 #Default: true
191 
192 hooks-apply-experience: true
193  
194 #Applies extra drops passive ability when using mcMMO
195 #Only does something if mcMMO is installed
196 #Default: true
197 
198 hooks-apply-extra-drops: true
199  
200 #Requires the tree feller ability in mcMMO to be active to use timber
201 #Only does something if mcMMO is installed
202 #Default: false
203 
204 hooks-require-ability-active: false
205  
206 #The type of animation to use for tree toppling
207 #Types: FANCY, DISINTEGRATE, CRUMBLE, NONE
208 
209 tree-animation-type: FANCY
210  
211 #If the tree-animation-type is FANCY or CRUMBLE, make the blocks stick to the ground
212 #Does nothing if tree-animation-type is not FANCY or CRUMBLE
213 #Default: false
214 
215 scatter-tree-blocks-on-ground: false
216  
217 #Tree configuration
218 #Allows for extreme fine-tuning of tree detection and what are considered trees
219 #Multiple log and leaf types are allowed, only one sapling type is allowed
220 #You can add your own custom tree types here, just add a new section
221 
222 trees:
223   oak:
224     logs:
225       - OAK_LOG
226       - STRIPPED_OAK_LOG
227       - OAK_WOOD
228       - STRIPPED_OAK_WOOD
229     leaves:
230       - OAK_LEAVES
231     sapling: OAK_SAPLING
232     plantable-soil: []
233     max-log-distance-from-trunk: 6
234     max-leaf-distance-from-log: 6
235     search-for-leaves-diagonally: false
236     drop-original-log: true
237     drop-original-leaf: false
238     log-loot: []
239     leaf-loot:
240       0:
241         material: OAK_SAPLING
242         chance: 5
243       1:
244         material: APPLE
245         chance: 0.5
246     entire-tree-loot: []
247     required-tools: []
248   spruce:
249     logs:
250       - SPRUCE_LOG
251       - STRIPPED_SPRUCE_LOG
252       - SPRUCE_WOOD
253       - STRIPPED_SPRUCE_WOOD
254     leaves:
255       - SPRUCE_LEAVES
256     sapling: SPRUCE_SAPLING
257     plantable-soil: []
258     max-log-distance-from-trunk: 2
259     max-leaf-distance-from-log: 6
260     search-for-leaves-diagonally: false
261     drop-original-log: true
262     drop-original-leaf: false
263     log-loot: []
264     leaf-loot:
265       0:
266         material: SPRUCE_SAPLING
267         chance: 5
268     entire-tree-loot: []
269     required-tools: []
270   birch:
271     logs:
272       - BIRCH_LOG
273       - STRIPPED_BIRCH_LOG
274       - BIRCH_WOOD
275       - STRIPPED_BIRCH_WOOD
276     leaves:
277       - BIRCH_LEAVES
278     sapling: BIRCH_SAPLING
279     plantable-soil: []
280     max-log-distance-from-trunk: 1
281     max-leaf-distance-from-log: 4
282     search-for-leaves-diagonally: false
283     drop-original-log: true
284     drop-original-leaf: false
285     log-loot: []
286     leaf-loot:
287       0:
288         material: BIRCH_SAPLING
289         chance: 5
290     entire-tree-loot: []
291     required-tools: []
292   jungle:
293     logs:
294       - JUNGLE_LOG
295       - STRIPPED_JUNGLE_LOG
296       - JUNGLE_WOOD
297       - STRIPPED_JUNGLE_WOOD
298     leaves:
299       - JUNGLE_LEAVES
300     sapling: JUNGLE_SAPLING
301     plantable-soil: []
302     max-log-distance-from-trunk: 6
303     max-leaf-distance-from-log: 6
304     search-for-leaves-diagonally: false
305     drop-original-log: true
306     drop-original-leaf: false
307     log-loot: []
308     leaf-loot:
309       0:
310         material: JUNGLE_SAPLING
311         chance: 2.5
312     entire-tree-loot: []
313     required-tools: []
314   acacia:
315     logs:
316       - ACACIA_LOG
317       - STRIPPED_ACACIA_LOG
318       - ACACIA_WOOD
319       - STRIPPED_ACACIA_WOOD
320     leaves:
321       - ACACIA_LEAVES
322     sapling: ACACIA_SAPLING
323     plantable-soil: []
324     max-log-distance-from-trunk: 4
325     max-leaf-distance-from-log: 5
326     search-for-leaves-diagonally: false
327     drop-original-log: true
328     drop-original-leaf: false
329     log-loot: []
330     leaf-loot:
331       0:
332         material: ACACIA_SAPLING
333         chance: 5
334     entire-tree-loot: []
335     required-tools: []
336   dark_oak:
337     logs:
338       - DARK_OAK_LOG
339       - STRIPPED_DARK_OAK_LOG
340       - DARK_OAK_WOOD
341       - STRIPPED_DARK_OAK_WOOD
342     leaves:
343       - DARK_OAK_LEAVES
344     sapling: DARK_OAK_SAPLING
345     plantable-soil: []
346     max-log-distance-from-trunk: 3
347     max-leaf-distance-from-log: 5
348     search-for-leaves-diagonally: false
349     drop-original-log: true
350     drop-original-leaf: false
351     log-loot: []
352     leaf-loot:
353       0:
354         material: DARK_OAK_SAPLING
355         chance: 5
356       1:
357         material: APPLE
358         chance: 0.5
359     entire-tree-loot: []
360     required-tools: []
361   brown_mushroom:
362     logs:
363       - MUSHROOM_STEM
364     leaves:
365       - BROWN_MUSHROOM_BLOCK
366     sapling: BROWN_MUSHROOM
367     plantable-soil:
368       - MYCELIUM
369     max-log-distance-from-trunk: 4
370     max-leaf-distance-from-log: 4
371     search-for-leaves-diagonally: false
372     drop-original-log: false
373     drop-original-leaf: false
374     log-loot: []
375     leaf-loot:
376       0:
377         material: BROWN_MUSHROOM
378         chance: 25
379     entire-tree-loot: []
380     required-tools: []
381   red_mushroom:
382     logs:
383       - MUSHROOM_STEM
384     leaves:
385       - RED_MUSHROOM_BLOCK
386     sapling: RED_MUSHROOM
387     plantable-soil:
388       - MYCELIUM
389     max-log-distance-from-trunk: 4
390     max-leaf-distance-from-log: 4
391     search-for-leaves-diagonally: true
392     drop-original-log: false
393     drop-original-leaf: false
394     log-loot: []
395     leaf-loot:
396       0:
397         material: RED_MUSHROOM
398         chance: 25
399     entire-tree-loot: []
400     required-tools: []
401  
402 #All soil types that the tree type's saplings can be planted on
403 
404 global-plantable-soil:
405   - GRASS_BLOCK
406   - DIRT
407   - COARSE_DIRT
408   - PODZOL
409  
410 #Custom loot that is available for all tree types
411 #The loot applies to each log broken in the tree
412 #To add more, increment the number by 1
413 #The chance is out of 100 and can contain decimals
414 #The default examples here are to show what you can do with custom loot
415 #Valid command placeholders: %player%, %type%, %xPos%, %yPos%, %zPos%
416 
417 global-log-loot:
418   0:
419     material: DIAMOND
420     chance: 0
421   1:
422     command: 'eco give %player% 5'
423     chance: 0
424   2:
425     material: GOLDEN_APPLE
426     command: 'broadcast %player% found a golden apple in a %type% tree at %xPos% %yPos% %zPos%!'
427     chance: 0
428  
429 #Custom loot that is available for all tree types
430 #The loot applies to each leaf broken in the tree
431 #To add more, increment the number by 1
432 #The chance is out of 100 and can contain decimals
433 #Valid command placeholders: %player%, %type%, %xPos%, %yPos%, %zPos%
434 
435 global-leaf-loot:
436   0:
437     material: GOLDEN_APPLE
438     chance: 0.1
439  
440 #Custom entire tree loot that is available for all tree types
441 #The loot will be dropped only one time for the entire tree
442 #To add more, increment the number by 1
443 #The chance is out of 100 and can contain decimals
444 #Valid command placeholders: %player%, %type%, %xPos%, %yPos%, %zPos%
445 
446 global-entire-tree-loot:
447   0:
448     material: DIAMOND
449     chance: 0
450  
451 #Tools that must be used to topple over a tree
452 #Applies to all tree types
453 
454 global-required-tools:
455   - WOODEN_AXE
456   - STONE_AXE
457   - IRON_AXE
458   - GOLDEN_AXE
459   - DIAMOND_AXE

1.12 and below config.yml

  1 #____ ___ __   __   __                __       ___________ __       ___
  2 #|    |   \  |_/  |_|__| _____ _____ _/  |_  ___\__    ___/|__| _____\_ |__   ___________
  3 #|    |   /  |\   __\  |/     \\__  \\   __\/ __ \|    |   |  |/     \| __ \_/ __ \_  __ \
  4 #|    |  /|  |_|  | |  |  Y Y  \/ __ \|  | \  ___/|    |   |  |  Y Y  \ \_\ \  ___/|  | \/
  5 #|______/ |____/__| |__|__|_|  (____  /__|  \___  |____|   |__|__|_|  /___  /\___  >__|
  6 
  7 #The type of server you are running in relation to this plugin
  8 #If you ever upgrade from a legacy version of Minecraft to a current version, you will need to reset this config
  9 #Do not change this value
 10 #Default: LEGACY
 11 
 12 server-type: LEGACY
 13 
 14 #The locale to use in the /locale folder
 15 #Default: en_US
 16 
 17 locale: en_US
 18 
 19 #A list of worlds that the plugin is disabled in
 20 #Default:
 21 #- disabled_world_name
 22 
 23 disabled-worlds:
 24   - disabled_world_name
 25 
 26 #The max number of logs that can be broken at one time
 27 #Default: 150
 28 
 29 max-logs-per-chop: 150
 30 
 31 #The minimum number of leaves required for something to be considered a tree
 32 #Default: 5
 33 
 34 leaves-required-for-tree: 5
 35 
 36 #If leaves should be destroyed
 37 #Default: true
 38 
 39 destroy-leaves: true
 40 
 41 #Apply realistic damage to the tools based on the number of logs chopped
 42 #If false, only one durability will be removed from the tool
 43 #Default: true
 44 
 45 realistic-tool-damage: true
 46 
 47 #Protect the tool used to chop down the tree from breaking
 48 #Prevents the tree from being toppled if the tool would break
 49 #Default: false
 50 
 51 protect-tool: false
 52 
 53 #Use the silk touch enchantment if the tool has it
 54 #Logs and leaves will drop their original block 100% of the time
 55 #Default: true
 56 
 57 apply-silk-touch: true
 58 
 59 #Damage the tool extra for each leaf block broken, this is vanilla behavior but can be disabled here
 60 #Does nothing if realistic-tool-damage is false
 61 #Default: true
 62 
 63 apply-silk-touch-tool-damage: true
 64 
 65 #Require the entire base of the tree to be broken before it topples
 66 #Default: false
 67 
 68 break-entire-tree-base: false
 69 
 70 #Don't drop a block for the block that initiates the tree fall
 71 #Default: false
 72 
 73 destroy-initiated-block: false
 74 
 75 #Only detect logs above the initiated block
 76 #Default: true
 77 
 78 only-detect-logs-upwards: true
 79 
 80 #Only topple trees while the player is doing something
 81 #Valid values: SNEAKING, NOT_SNEAKING, ALWAYS
 82 #Default: ALWAYS
 83 
 84 only-topple-while: ALWAYS
 85 
 86 #Allow toppling trees in creative mode
 87 #Default: true
 88 
 89 allow-creative-mode: true
 90 
 91 #Require the player to have the permission 'ultimatetimber.chop' to topple trees
 92 #Default: false
 93 
 94 require-chop-permission: false
 95 
 96 #If a player should only be allowed to chop one tree per cooldown length
 97 #Default: false
 98 
 99 player-tree-topple-cooldown: false
100 
101 #The amount of seconds a player has to wait before they can chop a tree again
102 #Does nothing if player-tree-topple-cooldown is false
103 #The time is in seconds and must be a postive whole number
104 #Default: 5
105 
106 player-tree-topple-cooldown-length: 5
107 
108 #Allow players to topple trees regardless of what they are holding in their hand
109 #Default: false
110 
111 ignore-required-tools: false
112 
113 #Automatically replant saplings when a tree is toppled
114 #Default: true
115 
116 replant-saplings: true
117 
118 #Always replant saplings for base tree blocks, regardless of player permissions
119 #Default: false
120 
121 always-replant-sapling: false
122 
123 #How many seconds to prevent players from breaking replanted saplings
124 #Set to 0 to disable
125 #Does nothing if replant-saplings is false
126 #The time is in seconds and must be a postive whole number
127 #Default: 3
128 
129 replant-saplings-cooldown: 3
130 
131 #Give fallen leaf blocks a chance to replant saplings when they hit the ground
132 #Default: true
133 
134 falling-blocks-replant-saplings: true
135 
136 #The percent chance that fallen leaves have of planting a sapling
137 #Does nothing if falling-blocks-replant-saplings is false
138 #The chance is out of 100 and may contain decimals
139 #Default: 1
140 
141 falling-blocks-replant-saplings-chance: 1
142 
143 #Make falling tree blocks deal damage to players if they get hit
144 #Default: true
145 
146 falling-blocks-deal-damage: true
147 
148 #The amount of damage that falling tree blocks do
149 #This does nothing if falling-blocks-deal-damage is false
150 #Default: 1
151 
152 falling-block-damage: 1
153 
154 #Automatically add tree blocks to the player's inventory instead of dropping them
155 #Default: false
156 
157 add-items-to-inventory: false
158 
159 #Use custom sounds when toppling trees
160 #Default: true
161 
162 use-custom-sounds: true
163 
164 #Use custom particles when toppling trees
165 #Default: true
166 
167 use-custom-particles: true
168 
169 #The bonus loot multiplier when a player has the permission ultimatetimber.bonusloot
170 #Multiplies the chance of tree drops by this value
171 #Decimal values are allowed
172 #Default: 2
173 
174 bonus-loot-multiplier: 2
175 
176 #If placed blocks should be ignored for toppling trees
177 #Note: This only keeps track of blocks placed during the current server load
178 #If your server restarts, the placed tree blocks could be toppled again
179 #Default: true
180 
181 ignore-placed-blocks: true
182 
183 #The maximum number of blocks to keep track of in memory at once
184 #Use a lower number if this starts to take up too much memory or trees start taking too long to detect
185 #Default: 5000
186 
187 ignore-placed-blocks-memory-size: 5000
188 
189 #Applies experience when using Jobs/mcMMO
190 #Only does something if Jobs or mcMMO is installed
191 #Default: true
192 
193 hooks-apply-experience: true
194 
195 #Applies extra drops passive ability when using mcMMO
196 #Only does something if mcMMO is installed
197 #Default: true
198 
199 hooks-apply-extra-drops: true
200 
201 #Requires the tree feller ability in mcMMO to be active to use timber
202 #Only does something if mcMMO is installed
203 #Default: false
204 
205 hooks-require-ability-active: false
206 
207 #The type of animation to use for tree toppling
208 #Types: FANCY, DISINTEGRATE, CRUMBLE, NONE
209 
210 tree-animation-type: FANCY
211 
212 #If the tree-animation-type is FANCY or CRUMBLE, make the blocks stick to the ground
213 #Does nothing if tree-animation-type is not FANCY or CRUMBLE
214 #Default: false
215 
216 scatter-tree-blocks-on-ground: false
217 
218 #Tree configuration
219 #Allows for extreme fine-tuning of tree detection and what are considered trees
220 #Multiple log and leaf types are allowed, only one sapling type is allowed
221 #You can add your own custom tree types here, just add a new section
222 
223 trees:
224   oak:
225     logs:
226       - LOG:0,4,8,12
227     leaves:
228       - LEAVES:0,4,8,12
229     sapling: SAPLING:0
230     plantable-soil: []
231     max-log-distance-from-trunk: 6
232     max-leaf-distance-from-log: 6
233     search-for-leaves-diagonally: false
234     drop-original-log: true
235     drop-original-leaf: false
236     log-loot: []
237     leaf-loot:
238       0:
239         material: SAPLING:0
240         chance: 5
241       1:
242         material: APPLE
243         chance: 0.5
244     entire-tree-loot: []
245     required-tools: []
246   spruce:
247     logs:
248       - LOG:1,5,9,13
249     leaves:
250       - LEAVES:1,5,9,13
251     sapling: SAPLING:1
252     plantable-soil: []
253     max-log-distance-from-trunk: 2
254     max-leaf-distance-from-log: 6
255     search-for-leaves-diagonally: false
256     drop-original-log: true
257     drop-original-leaf: false
258     log-loot: []
259     leaf-loot:
260       0:
261         material: SAPLING:1
262         chance: 5
263     entire-tree-loot: []
264     required-tools: []
265   birch:
266     logs:
267       - LOG:2,6,10,14
268     leaves:
269       - LEAVES:2,6,10,14
270     sapling: SAPLING:2
271     plantable-soil: []
272     max-log-distance-from-trunk: 1
273     max-leaf-distance-from-log: 4
274     search-for-leaves-diagonally: false
275     drop-original-log: true
276     drop-original-leaf: false
277     log-loot: []
278     leaf-loot:
279       0:
280         material: SAPLING:2
281         chance: 5
282     entire-tree-loot: []
283     required-tools: []
284   jungle:
285     logs:
286       - LOG:3,7,11,15
287     leaves:
288       - LEAVES:3,7,11,15
289     sapling: SAPLING:3
290     plantable-soil: []
291     max-log-distance-from-trunk: 6
292     max-leaf-distance-from-log: 6
293     search-for-leaves-diagonally: false
294     drop-original-log: true
295     drop-original-leaf: false
296     log-loot: []
297     leaf-loot:
298       0:
299         material: SAPLING:3
300         chance: 2.5
301     entire-tree-loot: []
302     required-tools: []
303   acacia:
304     logs:
305       - LOG_2:0,4,8,12
306     leaves:
307       - LEAVES_2:0,4,8,12
308     sapling: SAPLING:4
309     plantable-soil: []
310     max-log-distance-from-trunk: 4
311     max-leaf-distance-from-log: 5
312     search-for-leaves-diagonally: false
313     drop-original-log: true
314     drop-original-leaf: false
315     log-loot: []
316     leaf-loot:
317       0:
318         material: SAPLING:4
319         chance: 5
320     entire-tree-loot: []
321     required-tools: []
322   dark_oak:
323     logs:
324       - LOG_2:1,5,9,13
325     leaves:
326       - LEAVES_2:1,5,9,13
327     sapling: SAPLING:5
328     plantable-soil: []
329     max-log-distance-from-trunk: 3
330     max-leaf-distance-from-log: 5
331     search-for-leaves-diagonally: false
332     drop-original-log: true
333     drop-original-leaf: false
334     log-loot: []
335     leaf-loot:
336       0:
337         material: SAPLING:5
338         chance: 5
339       1:
340         material: APPLE
341         chance: 0.5
342     entire-tree-loot: []
343     required-tools: []
344   brown_mushroom:
345     logs:
346       - HUGE_MUSHROOM_1:15,10
347     leaves:
348       - HUGE_MUSHROOM_1:14,0,1,2,3,4,5,6,7,8,9
349     sapling: BROWN_MUSHROOM
350     plantable-soil:
351       - MYCEL
352     max-log-distance-from-trunk: 4
353     max-leaf-distance-from-log: 4
354     search-for-leaves-diagonally: false
355     drop-original-log: false
356     drop-original-leaf: false
357     log-loot: []
358     leaf-loot:
359       0:
360         material: BROWN_MUSHROOM
361         chance: 25
362     entire-tree-loot: []
363     required-tools: []
364   red_mushroom:
365     logs:
366       - HUGE_MUSHROOM_2:15,10
367     leaves:
368       - HUGE_MUSHROOM_2:14,0,1,2,3,4,5,6,7,8,9
369     sapling: RED_MUSHROOM
370     plantable-soil:
371       - MYCEL
372     max-log-distance-from-trunk: 4
373     max-leaf-distance-from-log: 4
374     search-for-leaves-diagonally: true
375     drop-original-log: false
376     drop-original-leaf: false
377     log-loot: []
378     leaf-loot:
379       0:
380         material: RED_MUSHROOM
381         chance: 25
382     entire-tree-loot: []
383     required-tools: []
384 
385 #All soil types that the tree type's saplings can be planted on
386 
387 global-plantable-soil:
388   - GRASS
389   - DIRT:0
390   - DIRT:1
391   - DIRT:2
392 
393 #Custom loot that is available for all tree types
394 #The loot applies to each log broken in the tree
395 #To add more, increment the number by 1
396 #The chance is out of 100 and can contain decimals
397 #The default examples here are to show what you can do with custom loot
398 #Valid command placeholders: %player%, %type%, %xPos%, %yPos%, %zPos%
399 
400 global-log-loot:
401   0:
402     material: DIAMOND
403     chance: 0
404   1:
405     command: 'eco give %player% 5'
406     chance: 0
407   2:
408     material: GOLDEN_APPLE
409     command: 'broadcast %player% found a golden apple in a %type% tree at %xPos% %yPos% %zPos%!'
410     chance: 0
411 
412 #Custom loot that is available for all tree types
413 #The loot applies to each leaf broken in the tree
414 #To add more, increment the number by 1
415 #The chance is out of 100 and can contain decimals
416 #Valid command placeholders: %player%, %type%, %xPos%, %yPos%, %zPos%
417 
418 global-leaf-loot:
419   0:
420     material: GOLDEN_APPLE
421     chance: 0.1
422 
423 #Custom entire tree loot that is available for all tree types
424 #The loot will be dropped only one time for the entire tree
425 #To add more, increment the number by 1
426 #The chance is out of 100 and can contain decimals
427 #Valid command placeholders: %player%, %type%, %xPos%, %yPos%, %zPos%
428 
429 global-entire-tree-loot:
430   0:
431     material: DIAMOND
432     chance: 0
433 
434 #Tools that must be used to topple over a tree
435 #Applies to all tree types
436 
437 global-required-tools:
438   - WOOD_AXE
439   - STONE_AXE
440   - IRON_AXE
441   - GOLD_AXE
442   - DIAMOND_AXE

Translations

We offer translated versions of this plugin! In order to use them, enter the corresponding Language Code into your config.yml.

Translations

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

Why isn't UltimateTimber working in my world?

Make sure that the world name isn't disabled in the config.yml.

How can I add compatibility for custom trees or world generators?

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.