Перейти к содержимому

Biome Cleaner

Удаляет микробиомы из вашего мира.

FabricNeoForgeForge
Загрузчики
FabricNeoForgeForge
Скачиваний на Modrinth
11,3 тыс.
Подписчиков на Modrinth
69
версий
77
Обновлён
11 мая 202611 мая
Опубликован
в 2026

Коротко о моде

Работает на Fabric, NeoForge и Forge
Для Minecraft 1.21.1, 1.21.11–26.1.2
Ставится только на сервер; игрокам ставить не нужно
Последняя версия — 1.1.8 от 11 мая 2026
Нужен Fabric API
Лицензия MIT — бесплатно
Где нужен
В игрене нуженНа сервереобязателен

Ставится только на сервер; игрокам ставить не нужно

Версии игры1.21.1, 1.21.11–26.1.2
Описание переведено автоматическиПоказать оригинал (EN)

Biome Cleaner

Убирает беспорядочные разбросанные пятна биомов, которые создаёт генерация ландшафта Minecraft. Маленькие области биомов сливаются с более крупными соседями, что даёт более чистые границы и естественный вид мира — без изменения формы ландшафта, структур и геймплея.

Мод работает только на стороне сервера (установка на клиент не нужна) и выполняется полностью на собственных фоновых потоках, так что тикрейт сервера не страдает.

До и после

С настройками по умолчанию те крошечные пятна равнин размером в 1 чанк посреди леса или неуместные полоски пляжа поглощаются окружающим биомом. В результате области биомов становятся более плавными и целостными, а общая структура мира сохраняется.

Возможности

  • Настраиваемый порог — задайте, насколько маленькой должна быть область биома, чтобы её слили (по умолчанию: 512 кварт)
  • Защита биомов — отметьте конкретные биомы (например, редкие), которые никогда не заменяются
  • Контроль замены — запретите определённым биомам (например, океанам) распространяться на другие области
  • Группы биомов — задавайте группы для массовой настройки (например, все варианты океана)
  • Пороги для групп — используйте разные пороги размера для разных типов биомов
  • Обрезка по диапазону размера — ограничивайте максимальный размер биома, обрезая слишком крупные области вместо их полной замены (например, чтобы каменистые берега оставались маленькими)
  • Сохранение с учётом групп — пометьте группу как «предпочтительную», чтобы её участники сливались друг с другом прежде чем переключаться на внешние биомы; области среднего размера без соседа внутри группы сохраняются, а не заменяются (например, сохранить внутренние озёра, но всё равно убрать крошечные океанские лужицы)
  • Требования к границам — заставьте биом очищаться, если его граница не соприкасается с нужными соседями, независимо от размера (например, убрать внутренние пляжи, рядом с которыми нет океана или реки)
  • Фоновая предобработка — чанки очищаются заранее перед игроком, так что при загрузке нового ландшафта нет лагов
  • Только на стороне сервера — установка на клиент не требуется

Добавление в существующий мир

Мод лучше всего работает на новых мирах, но его можно добавить и в существующий мир с одной оговоркой: на границе уже исследованной области могут появиться швы между биомами.

Это происходит потому, что мод влияет на чанки только при их первой генерации. Если маленькое пятно биома пересекает границу между уже исследованными и ещё не исследованными чанками, старая сторона сохраняет исходные биомы, а новая очищается — возникает заметное несоответствие в месте стыка двух половин.

Эти швы появляются только прямо на краю ранее исследованной территории и только там, где маленькое пятно биома случайно пересекает эту границу. Остальной новый ландшафт будет полностью очищен, как и ожидается. Как только вы минуете пограничную зону, всё становится бесшовным.

Начинаете новый мир? Никаких проблем — каждый чанк очищается при генерации.

Настройка

Основной конфиг

Расположен в config/biomecleaner/common.json:

ОпцияПо умолчаниюОписание
enabledtrueГлавный переключатель очистки биомов
sizeThreshold512Минимальный размер области в квартах (области 4x4 блока). Области меньше этого значения сливаются. Диапазон: 1--1024
neverReplace["rare"]Биомы/группы, которые никогда не заменяются, даже если они маленькие
neverUseAsReplacement["oceans", "rivers"]Биомы/группы, которые никогда не заменяют другие биомы
allowIntraGroupReplacement["oceans"]Группы, внутри которых биомы могут заменять друг друга
preprocessingEnabledtrueВключить фоновую предобработку (рекомендуется). Когда включено, чанки очищаются до того, как игрок до них дойдёт
preprocessingThreadCount0Количество рабочих потоков для предобработки. 0 = автоматически (исходя из вашего CPU)
cacheMemoryMB128Бюджет памяти для кэша предобработки в МБ. Увеличьте, если у вас есть запас RAM и вы хотите большее время опережения

Что такое quart? Minecraft хранит биомы с разрешением 1/4 блока (одно значение биома на куб 4x4x4 блока). «Quart» — это одна из таких ячеек биома 4x4. Порог по умолчанию в 512 квартов соответствует примерно области 90x90 блоков — небольшие пятна меньше этого размера вычищаются.

Продвинутая настройка

Находится в config/biomecleaner/advanced.json:

ПолеОписание
groupsЗадаёт именованные группы биомов для использования в основном конфиге
sizeThresholdOverridesПереопределяет порог размера для конкретных биомов или групп. Принимает одно число (минимальный размер) или пару [min, max]
intraGroupPreferenceПомечает группу как «предпочтительную», чтобы её члены сливались друг с другом прежде чем переключаться на другую группу, и сохраняет средние по размеру регионы, у которых нет соседа внутри группы
requiredBoundaryGroupsТребует, чтобы граница биома касалась хотя бы одной из перечисленных групп — регионы, которые не соответствуют, вычищаются независимо от размера
sizeThresholdOverrides

Каждая запись принимает либо одно число, либо пару [min, max]:

  • "biome": N — регионы меньше N квартов заменяются. Верхней границы нет. (То же поведение, что и до 1.1.0.)
  • "biome": [min, max] — регионы меньше min заменяются; регионы между min и max сохраняются; регионы больше max обрезаются до пятна размером max вместо полной замены.

В конфиге по умолчанию используется [32, 64] для minecraft:stony_shore, чтобы очень маленькие пятна каменистого берега всё ещё вычищались полностью, но чрезмерно большие пространства каменистого берега сжимались, а не стирались из мира.

Когда один и тот же биом указан и напрямую (например, "minecraft:stony_shore"), и через группу, к которой он принадлежит (например, "beaches"), побеждает более конкретная запись по id биома.

intraGroupPreference

Каждая запись сопоставляет имя группы объекту предпочтения:

  • mode: "preferred" — регионы биомов из этой группы предпочитают сливаться с другими членами той же группы, когда это возможно.
  • fallbackOutOfGroupBelowSize: N — если сосед внутри группы недоступен, регионы меньше N квартов проваливаются и получают обычную замену вне группы; регионы от N и выше сохраняются вместо переключения.

В конфиге по умолчанию oceans помечены как предпочтительные с размером отката 8. Практический эффект:

  • Крошечная океанская лужица посреди суши (меньше 8 квартов) вычищается до окружающей суши как обычно — рядом нет другого океана для слияния, и она достаточно мала, чтобы её не хотелось оставлять.
  • Более крупное внутреннее озеро (8 квартов и больше) сохраняется вместо замены, даже если рядом нет другого океана в качестве соседа.
  • Прибрежная полоска океана рядом с другим вариантом океана (например, маленькое пятно ocean рядом с frozen_ocean) сливается с этим соседним вариантом, а не превращается в пляж. Так регион, наполовину состоящий из океана и наполовину из frozen ocean, вычищается в единый вариант океана.
requiredBoundaryGroups

Каждая запись сопоставляет биом (или группу) списку групп, которые должны присутствовать на его границе. Если ни одной из требуемых групп нет, регион вычищается независимо от размера.

В конфиге по умолчанию требуется, чтобы beaches касались oceans или rivers. Без этого правила необычно большое пятно пляжа, окружённое только лесом, сохранялось бы просто потому, что оно достаточно большое для прохождения порога размера. С этим правилом любой внутренний пляж без воды поблизости вычищается, каким бы большим он ни был.

Продвинутый конфиг по умолчанию
{
  "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,
    "minecraft:stony_shore": [32, 64],
    "rivers": 48
  },
  "intraGroupPreference": {
    "oceans": {
      "mode": "preferred",
      "fallbackOutOfGroupBelowSize": 8
    }
  },
  "requiredBoundaryGroups": {
    "beaches": ["oceans", "rivers"]
  }
}

</details>

### Рекомендуемые аргументы JVM

Рабочие потоки мода рассчитаны на более низкий приоритет, чем основной поток сервера, поэтому они автоматически уступают процессорное время, когда оно нужно серверу. По умолчанию Java игнорирует настройки приоритета потоков. Добавление этих двух флагов JVM в скрипт запуска сервера включает их:

-XX:+UseThreadPriorities -XX:ThreadPriorityPolicy=1


Это необязательно, но рекомендуется — так фоновая работа мода никогда не конкурирует с обработкой тиков, даже под тяжёлой нагрузкой.

## Производительность

> **Примечание к этим цифрам:** Все показатели в этом разделе были сняты на версии 1.0.3. В версии 1.1.0 появился переписанный алгоритм очистки и три новые настройки конфига, известных регрессий производительности нет, но цифры ниже ещё не перемерялись на новой сборке. Обновлённый прогон выйдет в одном из будущих релизов.

**Кратко: вы этого не заметите.** На 1.0.3 мод добавлял около 2,4% нагрузки на CPU при настройках по умолчанию и работал полностью на своих фоновых потоках — на тикрейт сервера это не влияло. Ожидаем, что 1.1.0 покажет примерно те же цифры.

Эти цифры получены при `sizeThreshold = 512` по умолчанию. Меньшие пороги стоят дешевле, большие — немного дороже, но все укладывались в 3% CPU.

| Что | Результат |
|------|--------|
| Нагрузка на CPU | **2,4%** суммарно, всё на выделенных рабочих потоках |
| Влияние на ванильный код сервера | **Не измеряется** (в пределах 0,1% от ванили) |
| Время обработки чанка | **92,7%** чанков очищены быстрее чем за 1 мс |
| Попадание в кэш | **100%** — чанки готовы раньше, чем вы туда доберётесь |
| Среднее опережение | **6,1 секунды** до прибытия игрока |
| Паузы GC | Все меньше 16 мс (бюджет тика — 50 мс) |

Мод предсказывает, куда направляется игрок, и заранее очищает чанки в фоне задолго до того, как они понадобятся. В бенчмарках 79% чанков были готовы более чем за 5 секунд до прибытия игрока.

### Сравнение порогов

Более высокие пороги чистят агрессивнее (объединяя более крупные участки) за небольшую дополнительную цену:

| | 256 | **512 (по умолчанию)** | 1024 |
|---|---|---|---|
| Нагрузка на CPU | 2,0% | **2,4%** | 2,9% |
| Чанков очищено < 1 мс | 97,8% | **92,7%** | 87,1% |
| Чанков с заменами | 2,7% | **4,1%** | 5,9% |
| Попадание в кэш | 100% | **100%** | 100% |
| Опережение | 6,1 с | **6,1 с** | 5,9 с |

Все пороги работают на выделенных фоновых потоках без влияния на производительность ванильного сервера.

<details>
<summary>Подробные данные бенчмарков</summary>

### Условия теста

| Параметр | Значение |
|---|---|
| Minecraft | 1.21.11 |
| Прогонов | 10 на конфигурацию |
| Пройденное расстояние | 5 000 блоков |
| View/Sim distance | 10 |
| Фоновых потоков | 16 |
| Память сервера | 6 ГБ |

### Разбивка по CPU

| Метрика | Ваниль | 256 | **512** | 1024 |
|---|---|---|---|---|
| Работа CPU мода | -- | 2,0% | **2,4%** | 2,9% |
| Дельта не-модового кода к ванили | -- | -0,4% | **-0,1%** | -1,0% |

Не-модовый код остаётся в пределах 1% от ванили при всех порогах, что подтверждает: мод не отбирает процессорное время у сервера.

### Обработка чанков

| Перцентиль | 256 | **512** | 1024 |
|---|---|---|---|
| Медиана (p50) | 0,060 мс | **0,047 мс** | 0,038 мс |
| p95 | 0,745 мс | **1,117 мс** | 1,948 мс |
| p99 | 1,356 мс | **1,975 мс** | 3,331 мс |
| Максимум | 9,97 мс | **11,19 мс** | 24,94 мс |

Среднее время обработки при пороге по умолчанию — 0,249 мс на чанк.

### Сборка мусора

| Метрика | Ваниль | 256 | **512** | 1024 |
|---|---|---|---|---|
| Средняя суммарная пауза/прогон | 228 мс | 282 мс | **284 мс** | 286 мс |
| Средняя длительность паузы | 7,46 мс | 8,85 мс | **8,93 мс** | 9,07 мс |
| Максимальная одиночная пауза | 12,3 мс | 23,9 мс | **15,5 мс** | 15,4 мс |

Влияние GC почти одинаково на всех порогах. Все паузы остаются значительно ниже бюджета тика в 50 мс.

### Кэш и прогрев

| Метрика | 256 | **512** | 1024 |
|---|---|---|---|
| Чанков обработано/запуск | ~8,500 | **~8,500** | ~8,400 |
| Доля попаданий в кэш | 100.0% | **100.0%** | 100.0% |
| Среднее время опережения | 6.1 с | **6.1 с** | 5.9 с |
| Прогрето на 5+ секунд раньше | 76.9% | **78.9%** | 75.6% |
| Чанков с заменами | 2.7% | **4.1%** | 5.9% |

</details>

Частые вопросы

Как установить Biome Cleaner?

Установите Fabric под свою версию Minecraft, скачайте Biome Cleaner под ту же версию и загрузчик, положите файл в папку mods и запустите игру с профилем загрузчика.

Для каких версий Minecraft есть Biome Cleaner?

У Biome Cleaner есть сборки для Minecraft 1.21.1, 1.21.11–26.1.2.

Нужен ли Biome Cleaner на сервере?

Ставится только на сервер; игрокам ставить не нужно

Лицензия и источник
MIT Licenseможно свободно использовать и распространять с указанием автора
Оригинал — Modrinth↗Файлы — без изменений, проверены по SHA-512Это ваш мод? Правообладателям

Сайт использует cookie: необходимые — для входа и темы, а также счётчики посещений Яндекс Метрика и LiveInternet — по ним мы видим, как пользуются сайтом. Рекламных cookie у нас нет. Подробнее