Объекты и правила объектов

Всё, что украшает землю, - это объект (feature): рудные жилы, деревья, цветы, трава, валуны, источники, кораллы. Если это не основной рельеф и не моб, скорее всего, это объект.

Чтобы объект появился в мире, нужны два файла:

• Объект говорит, что ставить: рудную жилу, дерево, одиночный блок.
• Правило объекта говорит, где и как часто: в каких биомах, сколько раз на чанк, на какой высоте.

В этом гайде вы сделаете так, чтобы рубиновая руда появлялась под землёй во всех биомах верхнего мира.

Файлы

BP/
  blocks/
    ruby_ore.json
  features/
    ruby_ore_feature.json
  feature_rules/
    ruby_ore_rule.json

Шаг 1: блок руды

Сначала нужен блок, который будем ставить. Сделайте обычный свой блок wiki:ruby_ore с текстурой и таблицей добычи. Если вы ещё не делали блоки, пройдите гайд Ваш первый блок.

Шаг 2: объект

{
  "format_version": "1.13.0",
  "minecraft:ore_feature": {
    "description": {
      "identifier": "wiki:ruby_ore_feature"
    },
    "count": 6,
    "replace_rules": [
      {
        "places_block": "wiki:ruby_ore",
        "may_replace": [
          "minecraft:stone",
          "minecraft:granite",
          "minecraft:diorite",
          "minecraft:andesite"
        ]
      }
    ]
  }
}

• Корневой ключ, здесь minecraft:ore_feature, - это тип объекта. В каждом файле ровно один. Все они перечислены в таблице внизу страницы.
• count - сколько блоков пытается поставить одна жила. У алмазов жилы маленькие, у угля большие.
• replace_rules говорит, какой блок куда ставить. Руда заменяет только блоки из may_replace, поэтому никогда не висит в воздухе в пещерах и не проедает землю.

Правила имён

• Один объект на файл.
• Имя файла должно совпадать с частью идентификатора после двоеточия. wiki:ruby_ore_feature лежит в ruby_ore_feature.json. Пространство имён при сравнении не учитывается.
• Если в двух пакетах один и тот же идентификатор, побеждает пакет, который выше в списке. Так можно заменить ванильный объект.

Шаг 3: правило объекта

Объект ничего не делает, пока правило объекта не привяжет его к биомам:

{
  "format_version": "1.13.0",
  "minecraft:feature_rules": {
    "description": {
      "identifier": "wiki:ruby_ore_rule",
      "places_feature": "wiki:ruby_ore_feature"
    },
    "conditions": {
      "placement_pass": "underground_pass",
      "minecraft:biome_filter": [
        {
          "test": "has_biome_tag",
          "operator": "==",
          "value": "overworld"
        }
      ]
    },
    "distribution": {
      "iterations": 4,
      "coordinate_eval_order": "zyx",
      "x": {
        "distribution": "uniform",
        "extent": [0, 16]
      },
      "y": {
        "distribution": "triangle",
        "extent": [-48, 16]
      },
      "z": {
        "distribution": "uniform",
        "extent": [0, 16]
      }
    }
  }
}

В правиле три части.

description

• identifier даёт правилу имя. Как и у объектов, часть после двоеточия должна совпадать с именем файла.
• places_feature - объект, который ставит это правило. Одно правило управляет одним объектом.

conditions

minecraft:biome_filter выбирает биомы. Это список проверок фильтра, и почти всегда вы будете использовать has_biome_tag. Каждый биом проходит фильтр: те, что прошли, получают объект.

Проверки можно объединять через all_of и any_of. Этот фильтр выбирает тёплые биомы верхнего мира, которые не являются океанами:

"minecraft:biome_filter": [
  { "test": "has_biome_tag", "operator": "==", "value": "overworld" },
  {
    "any_of": [
      { "test": "has_biome_tag", "operator": "==", "value": "desert" },
      { "test": "has_biome_tag", "operator": "==", "value": "mesa" }
    ]
  },
  { "test": "has_biome_tag", "operator": "!=", "value": "ocean" }
]

Чтобы рубиновая руда была только в Рубиновой роще, проверяйте её собственный тег: "value": "ruby_grove".

placement_pass говорит, когда объект ставится по сравнению с другими. Проходы выполняются в таком порядке:

У объектов в одном проходе нет постоянного порядка между собой.

distribution

Эта часть решает, сколько копий пытаются появиться в каждом чанке и где.

В правиле объекта x и z отсчитываются от угла чанка, так что [0, 16] покрывает весь чанк. y - это высота в мире.

У каждого диапазона есть тип distribution, который задаёт, куда попадают значения:

Для того, что стоит на земле, например растений, задайте y через Molang, чтобы объект попадал на поверхность:

"y": "query.heightmap(variable.worldx, variable.worldz)"

Проверка

1. Включите пакет в новом мире.
2. Перейдите в режим наблюдателя командой /gamemode spectator и пролетите под землёй около Y 0.
3. Ищите рубиновую текстуру в камне. Слишком редко? Увеличьте iterations или count.

Если ничего не появилось, откройте журнал контента. Обычные причины: имя файла не совпадает с идентификатором, неверное имя в places_feature или опечатка в имени блока в places_block.

Все типы объектов

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

Что дальше

• Сделайте дом для своей руды: Файл биома.
• Найдите теги биомов для фильтров: minecraft:tags.