Ryzen Tree Capitator

# RyzenTreeCapitator

Break one log with the correct tool and the **whole connected tree** comes down with it. RyzenTreeCapitator is a TreeCapitator-style gameplay mechanic built entirely on **official Minecraft Bedrock Script APIs** (`@minecraft/server`, `@minecraft/server-ui`). No new blocks, items, or textures are added — this is a pure mechanic addon designed to feel like it shipped with the game.

## ✨ Features

- **Instant tree felling** — break one log, the connected trunk falls with it, up to a configurable cap

- **Leaves decay naturally** — the addon never touches leaf blocks directly, vanilla mechanics handle the rest

- **Smart false-positive protection** — player-built log structures are left alone using a leaf-adjacency and ground-contact validation pass

- **Full settings menu** — toggle everything in-game, no config files to edit

- **Durability-respecting** — every extra log costs durability just like normal mining, Unbreaking included

- **Multiplayer-safe** — each player's tree felling is independent and won't interfere with others

- **Built for performance** — an iterative (non-recursive) search with a visited-set, plus tick-spread breaking via `system.runJob`, keeps even a 256-log tree smooth on low-end and Android devices

## 🌳 Supported Trees

Oak · Birch · Spruce · Jungle (including 2×2 trunks) · Acacia · Dark Oak · Mangrove · Cherry · Pale Oak* · Crimson Stem · Warped Stem — plus all their stripped variants. Bamboo Block is supported as an optional toggle.

*Pale Oak requires a Minecraft version that includes it. On older versions this entry is simply inactive and causes no errors.

## ⚙️ Settings

Open the settings menu two ways:

- **Sneak + use a Compass** (works in every world, no cheats required)

- **`/scriptevent rtc:settings`** (requires Allow Cheats)

| Setting | Default | Description |

|---|---|---|

| Enable TreeCapitator | On | Master on/off switch |

| Maximum Logs Per Tree | 128 | 32 / 64 / 128 / 256 |

| Require Sneaking | Off | Only trigger while sneaking |

| Require Axe | On | Only trigger when holding an axe |

| Enable Animations | On | Spreads the fell across ticks for a cascading feel |

| Enable Particles | On | Vanilla block-break particles per log |

| Enable Sounds | On | Vanilla wood dig sound per log |

| Enable Bamboo Support | Off | Treat Bamboo Blocks as a fellable "tree" |

Settings are shared world-wide — set once, applies for every player, exactly like an official world setting.

## 📦 Installation

1. Download and open **RyzenTreeCapitator.mcaddon** — Minecraft imports both packs automatically.

   *(Alternative: import the two `.mcpack` files separately, Behavior Pack first.)*

2. In your world settings, go to **Behavior Packs** and activate **RyzenTreeCapitator**. The Resource Pack activates automatically as a dependency.

3. No experimental toggles are required for the core mechanic.

## 📝 Honest Notes on Limitations

- Natural-vs-player-built detection is a best-effort heuristic — Bedrock's Script API has no "world-generated" flag to check against, so an unusual edge case (e.g. a log tower planted directly in dirt) could still be felled.

- Fortune and Silk Touch don't change log drops, because they don't in vanilla Minecraft either.

- No XP is awarded for logs, matching vanilla.

- Break particles use the vanilla generic effect rather than per-species tinting, since exact color-matching needs an internal ID the Script API doesn't expose.

## 💬 Feedback

Found a tree type that doesn't connect right, or a settings bug? Let me know in the comments — this addon is actively maintained.