🌳 Overview

Fruits In Trees brings three new fruits into the Minecraft world: Guava, Mango and Orange. Each fruit appears as placeable fruit blocks with three visual growth stages, spawns from natural trees in appropriate biomes, and can be grown using craftable saplings. The addon combines .mcstructure features, feature_rules and JS block handlers to deliver a polished, survival-friendly experience.

✨ Core Features

• Natural tree generation: New tree structures spawn via feature rules and weighted features for variety (guava, mango, orange variants and grown variants).
• Three new fruits: guava, mango and orange, each with item definitions and placeable fruit blocks.
• Placeable fruit blocks: fruitsintrees:guava_block, fruitsintrees:mango_block, fruitsintrees:orange_block — each with 3 growth-stage permutations and custom geometries/textures.
• Craftable saplings: Shaped recipes let players craft saplings using fruit + oak sapling (e.g. fruitsintrees:guava_sapling_crafting).
• Scripted growth system: Custom block components (fruitsintrees:growth_handler, fruitsintrees:placer_de_estrutura) manage random-tick growth, structure loading and drops.
• Interactive harvesting: Tap/right-click ripe fruit to collect food items; use shears to collect fruit block items for decoration (*_block_item).
• Weighted & grown variants: Weighted features produce a healthy mix of regular trees and rarer grown variants for diversity.
• Food & balance: Fruit items (fruitsintrees:guava_item, fruitsintrees:mango_item, fruitsintrees:orange_item) are food items with nutrition and use animations.

📦 Items, Blocks & Recipes

🌍 Spawning & Biomes

• Guava trees: Spawn in jungle / mangrove_swamp / plains (see fruitsintrees:guava_tree_generation_rule).
• Mango trees: Spawn in jungle / mangrove_swamp / plains (see fruitsintrees:mango_tree_generation_rule).
• Orange trees: Spawn in forest / flower_forest / bee_habitat / plains (see fruitsintrees:orange_tree_generation_rule).
• Placement resilience: Feature rules use scatter_chance, jittered_grid and heightmap queries for natural-looking placement.

⚙️ Growth & Harvesting Mechanics

• Growth states: Each fruit block defines fruitsintrees:growth_stage with values 0,1,2. Permutations swap geometry/texture per stage.
• Random-tick growth: The custom component fruitsintrees:growth_handler increments the growth state on random ticks (scripted handler).
• Harvest behavior: Interact with a ripe fruit to spawn the food item (fruitsintrees:*_item) and reset the block to stage 0.
• Shears behavior: Breaking ripe fruit with shears yields the fruit block item (fruitsintrees:*_block_item) for decoration or transport.
• Sapling placement: Sapling blocks use fruitsintrees:placer_de_estrutura to load the corresponding tree structure (offsets applied) when random-ticked.

🔧 Technical Implementation

• Structures: Each tree has its .mcstructure templates referenced by placer handlers and structure features.
• Feature rules: Generation controlled by feature_rules/*.json for each fruit, using biome tags and distribution controls.
• Block definitions: minecraft:block JSONs declare states, permutations, placement filters and custom components (e.g. fruitsintrees:growth_handler).
• Script API: Scripts use @minecraft/server to register custom block components, manage permutations, spawn items and safely run structure commands.
• Assets: Custom geometries and textures for each fruit stage and sapling icons are included in the resource pack.

🛠️ Installation & Quick Setup

• Install and enable both the Behavior Pack and the matching Resource Pack in your world (ensure dependency entries in manifest.json if using custom blocks).
• Recommended Bedrock engine: 1.21.90+ for full compatibility with feature rules and script API. Older versions may still work for some assets but could lack features.

🐞 Troubleshooting

• Trees not spawning? Generate new chunks after enabling the packs, confirm both BP and RP are active, and verify the Minecraft version.
• Growth not progressing? Ensure the block JSON uses "minecraft:custom_components": ["fruitsintrees:growth_handler"] and the script registers that same handler name. If you used different namespaces, register all component names in the script.
• Saplings not creating trees? Check that sapling blocks include fruitsintrees:placer_de_estrutura as a custom component and that your script registers that placer handler name.
• Structure placement issues? Test structures manually with /structure load and /structure place to verify origin/offsets and collisions.
• Want to tune spawn rates? Edit scatter_chance, iterations and y extents in the feature_rules JSON files.

📦 Compatibility

Designed and tested for modern Bedrock builds (recommended 1.21.90+). Some older format_versions appear in the addon for backwards compatibility, but feature rules and custom components work best on recent engines.