Terraloop Climate

# Terraloop Climate

**Terraloop Climate** is a NeoForge 1.21.1 world-generation mod that adds a selectable Overworld preset called **Terraloop Climate Overworld**.

The preset is designed for finite Overworld gameplay, especially when used with **TerraLoop Border**. Its goal is to make major vanilla biome families easier to find inside a limited playable map without replacing vanilla terrain generation.

## What It Does

Terraloop Climate uses a custom server-side **BiomeSource** to control biome placement for its own Overworld preset.

It helps distribute major vanilla surface biome families across the world, including:

- Frozen biomes
- Cold forests
- Temperate forests
- Plains
- Swamps
- Jungles
- Deserts
- Badlands
- Savannas
- Oceans
- Deep oceans
- Beaches
- Rivers
- Mountains
- Peaks

When **TerraLoop Border** is installed, Terraloop Climate reads the finite map size and scales biome bands and biome variant patches to better fit the playable area.

This helps frozen, cold, temperate, hot, oceanic, mountain, and peak biome regions remain discoverable inside TerraLoop-sized worlds.

## Features

- Adds the selectable **Terraloop Climate Overworld** world preset.
- Uses a custom server-side BiomeSource.
- Designed for TerraLoop Border finite worlds.
- Scales biome bands and biome variant patches when TerraLoop Border is present.
- Reduces biome repetition on small finite maps.
- Helps major vanilla biome families appear within the playable area.
- Keeps vanilla Overworld terrain density and noise settings.
- Does not replace the default vanilla Overworld preset.
- Includes audit/debug commands:
  - `/completeclimate audit`
  - `/completeclimate locateMissing`
  - `/completeclimate dumpCatalog`

## Compatibility

- **Minecraft:** 1.21.1
- **Loader:** NeoForge
- **Mod ID:** `completeclimate`

Terraloop Climate is designed to work with **TerraLoop Border**, but the preset is separate from the default vanilla Overworld preset.

TerraLoop Border is recommended for the intended finite-world experience. Unless otherwise stated, it should be treated as special compatibility rather than a hard dependency.

Compatibility with other world-generation mods may vary if those mods also replace Overworld presets, dimension settings, or biome generation.

## How To Use

1. Install NeoForge for Minecraft 1.21.1.
2. Place the Terraloop Climate `.jar` file in your `mods` folder.
3. Optional but recommended: install TerraLoop Border.
4. Launch Minecraft.
5. Create a new world.
6. In the world preset or world type selection, choose:

**Terraloop Climate Overworld**

7. Create the world.

For best results, use this preset when creating a new world.

## Important Limitations

- Terraloop Climate controls biome placement, not terrain shape.
- It keeps vanilla Overworld terrain density and noise settings.
- It does not add new biomes.
- It does not add new blocks, mobs, structures, or dimensions.
- Existing chunks keep their old biome data.
- To see the new biome layout, create a new world or regenerate old chunks.
- The default vanilla Overworld preset is not replaced.
- Players must manually select **Terraloop Climate Overworld** during world creation.

## Debug / Audit Commands

The mod includes commands for checking biome coverage during testing:

- `/completeclimate audit`
- `/completeclimate locateMissing`
- `/completeclimate dumpCatalog`

These are mainly useful for testing, debugging, and verifying biome distribution.