HT's TreeChop - HT's TreeChop 砍树模组

TreeChop

允许通过反复破坏单个方块来砍倒整棵树。只有在砍击达到一定次数后，整棵树才会倒下，而且越大的树需要的砍击次数越多。灵感来自 Treecapitator 之类的模组。

很酷的特性：

• 砍大树时不会太吵
• 适用于蘑菇和菌类
• 智能破坏树叶
• 兼容大多数模组树木

作为伐木工时需要注意的事项：

• 砍树不一定需要斧头，但没有斧头会花更长时间
• 砍击同一棵树的不同方块，都会累计到砍倒这棵树的进度中
• 玩家可以一起合作砍倒那些大树
• 更大的树需要更多总砍击次数，但平均到每个方块所需的砍击次数更少*
• 破坏原木方块时按住“潜行”可正常破坏它

*默认情况下，砍倒一棵树所需的砍击次数按对数方式计算。下面给出了一些示例数值。也可以将砍击次数配置为按方块数量线性增长，例如每个方块需要砍一次，或每棵树只需砍一次。更多信息见这里。

兼容性：

对以下模组提供特殊支持：

• (1.18.2) Tinker's Construct：宽刃斧可进行额外砍击。所有斧头在拥有 “expanded” 升级时都会进行更多砍击。
• (1.18.2+) Silent Gear：锯可进行额外砍击
• (1.18.2+) Project MMO：砍树会给予伐木 XP
• (1.18.2+) Jade, WTHIT, TheOneProbe：显示树中原木方块的数量以及砍倒所需的砍击次数。

已知问题：

• (1.18.2 及更早版本) Multi Mine：可砍击方块需要加入 Multi Mine 的黑名单中。这个问题在 1.19+ 版本中应该已修复。见 #106。
• 某些模组树在倒下后会留下漂浮方块。见 #44。

想让你的模组与 TreeChop 兼容吗？参见 wiki。

FAQ：

1. 我该如何关闭 chopping？

按 n 打开 TreeChop 的游戏内设置，然后关闭 “chopping” 选项。你也可以绑定一个按键来切换 chopping，而无需打开设置界面；前往 选项 > 控制，找到名为 “HT's TreeChop” 的分类。

2. 我该如何让 chopping 默认关闭，只在潜行时开启？

默认情况下，潜行会反转你当前的 chop 设置，所以只需把 chopping 关闭（按 n 打开设置界面），这样潜行时就会启用 chopping。

3. 我该如何在潜行时依然保持 chopping？

按 n 打开 TreeChop 的游戏内设置，然后关闭 “Sneaking inverts chopping” 选项。

4. 我该如何避免把我的房子砍掉？

有一个设置可以在“树”没有连接树叶时禁用 chopping。按 n 打开 TreeChop 的游戏内设置，然后切换 “trees must have leaves”。

5. 我开始砍我的房子了。我该怎么停下？

如果你发现自己在砍一个本来只想正常破坏的方块，试着在潜行时破坏它，或者关闭 chopping（按 n 打开设置界面）。

6. 我刚刚砍东西时游戏崩溃了！这是怎么回事？

大概率是你用来砍树的物品和 TreeChop 兼容性不好。前往 [your minecraft folder]/config/treechop-common.toml，把该物品的注册名加入 choppingToolsBlacklist，或者让服务器管理员这么做。然后你也可以把这个冲突告诉我，我会尽量修复。

7. 为什么我再也不能砍树了？

可能是 chopping 被关闭了；按 n 打开 TreeChop 的游戏内设置，然后启用 “chopping” 选项。如果 chopping 已启用且更换工具也没用，那可能是与其他模组发生了冲突。如果你把最近的日志发给我，我会尽量修复。

8. 为什么有些树在倒下后会留下漂浮的树叶？

可能是以下原因之一

a) 这是模组树，而且它的树叶没有被正确设置。告诉我是哪种树有问题，我会礼貌地通知模组作者。

b) 树叶太多了！你可以前往 [your minecraft folder]/config/treechop-common.toml，增大 maxLeavesBlocks。

9. 为什么有些树在倒下后会留下漂浮的原木？

可能是以下原因之一

a) 这是模组树，而且形状很奇怪。告诉我，我会尽量让 TreeChop 更好地检测这种树。

b) 树太大了！你可以前往 [your minecraft folder]/config/treechop-common.toml，增大 maxTreeBlocks。

10. 我该如何禁用蘑菇和菌类的 chopping？

前往 [your minecraft folder]/config/treechop-common.toml 并将

    blockTagForDetectingLogs = "treechop:choppables"

改为

    blockTagForDetectingLogs = "treechop:choppablesexceptmushrooms"

如果你想更精确地控制哪些方块可以被砍，你需要自己制作一个数据包并调整方块标签（更多信息见 https://minecraft.gamepedia.com/Tag）。

12. 为什么我看不到 [fill in the blank] 功能？

只有 Minecraft 1.16 的最新版本才获得完整支持。一些较旧的版本，尤其是 1.12.2，缺少一些更高级的功能。

11. 我可以把它加入整合包吗？

可以！

示例配置：

treechop-common.toml

[permissions]

	[permissions.choppingEnabled]
		canBeFalse = true
		canBeTrue = true

	[permissions.fellingEnabled]
		canBeFalse = true
		canBeTrue = true

	[permissions.sneakBehavior]
		canBeNone = true
		canBeInvertFelling = true
		canBeInvertChopping = true

	[permissions.treeMustHaveLeaves]
		canBeFalse = true
		canBeTrue = true

	[permissions.chopInCreativeMode]
		canBeFalse = true
		canBeTrue = true

[general]
	#If false, log items will be destroyed when chopping
	dropLootForChoppedBlocks = true

[treeDetection]
	#Maximum number of log blocks that can be detected to belong to one tree
	#Range: 1 ~ 8096
	maxTreeBlocks = 320
	#Maximum number of leaves blocks that can destroyed when a tree is felled
	#Range: 1 ~ 8096
	maxLeavesBlocks = 1024
	#Destroy leaves when a tree is felled
	breakLeaves = true
	#Non-decayable leaves are ignored when detecting leaves
	ignorePersistentLeaves = true
	#Maximum distance from log blocks to destroy non-standard leaves blocks (e.g. mushroom caps) when felling
	#Range: 0 ~ 16
	maxBreakLeavesDistance = 7

	[treeDetection.logs]
		#Blocks that should be considered choppable
		#Specify using registry names (mod:block), tags (#mod:tag), and namespaces (@mod)
		blocks = ["#treechop:choppables", "#minecraft:logs", "#forge:mushroom_stems"]
		#Blocks that should never be chopped, even if included in the list above
		#Specify using registry names (mod:block), tags (#mod:tag), and namespaces (@mod)
		exceptions = ["minecraft:bamboo"]

	[treeDetection.leaves]
		#Blocks that should be considered leaves
		#Specify using registry names (mod:block), tags (#mod:tag), and namespaces (@mod)
		blocks = ["#treechop:leaves_like", "#minecraft:leaves", "#minecraft:wart_blocks", "#forge:mushroom_caps", "minecraft:shroomlight"]
		#Blocks that should never be considered leaves, even if included in the list above
		#Specify using registry names (mod:block), tags (#mod:tag), and namespaces (@mod)
		exceptions = []

[chopCounting]
	#Method to use for computing the number of chops needed to fell a tree
	#Allowed Values: LINEAR, LOGARITHMIC
	algorithm = "LOGARITHMIC"
	#How to round the number of chops needed to fell a tree; this is more meaningful for smaller trees
	#Allowed Values: DOWN, NEAREST, UP
	rounding = "NEAREST"
	#Felling a tree can require more chops than the number of blocks in the tree
	canRequireMoreChopsThanBlocks = false

	#See https://github.com/hammertater/treechop/#logarithmic
	[chopCounting.logarithmic]
		#Determines the number of chops required to fell a tree; higher values require more chops for bigger trees
		#Range: 0.0 ~ 10000.0
		a = 10.0

	#See https://github.com/hammertater/treechop/#linear
	[chopCounting.linear]
		#The number of chops per block required to fell a tree; if chopsPerBlock = 0.5, it will take 50 chops to fell a 100 block tree
		#Range: 0.0 ~ 7.0
		chopsPerBlock = 1.0
		#The base number of chops required to fell a tree regardless of its size
		#Range: -10000.0 ~ 10000.0
		baseNumChops = 0.0

[compatibility]
	#Better chopping behavior for block with the #forge:mushroom_stems tag
	mushroomStems = true
	#https://www.curseforge.com/minecraft/mc-mods/carry-on
	#https://modrinth.com/mod/carry-on
	#Small fixes.
	carryOn = true
	#https://www.curseforge.com/minecraft/mc-mods/project-mmo
	#https://modrinth.com/mod/project-mmo
	#Award woodcutting XP for chopping.
	projectMMO = true
	#https://www.curseforge.com/minecraft/mc-mods/the-one-probe
	#https://modrinth.com/mod/the-one-probe
	#Shows the number of chops required to fell a tree and what loot will drop.
	theOneProbe = true

	[compatibility.general]
		#Prevent chopping when right-clicking blocks
		preventChoppingOnRightClick = false
		#Prevent infinite loops when chopping; fixes crashes when using modded items that break multiple blocks
		preventChopRecursion = true
		#Only chop when using the correct tool for drops, if any (does nothing in vanilla, but some mods add tool requirements to logs
		choppingRequiresCorrectToolForDrops = true
		#Only chop when using a tool that increases block breaking speed (such as axes for logs)
		choppingRequiresFastBreakingTool = true

		[compatibility.general.blacklist]
			#Whether the listed items should be blacklisted or whitelisted
			#Allowed Values: BLACKLIST, WHITELIST
			blacklistOrWhitelist = "BLACKLIST"
			#List of item registry names (mod:item), tags (#mod:tag), and namespaces (@mod) for items that should not chop when used to break a log
			#- Items in this list that have special support for TreeChop will not be blacklisted; see https://github.com/hammertater/treechop/blob/main/docs/compatibility.md#blacklist
			items = ["#tconstruct:modifiable/harvest", "botania:terra_axe", "mekanism:atomic_disassembler", "@lumberjack", "practicaltools:iron_greataxe", "practicaltools:golden_greataxe", "practicaltools:diamond_greataxe", "practicaltools:netherite_greataxe"]

		#The chop settings used by non-player entities, such as robots and machine blocks
		[compatibility.general.fakePlayerChopSettings]
			#Use with caution! May cause conflicts with some mods, e.g. https://github.com/hammertater/treechop/issues/71
			choppingEnabled = false
			#Felling only matters if chopping is enabled; probably best to leave this on
			fellingEnabled = true
			treesMustHaveLeaves = true

	[compatibility.API]
		#Log information about TreeChop API usage. May be useful for debugging mod compatibility issues.
		verbose = false

	[compatibility.silentgear]
		#https://www.curseforge.com/minecraft/mc-mods/tinkers-construct
		#https://modrinth.com/mod/tinkers-construct
		#Makes saws do more chops.
		enabled = true
		#Number of chops a saw should perform on a single block break
		#Range: 1 ~ 10000
		sawChops = 5

	[compatibility.tinkersConstruct]
		#https://www.curseforge.com/minecraft/mc-mods/tinkers-construct
		#https://modrinth.com/mod/tinkers-construct
		#Makes AOE tools do more chops.
		enabled = true
		#Number of chops that tree breaking tools (like broad axes) should perform on a single block break
		#Range: 1 ~ 10000
		treeBreakingTools = 5
		#Number of chops that wood breaking tools (like hand axes) should perform on a single block break
		#Range: 1 ~ 10000
		woodBreakingTools = 1
		#The chop count multiplier for each level of the expanded upgrade
		#Range: 1.0 ~ 10000.0
		expandedMultiplier = 2.0

[mod]
	#Set to false to disable TreeChop without having to uninstall the mod
	enabled = true
	#Let TreeChop print to the log
	printDebugInfo = false

treechop-client.toml

[chopping]
	#Default setting for whether or not the user wishes to chop (can be toggled in-game)
	choppingEnabled = true
	#Default setting for whether or not the user wishes to fell tree when chopping (can be toggled in-game)
	fellingEnabled = true
	#Default setting for the effect that sneaking has on chopping (can be cycled in-game)
	#Allowed Values: NONE, INVERT_CHOPPING, INVERT_FELLING
	sneakBehavior = "INVERT_CHOPPING"
	#Ignore trees without connected leaves (can be toggled in-game)
	treesMustHaveLeaves = true
	#Enable chopping in creative mode (even when false, sneaking can still enable chopping) (can be toggled in-game)
	chopInCreativeMode = false

[visuals]
	#Visually replace the interior sides of logs with a chopped texture instead of bark
	removeBarkOnInteriorLogs = true

	[visuals.choppingIndicator]
		#Show an on-screen indicator when a block will be chopped instead of broken (can be toggled in-game)
		enabled = true
		#Horizontal location of the indicator relative to the player's crosshairs; positive values move the indicator to the right
		#Range: -256 ~ 256
		xOffset = 16
		#Vertical location of the indicator relative to the player's crosshairs; positive values move the indicator down
		#Range: -256 ~ 256
		yOffset = 0

[settingsScreen]
	#Show in-game options for enabling and disable felling (can be toggled in-game)
	showFellingOptions = true
	#Show chat confirmations when using hotkeys to change chop settings (can be toggled in-game)
	showFeedbackMessages = true
	#Show tooltips in the settings screen (can be toggled in-game)
	showTooltips = true