🌍 WorldShaper - The Ultimate World Generation Control

WorldShaper is a powerful, highly customizable world generation mod for Minecraft Forge 1.20.1. It gives you complete control over the terrain, allowing you to sculpt your perfect world before you even click "Create".

Tired of generating random seeds hoping for the perfect landscape? Frustrated by rivers that flow uphill, or villages spawning in the middle of a desert with no water source? WorldShaper fixes this by introducing a smart, user-friendly generation pipeline.

🎮 How It Works

Instead of relying on blind luck, WorldShaper adds a dedicated "World Generation" button directly to the Create World screen.

When you click it, you are greeted by an intuitive UI featuring sliders, toggles, and generation presets. You can adjust the terrain, water, and structure generation to your exact liking. Once you hit "Apply" and create the world, our custom Chunk Generator takes over, carefully applying your rules to every single chunk as it generates.

✨ Core Features

• 🌊 Advanced Hydrology & Rivers: Control the density of rivers. Our mod uses a custom priority-flood algorithm to carve riverbeds that strictly follow the terrain's heightmap. Water will always flow naturally from mountains down to the oceans, creating beautiful, cohesive watersheds.
• ⛰️ Terrain & Mountain Shaping: Want a flat world for megabuilds, or rugged, extreme peaks for hardcore survival? A single slider controls the "mountainness" of your world, altering the noise generation to create the perfect horizon.
• 🏘️ Smart Village Placement: Toggle "Villages Near Water". When enabled, vanilla villages will only generate if there is a river, lake, or ocean within a logical radius. This makes settlements feel realistic and improves trade routes.
• 🛤️ Dynamic Trails & Roads: Enable the "Trails" feature, and the mod will use pathfinding to connect nearby villages with natural dirt paths. These trails intelligently avoid steep cliffs and deep water, making exploration feel authentic.
• ⚙️ Ready-to-Use Presets: Don't want to tweak every slider? Choose from hand-crafted presets:
  • Realism: Balanced rivers, normal mountains, smart villages.
  • Archipelago: Lots of water, small islands, scattered villages.
  • Wasteland: Dry, harsh, with few rivers and ruins.
  • Glacial: Cold, snowy, with frozen rivers and high peaks.
• 🛡️ Safe Spawn Guarantee: Never spawn in lava or the middle of a deep ocean again. The mod ensures you spawn on a solid shore with wood, food, and water nearby.
• 💾 World-Bound Configuration: All your settings are saved directly to the world's file. Share the world with a friend, or open it a year later — the generation rules remain locked in place.

🔧 Technical Compatibility & Performance

• Forge 1.20.1 Compatible: Built from the ground up for modern Forge.
• Smart Wrapper: WorldShaper acts as a smart wrapper around the vanilla generator. We don't replace the base game; we just enhance it.
• Highly Compatible: It will not break other worldgen mods like Terralith, Tectonic, or Biomes O' Plenty. It simply adds post-processing on top of them. All vanilla structures (strongholds, mineshafts, amethyst geodes) remain untouched and functional.
• Performance Friendly: We use a custom Region Cache (SavedData). Terrain heightmaps and river maps are generated once per 512x512 block region and cached. This means chunk generation speed is nearly identical to vanilla. No massive lag spikes!

📥 Installation Guide

1. Ensure you have Minecraft Forge (version 47.2.0 or higher) installed for Minecraft 1.20.1.
2. Download the latest .jar file from this page.
3. Locate your .minecraft/mods folder (or use your favorite launcher like CurseForge App or Prism).
4. Drop the .jar file into the mods folder.
5. Launch the game, create a new world, and click the new "World Generation" button!

❓ FAQ (Frequently Asked Questions)

Q: Can I change the settings after creating the world? A: You can change some settings via the config file, but it will ONLY affect newly generated chunks. Already generated terrain will remain untouched to prevent world corruption and ugly chunk borders.

Q: Does it work on multiplayer servers? A: Yes! The mod must be installed on the server. Clients connecting to the server do not strictly need the mod installed, though it is highly recommended for the custom UI to work when creating the world.

Q: Will this conflict with my other mods? A: It is designed to be non-destructive. However, if you use a mod that completely overrides the Overworld generator (like custom dimensions), compatibility may vary. Always test on a backup world first!

Q: Why are my rivers frozen or missing? A: Rivers only generate above sea level (Y=62). If you are in a very hot or very cold biome, or if you chose a preset without rivers, they might not appear. Check your sliders!

🤝 Support & Community

If you find any bugs or have suggestions for new features, please let me know in the comments below!

Thank you for downloading WorldShaper. Enjoy building your perfect world!