🌿 Restored Jungle Edge

Restore the beloved Modified Jungle Edge biome with professional-grade TerraBlender integration!

The Modified Jungle Edge was a rare and beautiful biome variant that provided a unique transition between jungle and other biomes. This mod brings it back with industry-standard TerraBlender integration, multi-layer safety systems, and locatable biome support using the /locate biome command!

---

📖 Overview

The Restored Jungle Edge mod recreates the iconic Modified Jungle Edge biome that was removed from Minecraft in recent versions. This biome featured:

• 🌳 Sparse jungle trees - Fewer trees than regular jungle biomes
• 🌿 Reduced vegetation - More open areas with scattered grass and ferns
• 🐾 Unique wildlife - Ocelots and parrots in a more open environment
• 🏞️ Transition zones - Perfect buffer between jungle and other biomes
• ✨ Rare generation - Maintains the original rarity and special feel

---

✨ Features

🔧 Streamlined Configuration System (v1.1.0)

• JSON-Based Configuration: Human-readable config/restored-jungle-edge.json file
• Singleton Pattern: Modern, efficient configuration architecture following Torcherino pattern
• Automatic Validation: Invalid values are corrected automatically at startup
• Error Recovery: Graceful handling of corrupted configuration files
• Reset to Defaults: Easy restoration of default settings
• Comprehensive Logging: Detailed debug information for troubleshooting

🌍 Professional TerraBlender Integration (v1.1.0)

• BiomesOPlenty-Inspired Architecture: Following industry-standard patterns from major biome mods
• Professional Biome Placement: Advanced climate-based generation with sophisticated parameters
• Multiple Locatable Biomes: Three distinct biome variants with unique characteristics
• Smart Weight System: Intelligent rarity distribution across biome variants

🎯 Three Professional Biome Variants

• Modified Jungle Edge: Primary sparse jungle transition biome
• Modified Jungle Edge Hills: Elevated terrain variant with hillier generation
• Modified Jungle Edge Plateau: Rare flat elevated areas with unique features
• Intelligent Rarity: Hills (50% rarity), Plateau (33% rarity) of primary biome

🛡️ Multi-Layer Safety System

• Primary: Advanced TerraBlender integration with professional biome builder
• Fallback: Enhanced datagen JSON-based registration for compatibility
• Backup: BiomeModifications API for guaranteed functionality
• No Single Point of Failure: Always works regardless of which layer succeeds

🏗️ Professional Architecture (BiomesOPlenty-Inspired)

• Centralized Biome Registry: Professional biome management following industry standards
• Advanced Biome Builder: Sophisticated climate parameter mapping for optimal placement
• Modular Design: Clean separation of concerns with extensible architecture
• Multiple Biome Variants: Three distinct biomes with intelligent rarity distribution

🎯 Core Features

• Authentic Recreation: Faithful restoration of the original Modified Jungle Edge biome
• Configurable Generation: Adjust rarity, tree density, and vegetation to your liking
• Modern Compatibility: Built for Minecraft 1.21.4 with Fabric
• Performance Optimized: Lightweight implementation with minimal impact
• Modpack Friendly: Easy integration with other biome and world generation mods

🔧 Customization Options

• Biome Rarity: Control how often the biome generates (0-100)
• Tree Density: Adjust minimum and maximum trees per chunk (0-10)
• Vegetation: Configure grass, fern, and ground cover density (0-20)
• Wildlife: Enable/disable and adjust spawn rates for ocelots and parrots
• World Integration: Choose whether to add to existing worlds

⚙️ Advanced Configuration System

The mod features a comprehensive JSON-based configuration system located at config/restored-jungle-edge.json:

🌍 Biome Generation

"biome_generation": {
  "biome_rarity": 5,                    // How rare the biome is (0-100)
  "temperature_variance": 10,           // Temperature variation (0-200)
  "humidity_variance": 15,              // Humidity variation (0-200)
  "enable_in_existing_worlds": false,   // Enable in pre-existing worlds
  "replace_jungle_edge": false          // Replace vanilla jungle edge
}

🌳 Biome Features

"biome_features": {
  "max_trees_per_chunk": 2,            // Maximum trees per chunk (0-10)
  "min_trees_per_chunk": 0,            // Minimum trees per chunk (0-10)
  "mega_jungle_tree_chance": 10,       // Chance for mega trees (0-100%)
  "vine_growth_chance": 30,            // Vine growth probability (0-100%)
  "vegetation_density": 4,             // Overall vegetation density (0-20)
  "enable_cocoa_beans": true,          // Enable cocoa bean generation
  "enable_melon_patches": true         // Enable melon patch generation
}

🐾 Mob Spawning

"mob_spawning": {
  "enable_ocelots": true,              // Enable ocelot spawning
  "enable_parrots": true,              // Enable parrot spawning
  "ocelot_spawn_weight": 2,            // Ocelot spawn weight (0-100)
  "parrot_spawn_weight": 40,           // Parrot spawn weight (0-100)
  "hostile_mob_spawn_rate": 100,       // Hostile mob rate (50-150%)
  "passive_mob_spawn_rate": 100        // Passive mob rate (50-150%)
}

🔧 Configuration Features

• Auto-Creation: Config file created with defaults on first run
• Startup Loading: Configuration loaded once at startup for optimal performance
• Validation: Invalid values automatically corrected to safe ranges
• Error Recovery: Corrupted configs restored to defaults
• Manual Editing: Edit JSON file directly with any text editor
• Reset Option: Delete config file to restore all defaults

Note: Configuration changes require a restart to take effect. This ensures optimal performance and stability.

🎮 User Experience

• Smart Defaults: Works perfectly out of the box with sensible settings
• Extensive Documentation: Complete configuration guides and examples
• Multiple Presets: Ready-to-use configurations for different play styles
• Modern Architecture: Efficient singleton pattern following industry best practices

---

🚀 Installation

Requirements

• Minecraft: 1.21.4
• Fabric Loader: 0.16.9 or higher
• Fabric API: 0.119.2+1.21.4 or higher
• TerraBlender: 4.3.0.2 or higher (required for biome integration)
• ModMenu: 13.0.3+ (for mod list display)

Installation Steps

1. Install Fabric Loader

   • Download from FabricMC
   • Run the installer and select Minecraft 1.21.4

2. Download Required Mods

   • Fabric API (v0.119.2+1.21.4 or higher)
   • TerraBlender for Fabric (v4.3.0.2 or higher - required)
   • ModMenu (v13.0.3+ - for mod list display)

3. Install Restored Jungle Edge

   • Download the latest release from Releases
   • Place all .jar files in your .minecraft/mods folder

4. Launch Minecraft

   • Select the Fabric profile
   • Create a new world or explore new chunks in existing worlds
   • Configuration file will be automatically created on first run

---

⚙️ Configuration

Quick Start

The mod works perfectly with default settings, but you can customize it to your preferences:

Config File Location: .minecraft/config/restored-jungle-edge.json

Configuration Management

1. Edit the JSON file directly with any text editor
2. Restart Minecraft for changes to take effect
3. Delete the config file to reset to defaults
4. Check logs for validation messages and errors

Important: Unlike previous versions, configuration changes now require a restart for optimal performance and stability.

Key Settings

Setting	Description	Default	Range
biomeRarity	How often the biome spawns	5	0-100
maxTreesPerChunk	Maximum trees per chunk	2	0-10
minTreesPerChunk	Minimum trees per chunk	0	0-10
vegetationDensity	Ground vegetation amount	4	0-20
enableOcelots	Enable ocelot spawning	true	true/false
enableParrots	Enable parrot spawning	true	true/false

Example Configurations

More Common Generation

{
  "biomeRarity": 15,
  "maxTreesPerChunk": 3,
  "vegetationDensity": 6
}

Ultra Rare (Original Feel)

{
  "biomeRarity": 2,
  "maxTreesPerChunk": 1,
  "vegetationDensity": 2
}

Dense Jungle Edge

{
  "biomeRarity": 8,
  "maxTreesPerChunk": 4,
  "minTreesPerChunk": 1,
  "vegetationDensity": 8
}

---

Debug Information

Enable debug logging by adding -Dfabric.log.level=DEBUG to your JVM arguments. The mod will log:

• Configuration loading status
• Validation results
• Biome registration details
• TerraBlender integration status

---

🗺️ Finding the Biome

🎯 Primary Methods (v1.1.0+) - Locate Commands

All Three Biome Variants:

# Primary biome - Standard rarity
/locate biome restoredjungleedge:modified_jungle_edge

# Hills variant - Elevated terrain (50% rarity)
/locate biome restoredjungleedge:modified_jungle_edge_hills

# Plateau variant - Flat elevated areas (33% rarity)
/locate biome restoredjungleedge:modified_jungle_edge_plateau

Use the standard Minecraft locate commands to find any of the three biome variants! This works thanks to our professional TerraBlender integration following BiomesOPlenty patterns.

🔍 Alternative Methods

Natural Generation:

• Spawns near jungle biomes as transition zones
• Look for areas with sparse jungle trees
• Check the F3 debug screen for biome name
• Most commonly found at jungle borders

Biome Characteristics:

• Temperature: 0.95 (warm)
• Humidity: 0.8 (humid)
• Grass Color: Vibrant jungle green
• Sky Color: Tropical blue
• Tree Density: Noticeably sparser than regular jungle

---

🔧 For Modpack Creators

Integration Tips

• Biome Weight: Adjust biomeRarity based on other biome mods
• Compatibility: Works with most world generation mods
• Performance: Minimal impact on world generation speed
• Customization: Extensive configuration options for pack balance

Recommended Settings for Modpacks

Large Modpacks (Many Biomes)

{
  "biomeRarity": 3,
  "maxTreesPerChunk": 2,
  "vegetationDensity": 4
}

Vanilla+ Packs

{
  "biomeRarity": 5,
  "maxTreesPerChunk": 2,
  "vegetationDensity": 4
}

Adventure/Exploration Packs

{
  "biomeRarity": 8,
  "maxTreesPerChunk": 3,
  "vegetationDensity": 6
}

---

Performance Tips

• Lower biomeRarity if experiencing world generation lag
• Reduce vegetationDensity for better performance
• The mod is optimized and should have minimal impact

---

🤝 Contributing

We welcome contributions to improve the Restored Jungle Edge mod!

How to Contribute

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Development Setup

git clone https://github.com/bvhfve/restored-jungle-edge.git
cd restored-jungle-edge
./gradlew build

Areas for Contribution

• 🌍 Translations: Help translate the mod to other languages
• 🎨 Textures: Improve biome-specific textures or features
• 🔧 Features: Add new customization options
• 📚 Documentation: Improve guides and examples
• 🐛 Bug Fixes: Report and fix issues

---

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

🙏 Acknowledgments & Special Thanks

Special Thanks

Biomes O' Plenty

Special thanks to the Biomes O' Plenty team for their excellent mod architecture and professional patterns. This mod's architecture was heavily inspired by BiomesOPlenty's industry-standard approach to biome registration, TerraBlender integration, and modular design. Their codebase served as an invaluable reference for implementing professional-quality biome mods.

Misode's Biome Generator

Huge appreciation to Misode for their incredible biome generator tool. This web-based tool was instrumental in resolving JSON formatting errors and ensuring our biome definitions follow the correct Minecraft data format. The generator's validation and examples helped create properly structured biome JSON files that work seamlessly with Minecraft's world generation system.

TerraBlender

Thanks to the TerraBlender team for creating the industry-standard biome integration API that makes professional biome placement possible.

General Acknowledgments

• Mojang Studios - For creating Minecraft and the original Modified Jungle Edge biome
• FabricMC Team - For the excellent modding framework
• Minecraft Community - For keeping the memory of removed features alive
• Contributors - Everyone who helps improve this mod

---