🌳 Overview

Apples In Trees brings organically integrated fruit mechanics into Minecraft: trees spawn across the world, a friendly trader offers unique deals, fruits grow through multiple visual stages, and players can harvest apples or collect entire fruit blocks for decoration. The addon combines feature rules, .mcstructure templates, and robust JS handlers to deliver a vanilla-friendly experience.

✨ Core Features

• Natural tree generation: New apple_tree and apple_tree_grown structures spawn naturally via feature_rules and weighted_random_feature.
• New Custom Mob: The Apple Wandering Trader, a friendly mob that spawns in plains biomes and offers unique, apple-themed trades.
• Golden Apple Trees: Rare trees that yield golden apples — targeted to mountain biomes using both mountain and mountains tags.
• Placeable fruit blocks: Apple and golden-apple blocks (with block_placer) for decoration, storage and farming.
• Craftable saplings: Recipes allow crafting apple_sapling and golden_apple_sapling (apple/golden_apple + oak sapling) so you can grow orchards.
• Scripted growth system: JavaScript handlers manage random ticks, structure loading, fruit growth stages and drop cooldowns (e.g. appleintree:placer_de_estrutura, appleintree:growth_handler).
• Three visual growth stages: Fruits visually progress from sprout → mid → ripe before they can be harvested.
• Interactive harvesting: Right-click/tap to harvest ripe fruit; use shears to obtain the fruit block itself.

🧍 The Apple Wandering Trader To complement the new apple economy, this addon introduces the Apple Wandering Trader. This custom mob brings the world to life, providing a way for players to buy and sell apple-related resources.

Behavior & Spawning: Spawns naturally and randomly in plains biomes. He wanders the world like a standard trader but is designed as a simple and stable entity focused purely on trading, without complex villager AI like breeding or sleeping.

Trading: Offers a custom trade table where players can sell apples, saplings, and wood for emeralds, or spend their emeralds on valuable items like Golden Apples.

📦 Items, Blocks & Recipes

🌍 Spawning & Biomes

• Common apple trees: Spawn in forest, flower_forest, bee_habitat and plains via apple_tree_generation_rule with scatter_chance and jittered_grid.
• Golden apple trees: Spawn in mountain biomes — both legacy and modern tags (mountain and mountains).
• Apple Wandering Trader: Spawns rarely in plains biomes, controlled by custom spawn_rules to ensure it's a special encounter.
• Placement resilience: block_allowlist includes grass, dirt, moss, stone, gravel, and snow so trees can spawn on slopes and peaks (adjustment_radius helps find nearby flat spots).

⚙️ Growth & Harvesting Mechanics

• Random-tick growth: JS handlers increment fruit growth state on random ticks until the maximum stage.
• Harvest: Right-click/tap on ripe fruit to receive the item (minecraft:apple or minecraft:golden_apple). The fruit resets to stage 0.
• Shears interaction: Using shears on a fruit block yields the corresponding block item instead of the fruit — ideal for decoration.
• Cooldowns & stability: Harvesting includes cooldown protections to avoid duplicate drops or abuse.

🔧 Technical Implementation

• Custom Entity: The appleintree:apple_wandering mob uses a dedicated behavior file to manage its AI and a client entity file for its appearance and animations.
• Structures: structures/apple_tree.mcstructure and structures/apple_tree_grown.mcstructure are used by structure_template_feature entries.
• Feature rules: feature_rules/*.json control where and how often trees appear, using heightmap queries for accurate surface placement.
• Weighted features: weighted_random_feature mixes normal and grown variants for variety.
• Script API: Uses @minecraft/server for block handlers, item spawning, command execution (with safe checks) and permutation/state management.
• Asset pipeline: Custom geometries for each growth stage and icons for items 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 the manifest.json dependency entries include the resource pack if you use custom blocks.
• Recommended Minecraft Bedrock version: 1.21.90+.

🐞 Troubleshooting

• Trees or Trader not appearing? Generate new chunks after enabling the pack, confirm both BP and RP are active, and ensure you’re on a supported Bedrock version.
• Mountain trees missing? Verify stone/gravel/snow are present in the block_allowlist. Temporarily increase scatter_chance for testing.
• Structure placement issues? Test .mcstructure manually with /structure load and /structure place to verify geometry and origin alignment.
• Customization: Edit feature_rules (for trees) and spawn_rules (for the trader) to adjust rarity and biome placement to suit your server or world.

📦 Compatibility

Designed and tested for Minecraft Bedrock 1.21.90+. Some feature rules and script APIs may not work on older versions.

---