Biome Cleaner

Removes biome noise by merging small biome regions into their larger neighbors. Configure the size threshold to control how aggressively patches are cleaned up.

Features

• Configurable threshold - Set how small a biome region must be before it gets merged
• Biome protection - Mark specific biomes (like rare ones) to never be replaced
• Replacement control - Prevent certain biomes (like oceans) from spreading into other areas
• Biome groups - Define groups for bulk configuration (e.g., all ocean variants)
• Per-group thresholds - Use different size thresholds for different biome types
• Server-side only - No client installation required

Configuration

Main Config

Located at config/biomecleaner/common.toml:

Advanced Config

Located at config/biomecleaner/advanced.json:

{
  "groups": {
    "rare": ["minecraft:mushroom_fields", "minecraft:stony_peaks"],
    "oceans": [
      "minecraft:ocean", "minecraft:warm_ocean", "minecraft:lukewarm_ocean",
      "minecraft:cold_ocean", "minecraft:frozen_ocean", "minecraft:deep_ocean",
      "minecraft:deep_lukewarm_ocean", "minecraft:deep_cold_ocean", "minecraft:deep_frozen_ocean"
    ],
    "rivers": ["minecraft:river", "minecraft:frozen_river"],
    "beaches": ["minecraft:beach", "minecraft:snowy_beach", "minecraft:stony_shore"]
  },
  "sizeThresholdOverrides": {
    "beaches": 32,
    "rivers": 48
  }
}

Performance Impact

The mod introduces measurable overhead that scales with your configured size threshold. Testing was performed on a 10,000 chunk region.

What This Means

The overhead scales roughly linearly with threshold size—doubling the threshold doubles the performance cost. At the default 256 quarts setting, you'll see about 2-3 ms of additional processing time per chunk, which is generally unnoticeable during normal gameplay.

Higher thresholds clean more aggressively but take longer. If you're running a server or processing large areas, the 1024 quarts setting can add significant time.

The mod adds consistent overhead without causing significant lag spikes—your worst-case performance stays predictable.