Ultimate Timber
Give your players a new, entertaining, and highly customizable way to chop down trees.
Part of the Ultimate Series.
Contents
Getting Started[edit | edit source]
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[edit | edit source]
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 #____ ___ __ __ __ __ ___________ __ ___
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[edit | edit source]
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[edit | edit source]
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[edit | edit source]
- mcMMO Classic
- mcMMO Overhaul
- Jobs Reborn
- Custom World Generation Plugin
Tutorial[edit | edit source]
Build 2.0.6
Frequently Asked Questions[edit | edit source]
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.