Compatibility
Minecraft: Java Edition
1.21.x
Platforms
Links
Creators
Details
Licensed MIT
Published 4 months ago
Updated 4 days ago
TreeCutter
TreeCutter is a lightweight and configurable Minecraft plugin that allows players to cut down entire natural trees instantly by sneaking and breaking the bottom log. Tool durability is respected, commands are LuckPerms-friendly, and admins have full control.
Features
- Instant tree cutting when sneaking and breaking the bottom log.
- Tool durability handling — tools take damage proportional to the number of logs cut.
- Natural log only mode (player-placed logs are ignored by default).
- Gradient red warnings and error messages.
- LuckPerms support for permission control.
- Admin commands are only visible to users with permission.
- Configurable through
config.ymlandmessages.yml. - Compatible with Paper, Purpur, and Spigot 1.21.9+.
Installation
- Download
TreeCutter.jar. - Place it in the server's
pluginsfolder. - Start the server to generate default config files:
config.ymlmessages.yml - Configure options as needed.
- Restart the server to apply changes.
Commands
Player Commands
| Command | Permission | Description |
|---|---|---|
/tc on |
treecutter.command.tc |
Enable TreeCutter for the player |
/tc off |
treecutter.command.tc |
Disable TreeCutter for the player |
/tc help |
treecutter.command.tc |
Show available player commands |
Admin Commands
| Command | Permission | Description |
|---|---|---|
/tcadmin reload |
treecutter.admin.reload |
Reload the plugin configuration files |
/tcadmin help |
treecutter.admin |
Show available admin commands |
/tcadmin blacklist add <player> |
treecutter.admin |
Add a player to the blacklist |
/tcadmin blacklist remove <player> |
treecutter.admin |
Remove a player from the blacklist |
/tcadmin blacklist list |
treecutter.admin |
List all blacklisted players |
Admin commands are only visible to users with permission.
Permissions
treecutter.use→ Allows cutting treestreecutter.command.tc→ Access to/tccommandstreecutter.admin→ Access to/tcadmincommandstreecutter.admin.reload→ Reload configuration files
Permissions are fully enforced with LuckPerms. OP fallback only applies if LuckPerms is not installed.
Configuration Files
config.yml
⚙️ Configs
# ================================
# Tree Cutter Configuration
# ================================
# Plugin prefix that appears in all messages
# Current: [TC] in grey with cyan letters
prefix: "§7[§bT§3C§7]"
# ================================
# GENERAL SETTINGS
# ================================
# Enable or disable the entire plugin
# Set to false to turn off all tree cutting functionality
plugin-enabled: true
# Maximum number of logs that can be broken in one tree
# This prevents lag from extremely large trees
# Set to -1 for unlimited
max-tree-size: 100
# Cooldown between tree cuts (in seconds)
# Players must wait this long before cutting another tree
# Players with treecutter.bypass.cooldown permission ignore this
cooldown: 2
# Confirmation timeout for durability warnings (in seconds)
# How long a player has to confirm breaking a tree that will break their tool
confirmation-timeout: 10
# ================================
# TREE DETECTION SETTINGS
# ================================
# Which wood types can be cut with the tree cutter
# Set to false to disable that wood type
enabled-wood-types:
oak: true
spruce: true
birch: true
jungle: true
acacia: true
dark_oak: true
mangrove: true
cherry: true
crimson: true
warped: true
# ================================
# LEAF SETTINGS
# ================================
# How should leaves be handled when a tree is cut?
# Options:
# - 'instant': Leaves break immediately with the tree
# - 'decay': Leaves decay naturally (vanilla behavior)
# - 'none': Leaves are not affected
leaf-behavior: 'decay'
# ================================
# EFFECTS & FEEDBACK
# ================================
# Play sound effect when tree is cut
sound-effects:
enabled: false
# Sound to play (Minecraft sound name)
sound: 'ENTITY_ZOMBIE_BREAK_WOODEN_DOOR'
volume: 1.0
pitch: 1.0
# Particle effects when tree is cut
particle-effects:
enabled: true
# Particle type
particle: 'BLOCK'
# Amount of particles
amount: 50
# ================================
# WORLD SETTINGS
# ================================
# Worlds where tree cutter is enabled
# Leave empty to enable in all worlds
# Example: ['world', 'world_nether']
enabled-worlds: []
# Worlds where tree cutter is disabled
# This overrides enabled-worlds if both are set
disabled-worlds: []
# ================================
# BLACKLIST
# ================================
# Players who are blacklisted from using tree cutter
# Use /tcadmin blacklist commands to manage this list
blacklisted-players: []
# ================================
# PLAYER TOGGLES
# ================================
# Track which players have disabled tree cutter for themselves
# This is managed automatically by the plugin
disabled-players: []







