Biome Modifier for Fabric

Fabric生物群系修改器

摘要

这是一个前置库模组，允许用户利用数据包轻松且兼容地修改生物群系。

开发者使用说明

我们都知道，对于Forge整合包，开发者可以利用以下示例来修改生物群系：

{
  "type": "forge:add_features",
  "biomes": "#forge:is_plains",
  "features": [
    "emeraldcraft:wild_cabbage",
    "emeraldcraft:wild_chili"
  ],
  "step": "vegetal_decoration"
}

让我们让它在Fabric上也能工作！

数据包开发者应将所有生物群系修改器（格式为*.json）放在data/<modid>/biome_modifiers/目录下。借助此模组，所有生物群系修改器都将应用于每个生物群系。

所有生物群系修改器都应遵循以下格式：

{
  "type": "<modifier type>",
  "biomes": "<registry name of a single biome/list of registry names of biomes/a tag of biomes>",
  "priority": priority,
  "<other keys...>": "<other values...>"
}

其中type代表生物群系修改器的类型，biome代表所有要修改的生物群系。

请注意，priority字段是可选的。该值越小，它就会越早应用于生物群系（例如，优先级为99的修改器会比优先级为100的修改器更早应用）。默认值为1000。

不同类型的生物群系修改器

我们目前提供9种不同类型的生物群系修改器：

biome_modifier:none

此类型允许开发者替换其他数据包中的其他生物群系修改器。

{
  "type": "biome_modifier:none"
}

biome_modifier:add_features

此生物群系修改器会将features字段中提到的所有已放置地物添加到目标生物群系。

如果注册表中缺少任何已放置地物，将记录错误（在安全模式下不会使游戏崩溃）。

{
  "type": "biome_modifier:add_features",
  "biomes": "<registry name(s) of biomes>",
  "features": "<registry name of a single feature/list of registry names of features>",
  "step": "<step of decoration generation>"
}

biome_modifier:remove_features

此生物群系修改器会从目标生物群系中移除features字段中提到的所有已放置地物。

如果目标生物群系中缺少任何已放置地物，将记录警告，并且不会使游戏崩溃。

如果注册表中缺少任何已放置地物，将记录错误（在安全模式下不会使游戏崩溃）。

{
  "type": "biome_modifier:remove_features",
  "biomes": "<registry name(s) of biomes>",
  "features": "<registry name of a single feature/list of registry names of features>",
  "step": "<step of decoration generation>"
}

biome_modifier:add_spawns

此生物群系修改器会将spawns字段中提到的所有实体生成添加到目标生物群系。

如果注册表中缺少任何实体类型，将记录错误（在安全模式下不会使游戏崩溃）。

{
  "type": "biome_modifier:add_spawns",
  "biomes": "<registry name(s) of biomes>",
  "spawners": [
    {
      "type": "<registry name of a single entity type>",
      "weight": weight,
      "minCount": minCount,
      "maxCount": maxCount
    }
    //If you only add one spawner, you can also replace the list with the only object.
  ]
}

biome_modifier:remove_spawns

此生物群系修饰器会从目标生物群系中移除 entity_types 字段提到的所有实体生成项。

如果目标生物群系中缺少某种实体类型，会记录警告，但不会导致游戏崩溃。

如果注册表中缺少某种实体类型，会记录错误（安全模式下不会导致游戏崩溃）。

{
  "type": "biome_modifier:remove_spawns",
  "biomes": "<registry name(s) of biomes>",
  "entity_types": [
    "<registry name of a single entity type>"
    //If you only remove one spawner, you can also replace the list with the only string.
  ]
}

biome_modifier:add_spawn_costs

此生物群系修饰器会将 spawn_costs 字段提到的所有实体生成项添加到目标生物群系中。

与 biome_modifier:add_spawns 相反，此修饰器会将生成项添加到生成代价（即生成潜力、生成密度）中。

如果注册表中缺少某种实体类型，会记录错误（安全模式下不会导致游戏崩溃）。

{
  "type": "biome_modifier:add_spawn_costs",
  "biomes": "<registry name(s) of biomes>",
  "spawn_costs": {
    "<registry name of a single entity type>": {
      "charge": charge,
      "energy_budget": energy_budget
    }
  }
}

biome_modifier:remove_spawn_costs

此生物群系修饰器会从目标生物群系中移除 entity_types 字段提到的所有实体生成项。

与 biome_modifier:remove_spawns 相反，此修饰器会从生成代价（即生成潜力、生成密度）中移除生成项。

如果目标生物群系中缺少某种实体类型，会记录警告，但不会导致游戏崩溃。

如果注册表中缺少某种实体类型，会记录错误（安全模式下不会导致游戏崩溃）。

{
  "type": "biome_modifier:remove_spawn_costs",
  "biomes": "<registry name(s) of biomes>",
  "entity_types": [
    "<registry name of a single entity type>"
    //If you only remove one spawner, you can also replace the list with the only string.
  ]
}

biome_modifier:add_carvers

此生物群系修饰器会将 carvers 字段提到的所有雕刻器添加到目标生物群系中。

如果注册表中缺少某个雕刻器，会记录错误（安全模式下不会导致游戏崩溃）。

{
  "type": "biome_modifier:add_carvers",
  "biomes": "<registry name(s) of biomes>",
  "carvers": "<registry name of a single carver/list of registry names of carvers>",
  "step": "<step of carver generation>"
}

biome_modifier:remove_carvers

此生物群系修饰器会从目标生物群系中移除 carvers 字段提到的所有雕刻器。

如果目标生物群系中缺少某个雕刻器，会记录警告，但不会导致游戏崩溃。

如果注册表中缺少某个雕刻器，会记录错误（安全模式下不会导致游戏崩溃）。

{
  "type": "biome_modifier:remove_carvers",
  "biomes": "<registry name(s) of biomes>",
  "carvers": "<registry name of a single carver/list of registry names of carvers>",
  "step": "<step of carver generation>"
}

示例

我们为模组提供了 3 个示例数据包：

额外矿石

此数据包会在主世界中添加额外的矿石方块。

主世界无矿石

此数据包会移除主世界中的所有矿石方块，仅保留矿脉，供玩家开采矿石。

下界僵尸

此数据包会让僵尸能够在下界生成。