Файл биома

Биом - это область мира со своей землёй, погодой, цветами и мобами. Равнины, пустыни и вишнёвые рощи - всё это биомы. В этом гайде ты сделаешь рубиновую рощу: тёплый луг с красноватой травой, который заменяет небольшие участки равнин.

Биом, как и блок, живёт в двух пакетах:

• Файл в пакете поведения говорит, как устроена земля: её климат, какие блоки покрывают поверхность и где биом появляется.
• Файл в пакете ресурсов ("клиентский биом") говорит, как он выглядит и звучит: цвет травы, цвет воды, туман, музыка.

Файлы

BP/
  biomes/
    ruby_grove.biome.json
RP/
  biomes/
    ruby_grove.client_biome.json

Оба файла используют один и тот же identifier, wiki:ruby_grove. Так игра понимает, что они связаны.

Шаг 1: биом в пакете поведения

{
  "format_version": "1.26.30",
  "minecraft:biome": {
    "description": {
      "identifier": "wiki:ruby_grove"
    },
    "components": {
      "minecraft:climate": {
        "temperature": 0.9,
        "downfall": 0.4,
        "snow_accumulation": [0.0, 0.125]
      },
      "minecraft:overworld_height": {
        "noise_type": "lowlands"
      },
      "minecraft:surface_builder": {
        "builder": {
          "type": "minecraft:overworld",
          "top_material": "minecraft:grass_block",
          "mid_material": "minecraft:dirt",
          "foundation_material": "minecraft:stone",
          "sea_floor_material": "minecraft:gravel",
          "sea_material": "minecraft:water",
          "sea_floor_depth": 7
        }
      },
      "minecraft:replace_biomes": {
        "replacements": [
          {
            "dimension": "minecraft:overworld",
            "targets": ["plains"],
            "amount": 0.25,
            "noise_frequency_scale": 0.5
          }
        ]
      },
      "minecraft:map_tints": {
        "grass": { "type": "tint", "tint": "#c4504f" },
        "foliage": "#b8433f"
      },
      "minecraft:tags": {
        "tags": ["overworld", "animal", "monster", "plains", "ruby_grove"]
      }
    }
  }
}

В файле две части:

• description содержит identifier. Используй строчные буквы и своё пространство имён. Это же название использует /locate biome.
• components содержит всё остальное. Каждый компонент включает одну возможность биома.

Клади один биом в один файл и называй файл по имени биома (ruby_grove.biome.json для wiki:ruby_grove).

Главные компоненты

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

Как биом попадает в мир

Новый файл биома сам по себе ничего не делает. Игра размещает только тот биом, который говорит ей, куда его ставить, поэтому своему биому нужен minecraft:replace_biomes:

• targets перечисляет биомы, которые ты занимаешь. Пиши их без пространства имён (plains, а не minecraft:plains).
• dimension - это minecraft:overworld или minecraft:nether.
• amount - примерно какую часть целевого биома ты заменяешь, от чуть больше 0 до 1.
• noise_frequency_scale задаёт размер участков. Чем меньше значение, тем участков меньше, но они крупнее. Чем больше, тем участков много и они маленькие.

Теги

Теги - это простые слова, прикреплённые к биому. У них две задачи:

1. Их проверяют другие файлы. Правила появления и правила структур используют проверки вроде has_biome_tag, чтобы решать, где появляются мобы и где ставить деревья или руды. Дай своему биому теги вроде overworld, animal и monster, и много ванильного контента будет относиться к нему как к обычному биому Верхнего мира.
2. У некоторых тегов есть встроенный смысл. Например, cold или frozen одевают жителей по-зимнему, plains, forest, meadow и swamp выбирают, какие цветы растут, а desert и mesa заставляют песок издавать фоновые звуки.

Добавь и свой тег (здесь ruby_grove). Тогда твои собственные структуры и мобы смогут нацеливаться именно на этот биом.

В тегах можно использовать буквы, цифры, . и _.

Шаг 2: клиентский биом

Сторона пакета ресурсов устроена так же, но её корень - minecraft:client_biome:

{
  "format_version": "1.21.120",
  "minecraft:client_biome": {
    "description": {
      "identifier": "wiki:ruby_grove"
    },
    "components": {
      "minecraft:grass_appearance": {
        "color": "#c4504f"
      },
      "minecraft:foliage_appearance": {
        "color": "#b8433f"
      },
      "minecraft:water_appearance": {
        "surface_color": "#7a3fd1"
      },
      "minecraft:sky_color": {
        "sky_color": "#ff9a8c"
      },
      "minecraft:fog_appearance": {
        "fog_identifier": "wiki:ruby_fog"
      },
      "minecraft:biome_music": {
        "music_definition": "cherry_grove"
      }
    }
  }
}

Vibrant Visuals добавляет ещё четыре, которые указывают на отдельные файлы: атмосфера, освещение, цветокоррекция и вода. Полный список - в разделе Компоненты клиентского биома.

Все компоненты необязательны. Для всего, что ты не указал, используется значение по умолчанию.

Проверка

1. Включи оба пакета в новом мире. Биомы появляются только в чанках, которые ещё не были созданы.
2. Введи /locate biome wiki:ruby_grove, чтобы найти его.
3. Долети туда и проверь цвет травы. Если она обычная зелёная, identifier клиентского биома не совпадает.

Что дальше

• Наполни биом рубиновой рудой и растениями: Структуры и правила структур.
• Задай ему своё настроение: Туман.
• Найди название любого биома в разделе ID биомов.