Neural Terrain

NEURAL TERRAIN

A Fabric mod for Minecraft 1.21.4 that replaces default Overworld generation with realistic terrain generated by an artificial intelligence model trained on real Earth satellite data.

Continents, mountain ranges, plains, biomes, oceans, rivers, and caves are generated together in a seamless, natural landscape. Vanilla structures, villages, temples, trees, and ores are fully supported and naturally integrated into the terrain.

FEATURES

• Realistic AI-Generated Landscapes:
  Vast mountain peaks, rolling hills, canyons, flat valleys, and natural shorelines generated seamlessly without chunk cuts or sharp borders.

• Rich Variety of Vanilla Biomes:
  Smooth transitions between deserts, badlands, savannas, lush jungles, dark oak forests, flower plains, birch groves, taiga, snowy slopes, frozen peaks, and deep oceans.

• Runs on Almost Any Hardware (CPU or GPU):
  - CPU Mode: Works out of the box on any modern processor using all available cores.
  - GPU Mode: Accelerated generation on graphics cards (NVIDIA, AMD, Intel), integrated laptop graphics, Apple Silicon (M1/M2/M3/M4).

HOW TO PLAY

1. Install Fabric Loader for Minecraft 1.21.4.
2. Install Fabric API for 1.21.4.
3. Put the mod's .jar file into your `.minecraft/mods` folder.
4. Launch Minecraft and click "Create New World".
5. Go to the "World" tab.
6. Click "World Type" and select "Neural Terrain".
7. Click the "Neural engine" button to choose CPU or your graphics card / Metalium device.
8. Create the world and explore!

SETTINGS

• In-Game Engine Menu:
  Accessible when creating a world. Lets you switch between CPU and any detected graphics card or integrated GPU. If you connect an external GPU or change graphics drivers, click "Rescan compute devices".

• In-Game Command:
  Type `/neuralterrain info` in chat to see your active engine and generation performance.

• Config File (`config/xaloex_neural_terrain.json`):
  Your settings are saved automatically. You can also edit them manually:
  - "engine": "cpu" or "gpu"
  - "gpuDevice": choose a specific graphics device, or leave empty for auto-detect
  - "seamSmoothing": true (keeps borders between areas completely smooth)
  - "caves": true (enables underground cave generation)

TIPS & PERFORMANCE

• For best generation speed, select your GPU or integrated graphics in the engine settings.
• Recommended render distance: 12–16 chunks.
• If your graphics driver does not support GPU acceleration, the mod will safely switch to CPU mode without crashing or corrupting your world.
• Memory: 4 GB minimum allocated to Minecraft; 6–8 GB recommended.

COMPATIBILITY

• Works on Windows, Linux, macOS (Apple Silicon / Intel), and iOS/iPadOS (PojavLauncher).
• Only alters the Overworld. The Nether and The End remain vanilla.
• Designed for new worlds. Do not use alongside other mods that replace the Overworld terrain generator.