
TimberZ 是一款 Minecraft 插件,让你能够瞬间砍倒树木。你可以选择让它始终处于激活状态、可切换模式、制作特殊的伐木斧,或者使用自定义附魔。
功能
- ✅ 高级树木检测
- ✅ 自定义附魔
- ✅ 可自定义的树木类型
- ✅ 砍伐动画效果
- ✅ 可切换的 Timber 模式
- ✅ 自定义物品支持
- ✅ HEX 颜色代码
- ✅ 高度可定制
- ✅ 易于设置
- ✅ 多语言支持

权限
timberz.usetimber - 允许玩家使用 TimberZ。(默认开启)
timberz.admin - 允许玩家使用管理命令。(默认仅限 OP)
兼容性
✅ PlaceholderAPI
TimberZ 支持 PlaceholderAPI,允许你在消息和配置中使用占位符:
%timberz_can_timber% - 如果玩家可以使用 TimberZ 则返回 true。此占位符会考虑权限、区域和其他限制条件。
✅ WorldGuard
TimberZ 支持 WorldGuard,允许你限制在特定区域内的 TimberZ 使用。你可以使用 timber 标志来允许或禁止在该区域内使用 TimberZ。
✅ AuraSkills
将 TimberZ 与 AuraSkills 配合使用时,玩家在砍树时会获得正确的经验值。你也可以在 TimberZ 的配置文件中添加自定义的经验倍数。
配置
你可以在 plugins/TimberZ 文件夹中找到配置文件。主配置文件是 config.yml,此外还有一个 blocks.yml 文件,其中包含原木、树叶和树苗的方块映射。
config.yml
# _______ _ _ ______
# |__ __(_) | | |___ /
# | | _ _ __ ___ | |__ ___ _ __ / /
# | | | | '_ ` _ \| '_ \ / _ \ '__| / /
# | | | | | | | | | |_) | __/ | / /__
# |_| |_|_| |_| |_|_.__/ \___|_| /_____|
# === 颜色代码 ===
# 本插件支持旧版颜色代码,例如:&c, &l, &o 等。
# 它还支持 MiniMessage,这是一种更高级的消息格式化方式:
# https://docs.advntr.dev/minimessage/format.html
# 使用 MiniMessage,你可以添加 HEX 颜色、渐变、悬停和点击事件等。
# === 常规设置 ===
# 如果设置为 true,TimberZ 将检查更新并告知是否有新版本
checkForUpdates: true
# 将语言设置为 "lang" 文件夹中找到的任何代码(不要添加 .yml 扩展名)
# 你可以添加自己的语言文件。使用 https://github.com/ZetaPlugins/TimberZ/tree/main/src/main/resources/lang/en-US.yml 作为模板
# 如果你想帮助翻译本插件,请参阅此文章:https://docs.zetaplugins.com/#contributing
# | en-US | de-DE | pl-PL | ru-RU |
lang: "en-US"
# 插件的强调色。此颜色会替换 lang 文件中的 %ac%。
accentColor: "<#00D26A>"
# === 砍伐设置 ===
# 无论以下设置如何,你都可以通过取消赋予玩家 "timberz.usetimber" 权限来禁止特定玩家使用 TimberZ。
# 如果设置为 true,玩家可以手持符合条件的斧头按 F 键来启用或禁用 timber 模式
toggleTimber: true
# 如果设置为 true,你只能使用带有 "Timber" 附魔的斧头,该附魔可以像普通附魔一样应用。
requireCustomEnchant: true
# 如果设置为 true,你只能使用具有下方列表中 customModelData 值的斧头
restrictAxeModelData: false
# 如果 restrictAxeModelData 设置为 true,你只能使用具有此列表中 customModelData 值的斧头
allowedModelData:
- 100
# 如果设置为 true,砍倒树木时树叶会立即消失
instantLeafDecay: true
# 如果设置为 true,TimberZ 会在砍倒树木后重新种植
replant: true
# 修改砍倒树木时从斧头上扣除耐久度的量
# 公式:logCount * durabilityMultiplier
durabilityMultiplier: 1.0
# 砍倒树木后斧头必须保留的最小耐久度
minDurability: 10
# 如果设置为 true,玩家需要使用斧头(在 blocks.yml 文件中定义)才能使用 TimberZ
# 当此项设置为 false 时,你将无法再通过按 F 键切换 Timber 模式
requireAxeMaterial: true
# 如果设置为 true,当满足 TimberZ 条件时,你可以瞬间破坏树叶
instaBreakLeavesWithTimber: false
# 当玩家尝试在不允许使用该功能的 WorldGuard 区域中使用 timber 模式时,向玩家发送消息
messageOnRegionViolation: false
# 如果使用 AuraSkills,你可以为 Foraging(采集)技能设置自定义经验倍数
# 示例:如果将其设置为 2.0,玩家使用 TimberZ 时将获得双倍经验
# 示例2:如果将其设置为 0.5,玩家使用 TimberZ 时将获得一半经验
auraSkillsXPMultiplier: 1.0
# === 树木检测 ===
# 除非你知道自己在做什么,否则请勿更改这些设置!
# 这些设置用于检测树木及其树叶,并且已经过精细调整。
```yml
leavesSearchRadius: 4
maxTreeSize: 500
maxSearchRadius: 1
diagonalSearchRange: 2
minLeavesRequired: 5
minLogsRequired: 3
blocks.yml
logToLeafMap:
- "OAK_LOG:OAK_LEAVES"
- "BIRCH_LOG:BIRCH_LEAVES"
- "SPRUCE_LOG:SPRUCE_LEAVES"
- "JUNGLE_LOG:JUNGLE_LEAVES"
- "ACACIA_LOG:ACACIA_LEAVES"
- "DARK_OAK_LOG:DARK_OAK_LEAVES"
- "MANGROVE_LOG:MANGROVE_LEAVES"
- "CHERRY_LOG:CHERRY_LEAVES"
- "STRIPPED_OAK_LOG:OAK_LEAVES"
- "STRIPPED_BIRCH_LOG:BIRCH_LEAVES"
- "STRIPPED_SPRUCE_LOG:SPRUCE_LEAVES"
- "STRIPPED_JUNGLE_LOG:JUNGLE_LEAVES"
- "STRIPPED_ACACIA_LOG:ACACIA_LEAVES"
- "STRIPPED_DARK_OAK_LOG:DARK_OAK_LEAVES"
- "STRIPPED_MANGROVE_LOG:MANGROVE_LEAVES"
- "STRIPPED_CHERRY_LOG:CHERRY_LEAVES"
- "PALE_OAK_LOG:PALE_OAK_LEAVES"
logToSaplingMap:
- "OAK_LOG:OAK_SAPLING"
- "BIRCH_LOG:BIRCH_SAPLING"
- "SPRUCE_LOG:SPRUCE_SAPLING"
- "JUNGLE_LOG:JUNGLE_SAPLING"
- "ACACIA_LOG:ACACIA_SAPLING"
- "DARK_OAK_LOG:DARK_OAK_SAPLING"
- "MANGROVE_LOG:MANGROVE_PROPAGULE"
- "CHERRY_LOG:CHERRY_SAPLING"
- "STRIPPED_OAK_LOG:OAK_SAPLING"
- "STRIPPED_BIRCH_LOG:BIRCH_SAPLING"
- "STRIPPED_SPRUCE_LOG:SPRUCE_SAPLING"
- "STRIPPED_JUNGLE_LOG:JUNGLE_SAPLING"
- "STRIPPED_ACACIA_LOG:ACACIA_SAPLING"
- "STRIPPED_DARK_OAK_LOG:DARK_OAK_SAPLING"
- "STRIPPED_MANGROVE_LOG:MANGROVE_PROPAGULE"
- "STRIPPED_CHERRY_LOG:CHERRY_SAPLING"
- "PALE_OAK_LOG:PALE_OAK_SAPLING"
axes:
- "WOODEN_AXE"
- "STONE_AXE"
- "GOLDEN_AXE"
- "IRON_AXE"
- "DIAMOND_AXE"
- "NETHERITE_AXE"
支持
如果您在插件设置方面需要帮助,或发现了 Bug,您可以加入我们的 Discord 在此处。

TimberZ is a Minecraft plugin that let's you cut down trees in an instant. You can either have it always active, toggleable, make special lumberjack axes or have a custom enchantment.
Features
- ✅ Advanced Tree Detection
- ✅ Custom Enchantment
- ✅ Customizable Tree Types
- ✅ Cutting down animation
- ✅ Toggleable Timber mode
- ✅ Custom item support
- ✅ HEX Colors
- ✅ Highly customizable
- ✅ Easy setup
- ✅ Multiple languages

Permissions
timberz.usetimber - Allows the player to use TimberZ. (true by default)
timberz.admin - Allows the player to use admin commands. (Only for OPs by default)
Compatability
✅ PlaceholderAPI
TimberZ supports PlaceholderAPI, allowing you to use placeholders in your messages and configurations:
%timberz_can_timber% - Returns true if the player can use TimberZ. This takes permissions, regions and other restrictions into account.
✅ WorldGuard
TimberZ supports WorldGuard, allowing you to restrict TimberZ usage in certain regions. You can use the timber flag to allow or disallow TimberZ usage in a region.
✅ AuraSkills
Using TimberZ with AuraSkills, gives players the correct amount of experience when cutting down trees. You can also add a custom XP multiplier to the TimberZ configuration file.
Configuration
You can find the configuration files in the plugins/TimberZ folder. The main configuration file is config.yml, and you can also find a blocks.yml file that contains the block mappings for logs, leaves, and saplings.
config.yml
# _______ _ _ ______
# |__ __(_) | | |___ /
# | | _ _ __ ___ | |__ ___ _ __ / /
# | | | | '_ ` _ \| '_ \ / _ \ '__| / /
# | | | | | | | | | |_) | __/ | / /__
# |_| |_|_| |_| |_|_.__/ \___|_| /_____|
# === COLOR CODES ===
# This plugin supports old color codes like: &c, &l, &o, etc.
# It also supports MiniMessage, a more advanced way to format messages:
# https://docs.advntr.dev/minimessage/format.html
# With MiniMessage, you can add HEX colors, gradients, hover and click events, etc.
# === GENERAL SETTINGS ===
# If set to true, TimberZ will check for updates and let you know if there's a newer version
checkForUpdates: true
# Set the language to any code found in the "lang" folder (don't add the .yml extension)
# You can add your own language files. Use https://github.com/ZetaPlugins/TimberZ/tree/main/src/main/resources/lang/en-US.yml as a template
# If you want to help translating the plugin, please refer to this article: https://docs.zetaplugins.com/#contributing
# | en-US | de-DE | pl-PL | ru-RU |
lang: "en-US"
# The accent color of the plugin. This color replaces %ac% in the lang files.
accentColor: "<#00D26A>"
# === TIMBER SETTINGS ===
# Regardless of the settings below, you can disallow TimberZ for a specific player by disallowing them the "timberz.usetimber" permission.
# If set to true, players can enable or disable timber mode by pressing F with a qualifying axe in hand
toggleTimber: true
# If set to true, you can only use axes that have the "Timber" enchantment which can be applied like a normal Enchantment.
requireCustomEnchant: true
# If set to true, you can only use axes with a customModelData value in the list below
restrictAxeModelData: false
# If restrictAxeModelData is set to true, you can only use axes with a customModelData value in this list
allowedModelData:
- 100
# If set to true, Leaves will decay instantly when cutting down a tree
instantLeafDecay: true
# If set to true, TimberZ will replant the tree after cutting it down
replant: true
# Modify how much durability is removed from the axe when cutting down a tree
# Formula: logCount * durabilityMultiplier
durabilityMultiplier: 1.0
# The minimum durability the axe must have after cutting down a tree
minDurability: 10
# If set to true, Players will need to use an axe (defined in the blocks.yml file) to use TimberZ
# When this is set to false, you can no longer toggle TimberZ by pressing F
requireAxeMaterial: true
# If set to true, you can insta mine leaves when the TimberZ conditions are met
instaBreakLeavesWithTimber: false
# Send a message to the player when they try to use timber mode in a WorldGuard region that does not allow it
messageOnRegionViolation: false
# If using AuraSkills, you can have a custom XP multiplier for the Foraging skill
# Example: If you set this to 2.0, players will receive double the XP for using TimberZ
# Example2: If you set this to 0.5, players will receive half the XP for using TimberZ
auraSkillsXPMultiplier: 1.0
# === TREE DETECTION ===
# Only change these settings if you know what you are doing!
# These are used to detect trees and their leaves and are already fine tuned.
leavesSearchRadius: 4
maxTreeSize: 500
maxSearchRadius: 1
diagonalSearchRange: 2
minLeavesRequired: 5
minLogsRequired: 3
blocks.yml
logToLeafMap:
- "OAK_LOG:OAK_LEAVES"
- "BIRCH_LOG:BIRCH_LEAVES"
- "SPRUCE_LOG:SPRUCE_LEAVES"
- "JUNGLE_LOG:JUNGLE_LEAVES"
- "ACACIA_LOG:ACACIA_LEAVES"
- "DARK_OAK_LOG:DARK_OAK_LEAVES"
- "MANGROVE_LOG:MANGROVE_LEAVES"
- "CHERRY_LOG:CHERRY_LEAVES"
- "STRIPPED_OAK_LOG:OAK_LEAVES"
- "STRIPPED_BIRCH_LOG:BIRCH_LEAVES"
- "STRIPPED_SPRUCE_LOG:SPRUCE_LEAVES"
- "STRIPPED_JUNGLE_LOG:JUNGLE_LEAVES"
- "STRIPPED_ACACIA_LOG:ACACIA_LEAVES"
- "STRIPPED_DARK_OAK_LOG:DARK_OAK_LEAVES"
- "STRIPPED_MANGROVE_LOG:MANGROVE_LEAVES"
- "STRIPPED_CHERRY_LOG:CHERRY_LEAVES"
- "PALE_OAK_LOG:PALE_OAK_LEAVES"
logToSaplingMap:
- "OAK_LOG:OAK_SAPLING"
- "BIRCH_LOG:BIRCH_SAPLING"
- "SPRUCE_LOG:SPRUCE_SAPLING"
- "JUNGLE_LOG:JUNGLE_SAPLING"
- "ACACIA_LOG:ACACIA_SAPLING"
- "DARK_OAK_LOG:DARK_OAK_SAPLING"
- "MANGROVE_LOG:MANGROVE_PROPAGULE"
- "CHERRY_LOG:CHERRY_SAPLING"
- "STRIPPED_OAK_LOG:OAK_SAPLING"
- "STRIPPED_BIRCH_LOG:BIRCH_SAPLING"
- "STRIPPED_SPRUCE_LOG:SPRUCE_SAPLING"
- "STRIPPED_JUNGLE_LOG:JUNGLE_SAPLING"
- "STRIPPED_ACACIA_LOG:ACACIA_SAPLING"
- "STRIPPED_DARK_OAK_LOG:DARK_OAK_SAPLING"
- "STRIPPED_MANGROVE_LOG:MANGROVE_PROPAGULE"
- "STRIPPED_CHERRY_LOG:CHERRY_SAPLING"
- "PALE_OAK_LOG:PALE_OAK_SAPLING"
axes:
- "WOODEN_AXE"
- "STONE_AXE"
- "GOLDEN_AXE"
- "IRON_AXE"
- "DIAMOND_AXE"
- "NETHERITE_AXE"
Support
If you need help with the setup of the plugin, or found a bug, you can join our discord here.
评论 0
登录后参与评分
还没有评论,来抢沙发吧