Wishing tree

# Wishing Trees

Graft any item onto a sapling, plant it, and grow a tree that bears that very item as harvestable fruit hanging from its leaves.

## What is this?

Ever wanted a diamond tree? Now you can grow one. Combine a plain sapling with almost any item at a crafting table to get a **Grafted Sapling** — plant it, wait for it to grow, and some of its lowest leaves will bear that item as fruit you can pick again and again.

## Features

- **Graft anything** — craft a vanilla sapling with any ordinary item (no enchantments, no written books, no filled containers — see Limitations) to get a Grafted Sapling that remembers what it'll grow.
- **Check before you plant** — hover over a Grafted Sapling to see exactly what it's grafted with ("Grows: Diamond").
- **Grows naturally over time** — no bonemeal by default, so it feels like a real tree, not an instant crop. (Bonemeal support can be switched on in the config if you'd rather speed things up.)
- **Fruit on the lowest branches** — only the bottom ring of leaves bears fruit, so it's easy to spot and reach without needing to tear the whole canopy apart.
- **Ripens in stages, like cocoa** — fruit visibly grows from a small bud to full size across 3 stages, floating just under the leaf and always facing you. Right-click when it's ripe to harvest 1–2 of the item, then the branch resets and ripens again — the tree keeps producing, it's not a one-time drop.
- **Behaves like a real tree** — chop down all the logs and the leaves (fruiting or not) decay away naturally instead of floating forever.
- **In-game config screen** — toggle bonemeal support from the Mods list without touching a config file (though you can edit `config/graftedtrees-common.toml` directly too).

## Full vs Lite

Every version above ships as two separate downloads:

- **Full** — grafts anything: tools, weapons, armor, enchanted apples, totems, all of it. Maximum chaos, no balance rules.
- **Lite** — same mod, but with balance guardrails for survival/RPG-style worlds: end-game power items (enchanted golden apples, totems of undying, all weapons and armor, and anything Rare/Epic rarity) can't be grafted, and fruit ripens about 3x slower. The ban list is datapack-extensible (`data/graftedtrees/tags/item/banned_fruits.json`), so pack authors can add more items to it — including modded ones — without needing a new build of the mod.

Only install one edition at a time; both use the same mod ID.

## How to use

1. Get a plain vanilla sapling (oak, spruce, birch, jungle, acacia, dark oak, or cherry) and any plain item you want it to grow.
2. Put both in a crafting table (shapeless — position doesn't matter) to get a **Grafted Sapling**.
3. Plant it on dirt, grass, or farmland, same as a normal sapling.
4. Wait for it to grow into a full tree (or enable bonemeal in the config to speed it up).
5. Once ripe, right-click the glowing fruit on the lowest leaves to harvest. It'll grow back.

## Limitations (by design)

- Only **vanilla saplings** work as the base (mangrove propagules, azalea, and bamboo don't count — they're not classic saplings).
- The item you graft on **can't carry NBT data** — enchanted books, written books, maps, dyed armor, filled shulker boxes/bundles, named heads, and similar "special" items are rejected. Plain items (ores, food, tools, blocks, etc.) work fine.
- You can't graft a Grafted Sapling onto another Grafted Sapling.

## Configuration

Available in-game via the **Config** button on this mod's entry in the Mods list, or by editing `config/graftedtrees-common.toml`:

| Option | Default | Description |
|---|---|---|
| `allowBonemeal` | `false` | Whether bone meal can instantly grow a Grafted Sapling |