Lumberjack Evolved

# Lumberjack Evolved 1.0.0

The first full public release of Lumberjack Evolved for Minecraft 1.20.1 Forge.

## Whole-Tree Felling

- Break the bottom log of a natural tree with an axe to fell the entire tree.
- Includes a synchronized falling-tree animation.
- Supports vanilla Oak, Birch, Spruce, Jungle, Acacia, Dark Oak, Mangrove, and Cherry trees.
- Detects natural trees while helping protect wooden buildings and player-made log structures.
- Sneak while chopping to bypass Lumberjack Evolved and break blocks normally.
- Breaking upper logs, using non-axes, and chopping unsupported structures will not trigger whole-tree felling.

## Drops and Axe Behavior

- Fortune and Silk Touch are supported through Minecraft’s normal loot tables.
- Successful Survival felling uses only one axe durability point per tree.
- Creative mode does not create Survival drops or consume axe durability.
- Duplicate root-log drops are prevented.
- Tree loot can be configured to:
  - Gather at the stump.
  - Appear at the original removed-block positions.
- Delayed drops are protected during world saves, shutdowns, unloaded chunks, and interrupted falling animations.

## Lumberjack Progression

Earn Lumberjack XP and advance through seven ranks:

- Novice
- Apprentice
- Trained
- Skilled
- Expert
- Master
- Legendary

Higher ranks provide increased chopping speed on supported logs and trunks:

- Apprentice: +5%
- Trained: +10%
- Skilled: +15%
- Expert: +20%
- Master: +30%
- Legendary: +40%

Sneaking bypasses the rank chopping-speed bonus.

## Master-Rank Auto Replant

Master and Legendary players unlock Auto Replant.

- Uses matching saplings or propagules from the felled tree’s actual drops.
- Does not create free saplings.
- Does not take saplings from the player’s inventory or nearby containers.
- Normal trees use one matching sapling.
- Dark Oak, large Jungle, and large Spruce trees can restore their 2×2 planting pattern when four matching saplings are available.
- Supports valid Mangrove Propagule placement, including waterlogged placement.
- Safely skips planting when there are not enough saplings, the soil is invalid, the position is occupied, the chunk is unavailable, or the planting area is unsafe.
- Failed planting returns the reserved saplings to the normal loot whenever possible.
- Pending replants are preserved through save-and-quit and server restart.
- Offline players receive their replant statistics when they next log in.
- Auto Replant can be disabled in the server configuration.

## Progress and Statistics Menu

Press **O** to open Lumberjack Progress.

The key can be rebound under:

**Options → Controls → Lumberjack Evolved**

The menu includes:

- Current Lumberjack rank.
- Current XP and progress toward the next rank.
- Current and upcoming rank rewards.
- Trees felled.
- Logs harvested.
- Leaves cleared.
- Largest tree felled.
- Items gathered.
- Tree-species statistics.
- Trees replanted.
- Saplings and propagules planted.
- Scrollable layouts for smaller screens and larger GUI scales.

Commands:

- `/lumberjackevolved menu`
- `/lumberjackevolved progress`

## Multiplayer and Reliability

- Supports singleplayer and dedicated Forge servers.
- Uses one universal JAR.
- For multiplayer, install the same version on the server and every connecting client.
- Falling animations are synchronized between nearby players.
- Player progression and statistics remain separate.
- Includes safeguards for:
  - Save-and-quit during tree animations.
  - Server shutdown and restart.
  - Unloaded chunks and unavailable dimensions.
  - Partial item spawning.
  - Duplicate drops and duplicate replants.
  - Large trees and rapid consecutive fellings.
  - Packet, preview, queue, persistence, and memory workloads.
  - Invalid configuration and saved-data values.

## Configuration

Server configuration options include:

- Enable or disable Master Auto Replant.
- Gather drops at the stump or original positions.
- Enable or adjust structure protection.
- Tree and leaf scan limits.
- Lumberjack XP multiplier.
- Rank chopping-speed rewards.
- Allowed and blocked dimensions.
- Optional debug logging.

## Requirements

- Minecraft 1.20.1
- Forge 47.1.43 or newer within Forge 47
- Java 17
- No additional required mods

## Installation

### Singleplayer

Place `lumberjackevolved-1.0.0.jar` in your Minecraft instance’s `mods` folder.

### Multiplayer

Install the same `lumberjackevolved-1.0.0.jar` on:

- The dedicated Forge server.
- Every connecting player’s client.

There are no separate client and server downloads.

## Testing

- 105 automated JUnit tests passed.
- Whole-tree felling, progression, statistics, configurable drops, save-and-quit recovery, and Auto Replant were manually tested before release.