---

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.yml and messages.yml.
• Compatible with Paper, Purpur, and Spigot 1.21.9+.

---

Installation

1. Download TreeCutter.jar.
2. Place it in the server's plugins folder.
3. Start the server to generate default config files:
   config.yml
messages.yml
4. Configure options as needed.
5. 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 trees
• treecutter.command.tc → Access to /tc commands
• treecutter.admin → Access to /tcadmin commands
• treecutter.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: []