lumberjack/README.md

# Lumberjack

A Mod for tree harvesting and planting!

This mod fulfills several aspects:
- New players are trained to always fell trees completely and replace them with saplings (education for sustainability)
- Trained players with additional "skills" get lumberjack privs to fell trees more efficiently (based on ideas from TreeCapitator and several Timber mods)
- No parts of trees hanging in the air anymore
  
This mod allows to completely fell trees by destroying only one block. The whole tree is harvested and moved to the players inventory. But therefore lumberjack privs are needed. New player normally will not get the necessary privs immediately, they have to harvest the tree from the top, block by block "to improve their skills".

But there are three configuration possibilities:
1. All players get directly lumberjack privs
2. Players have to collect points to get lumberjack privs
3. Players will never get lumberjack privs from the mod itself (but will be granted by means of other reasons)

Points have to be collected by harvesting tree blocks *AND* planting saplings.
The default setting is 400 which means, you have to harvest more then 400 tree blocks and plant more then 66 (400/6) saplings to get lumberjack privs.

The configuration can be changed directly in the file 'settingtypes.txt' or by means of the Minetest GUI.

Some technical aspects:
- 'param1' of the nodes data is used to distinguish between grown trees and placed tree blocks so that this mod will not have any impact to buildings or other objects based on tree blocks
- an API function allows to register additional trees from other mods, which is quite simple
- the Ethereal mod is already supported, others will follow
 
 
## Dependencies
default

# License
Copyright (C) 2018-2020 Joachim Stolberg  
Code: Licensed under the GNU LGPL version 2.1 or later. See LICENSE.txt and http://www.gnu.org/licenses/lgpl-2.1.txt  
Sound is taken from Hybrid Dog (TreeCapitator)

# History
v0.1 - 07/Apr/2018 - Mod initial created  
v0.2 - 08/Apr/2018 - Priv 'lumberjack' added, digging of trees from the top only added, tool wearing added  
v0.3 - 09/Apr/2018 - Harvesting points for placing saplings and destroying tree blocks added to reach lumberjack privs  
v0.4 - 16/Apr/2018 - Stem steps added  
v0.5 - 17/Apr/2018 - protection bug fixed, further improvements  
v0.6 - 07/Jan/2020 - screwdriver bugfix
v0.7 - 27/May/2020 - ethereal bugfix
initial commit 2018-04-07 23:28:59 +02:00			`# Lumberjack`

readme revised, minor improvements 2018-04-10 20:43:15 +02:00			`A Mod for tree harvesting and planting!`
Harvesting points for placing saplings and destroying tree blocks added to reach lumberjack privs. 2018-04-09 22:55:12 +02:00
readme revised, minor improvements 2018-04-10 20:43:15 +02:00			`This mod fulfills several aspects:`
			`- New players are trained to always fell trees completely and replace them with saplings (education for sustainability)`
			`- Trained players with additional "skills" get lumberjack privs to fell trees more efficiently (based on ideas from TreeCapitator and several Timber mods)`
			`- No parts of trees hanging in the air anymore`

readme revised, minor improvements 2018-04-10 20:49:11 +02:00			`This mod allows to completely fell trees by destroying only one block. The whole tree is harvested and moved to the players inventory. But therefore lumberjack privs are needed. New player normally will not get the necessary privs immediately, they have to harvest the tree from the top, block by block "to improve their skills".`
Harvesting points for placing saplings and destroying tree blocks added to reach lumberjack privs. 2018-04-09 22:55:12 +02:00
typos 2018-04-10 20:59:29 +02:00			`But there are three configuration possibilities:`
readme revised, minor improvements 2018-04-10 20:43:15 +02:00			`1. All players get directly lumberjack privs`
			`2. Players have to collect points to get lumberjack privs`
			`3. Players will never get lumberjack privs from the mod itself (but will be granted by means of other reasons)`
initial commit 2018-04-07 23:28:59 +02:00
readme revised, minor improvements 2018-04-10 20:49:11 +02:00			`Points have to be collected by harvesting tree blocks AND planting saplings.`
typos 2018-04-10 20:59:29 +02:00			`The default setting is 400 which means, you have to harvest more then 400 tree blocks and plant more then 66 (400/6) saplings to get lumberjack privs.`
initial commit 2018-04-07 23:28:59 +02:00
readme revised, minor improvements 2018-04-10 20:43:15 +02:00			`The configuration can be changed directly in the file 'settingtypes.txt' or by means of the Minetest GUI.`

			`Some technical aspects:`
readme revised, minor improvements 2018-04-10 20:49:11 +02:00			`- 'param1' of the nodes data is used to distinguish between grown trees and placed tree blocks so that this mod will not have any impact to buildings or other objects based on tree blocks`
typos 2018-04-10 20:59:29 +02:00			`- an API function allows to register additional trees from other mods, which is quite simple`
readme revised, minor improvements 2018-04-10 20:49:11 +02:00			`- the Ethereal mod is already supported, others will follow`
readme revised, minor improvements 2018-04-10 20:43:15 +02:00

initial commit 2018-04-07 23:28:59 +02:00			`## Dependencies`
			`default`

			`# License`
screwdriver bugfix 2020-01-06 13:57:27 +01:00			`Copyright (C) 2018-2020 Joachim Stolberg`
initial commit 2018-04-07 23:28:59 +02:00			`Code: Licensed under the GNU LGPL version 2.1 or later. See LICENSE.txt and http://www.gnu.org/licenses/lgpl-2.1.txt`
			`Sound is taken from Hybrid Dog (TreeCapitator)`

			`# History`
typo 2018-04-09 23:42:47 +02:00			`v0.1 - 07/Apr/2018 - Mod initial created`
typo 2018-04-09 23:42:00 +02:00			`v0.2 - 08/Apr/2018 - Priv 'lumberjack' added, digging of trees from the top only added, tool wearing added`
typo 2018-04-09 23:42:47 +02:00			`v0.3 - 09/Apr/2018 - Harvesting points for placing saplings and destroying tree blocks added to reach lumberjack privs`
stem steps added 2018-04-16 22:19:31 +02:00			`v0.4 - 16/Apr/2018 - Stem steps added`
v0.5 - protection bug fixed, further improvements 2018-04-17 20:14:26 +02:00			`v0.5 - 17/Apr/2018 - protection bug fixed, further improvements`
ethereal bugfix 2020-05-27 18:38:31 +02:00			`v0.6 - 07/Jan/2020 - screwdriver bugfix`
			`v0.7 - 27/May/2020 - ethereal bugfix`
stem steps added 2018-04-16 22:19:31 +02:00