SwiftChop

A Paper Minecraft plugin that enhances tree chopping mechanics with instant tree felling, configurable axe durability, and intelligent sapling management.

Features

• Instant Tree Felling: Break one log to automatically chop down the entire tree
• Smart Log Detection: Only affects naturally grown trees, not player-placed logs
• Configurable Durability: Customize degradation rates for different axe types
• Low Durability Warnings: Receive alerts when your axe is about to break
• Automatic Sapling Replanting: Replants a sapling at the base after chopping
• Lightweight & Efficient: Optimized for minimal server impact

Requirements

• Paper 1.21+ (or compatible forks)
• Java 21+

Installation

1. Download the latest JAR from releases
2. Place in your server's plugins/ folder
3. Restart or reload your server
4. Configure settings in plugins/SwiftChop/config.yml

Configuration

The plugin generates a config.yml file on first run in the plugins/SwiftChop/ directory:

# Durability degradation multiplier for each axe type
# Higher values = faster durability loss
degradeRates:
  WOODEN_AXE: 3
  STONE_AXE: 2
  IRON_AXE: 1
  GOLDEN_AXE: 4
  DIAMOND_AXE: 1
  NETHERITE_AXE: 1

# Speed multiplier for tree chopping (default: 1)
chopSpeed: 1

# Durability threshold to warn players before tool breaks
durabilityWarningThreshold: 10

Configuration Details

• degradeRates: Controls how much extra durability is consumed when chopping trees. Set to 0 to disable durability loss for a specific axe type.
• chopSpeed: Adjusts the delay between breaking logs. Lower values = faster chopping.
• durabilityWarningThreshold: Players receive a warning when their axe has this many uses remaining.

How It Works

1. Player breaks a log with an axe
2. Plugin checks if the log is part of a naturally grown tree (not player-placed)
3. All connected logs are instantly broken
4. Items drop at each log location
5. A sapling is replanted at the base
6. Axe durability is reduced based on the configured rate

Building from Source

./gradlew build

The compiled JAR will be in build/libs/

Permissions

This plugin does not currently use any permissions. All players can use the tree chopping feature.

Authors

• ExcaliburAU
• Litruv

License

This project is licensed under the MIT License.