生物群落清洁工

Biome Cleaner

清理 Minecraft 地形生成所产生的杂乱、零散的生物群系斑块。小型生物群系区域会被合并到更大的相邻区域中，让你的世界拥有更清晰的边界与更自然的感觉——同时不改变地形形状、结构或玩法。

该模组仅在服务端运行（无需客户端安装），并且完全在自身的后台线程上运行，因此不会影响服务器的 tick 速率。

前后对比

在默认设置下，森林中央那些仅 1 个区块大小的平原斑块，或者出现在不该出现位置的尴尬海滩细条，都会被吸收到周围的生物群系中。结果是生物群系区域更加平滑、连贯，同时保持整体世界布局不变。

特性

• 可配置阈值 —— 设置生物群系区域必须有多小才会被合并（默认：512 quarts）
• 生物群系保护 —— 将特定生物群系（如稀有生物群系）标记为永不被替换
• 替换控制 —— 阻止某些生物群系（如海洋）扩散到其他区域
• 生物群系组 —— 定义组以进行批量配置（例如所有海洋变种）
• 按组阈值 —— 为不同生物群系类型使用不同的大小阈值
• 大小范围裁剪 —— 通过将过大的区域裁剪缩小而非直接替换，来限制生物群系的最大尺寸（例如保持石岸较小）
• 组感知保留 —— 将某个组标记为“偏好”，使其成员之间会先相互合并，然后再翻转为组外生物群系；没有组内邻居的中等区域会被保留而非替换（例如保留内陆湖泊，但仍清理微小的海洋水洼）
• 边界要求 —— 如果某个生物群系的边界未接触到正确的邻居，则无论大小都强制清理（例如清除附近没有海洋或河流的内陆海滩）
• 后台预处理 —— 区块会在玩家到达之前被清理，因此新地形加载时不会有卡顿
• 仅服务端 —— 无需客户端安装

添加到现有世界

该模组在新世界上效果最佳，但也可以添加到现有世界，但有一个注意事项：在你已探索区域的边界处可能会出现生物群系接缝。

这是因为该模组只会在区块首次生成时对其产生影响。如果一个小型生物群系斑块横跨你已探索区块和未探索区块之间的边界，旧的一侧会保留其原始生物群系，而新的一侧会被清理——从而在两侧相接处产生可见的不匹配。

这些接缝只会出现在你之前已探索区域的边缘，并且只有当小型生物群系斑块恰好跨越该边界时才会出现。你的其余新地形将按预期被完全清理。一旦你越过边界区域，一切都会无缝衔接。

开新世界？ 完全没问题——每个区块在生成时都会被清理。

配置

主配置

位于 config/biomecleaner/common.json：

什么是 quart？ Minecraft 以 1/4 方块分辨率存储生物群系（每个 4x4x4 方块立方体对应一个生物群系值）。“quart”就是这些 4x4 生物群系单元之一。默认阈值 512 quarts 大约对应 90x90 方块区域——小于此大小的斑块会被清理。

高级配置

位于 config/biomecleaner/advanced.json：

sizeThresholdOverrides

每个条目接受单个数字或 [min, max] 对：

• "biome": N —— 小于 N quarts 的区域会被替换。无上限。（与 1.1.0 之前的行为相同。）
• "biome": [min, max] —— 小于 min 的区域会被替换；介于 min 与 max 之间的区域会被保留；大于 max 的区域会被裁剪缩小为 max 大小的斑块，而非直接替换。

默认配置为 minecraft:stony_shore 使用 [32, 64]，这样非常小的石岸斑块仍会被完全清理，但过大的石岸区域会被缩小而非从世界中抹除。

当同一生物群系既被直接命名（例如 "minecraft:stony_shore"）又通过其所属的组命名（例如 "beaches"）时，更具体的生物群系 ID 条目优先。

intraGroupPreference

每个条目将一个组名映射到一个偏好对象：

• mode: "preferred" —— 此组中的生物群系区域在可能时优先合并到同组的其他成员中。
• fallbackOutOfGroupBelowSize: N —— 如果没有可用的组内邻居，小于 N quarts 的区域会回退到正常的组外替换；大于等于 N 的区域则会被保留而非翻转。

默认配置将 oceans 标记为偏好，回退大小为 8。实际效果：

• 位于陆地中央的微小海洋水洼（小于 8 quarts）会像正常情况一样被清理为周围陆地——附近没有其他海洋可合并，且小到我们不想保留它。
• 较大的内陆湖泊（8 quarts 或以上）会被保留而非替换，即使它没有其他海洋作为邻居。
• 紧邻不同海洋变种的沿海海洋细条（例如紧挨着 frozen_ocean 的小块 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"]
  }
}

推荐的 JVM 参数

该模组的工作线程被设计为以低于主服务器线程的优先级运行，因此当服务器需要 CPU 时间时，它们会自动让出。默认情况下，Java 会忽略线程优先级设置。将以下两个 JVM 标志添加到你的服务器启动脚本中即可启用它们：

-XX:+UseThreadPriorities -XX:ThreadPriorityPolicy=1

这是可选的，但推荐使用——它确保模组的后台工作即使在重负载下也永远不会与 tick 处理竞争。

性能

关于这些数据的说明： 本节中的每个数字都是在 1.0.3 版本上测得的。1.1.0 版本包含重写的清理算法和三个新的配置特性，并且没有已知的性能退化，但以下数字尚未针对新构建重新测量。更新后的测试结果会在未来版本中发布。

TL;DR：你根本不会注意到它。 在 1.0.3 上，该模组在默认设置下增加了约 2.4% 的 CPU 开销，并且完全在自身的后台线程上运行——服务器 tick 速率未受影响。我们预计 1.1.0 会处于同一水平。

这些数字来自默认的 sizeThreshold = 512。更低的阈值开销更小，更高的阈值开销略高——但都保持在 3% CPU 以下。

该模组会预测玩家前进方向，并在区块需要之前就在后台预先清理它们。在基准测试中，79% 的区块在玩家到达前 5 秒以上就已就绪。

阈值对比

更高的阈值清理更激进（合并更大的斑块），代价是略微增加开销：

所有阈值都在专用后台线程上运行，不影响原版服务器性能。