Item Registry

Датапак предоставляет надежный источник данных о системе предметов в Minecraft, позволяя запрашивать атрибуты и отфильтрованные списки через команды.

Датапак предоставляет доступ к данным компонентов предметов (например, размер стака и атрибуты редкости), а также к различным формам отсортированных и отфильтрованных списков предметов. После импорта реестра данные о предметах можно запрашивать с помощью таких команд, как /data get storage.

В основе Item Registry лежит одна функция import_registry.mcfunction, которая принимает два аргумента при выполнении:

• storage: произвольное NBT-хранилище, в которое загружается реестр;
• path: произвольный NBT-путь внутри хранилища.

Данные о предметах обычно доступны через два тега:

• item_components: хранит атрибуты предметов, такие как размер стака, редкость и ключ перевода;
• item_lists: хранит идентификаторы предметов в различных отсортированных и отфильтрованных списках.

Сначала необходимо импортировать реестр. Это можно сделать с помощью следующей команды:

/function item-registry:import_registry {storage:"foo:bar",path:"baz"}

Так как размер этой функции огромен (более 2000 строк), рекомендуется запускать её только один раз, например, при загрузке мира в теге #minecraft:load.

После завершения импорта реестр готов к работе. Для получения данных компонентов произвольного предмета, например "minecraft:allium", можно использовать следующую команду:

/data get storage foo:bar baz.item_components."minecraft:allium"

Результат будет содержать информацию о размере стака, способе получения (лут, рецепт, выживание), редкости и ключе перевода.

Вы также можете извлекать конкретные атрибуты предметов с помощью /data modify. Например, команда сохранит редкость шаблона кузнечного шаблона в промежуточное место:

/data modify storage foo:bar temp.vex_template_rarity set from storage foo:bar baz.item_components."minecraft:vex_armor_trim_smithing_template".rarity

Реестр содержит списки предметов, которые также можно запрашивать. Чтобы получить полный алфавитно отсортированный список всех предметов в игре, используйте:

/data get storage foo:bar baz.item_lists.sorted_alphabetically.entries

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

• filtered_by_stack_size_1
• filtered_by_stack_size_16
• filtered_by_stack_size_64
• filtered_by_loot_table_obtained
• filtered_by_loot_table_unobtained
• filtered_by_recipe_obtained
• filtered_by_recipe_unobtained
• filtered_by_survival_obtained
• filtered_by_survival_unobtained
• filtered_by_rarity_common
• filtered_by_rarity_uncommon
• filtered_by_rarity_rare
• filtered_by_rarity_epic

Чтобы получить первые несколько предметов с редкостью "uncommon", выполните:

/data get storage foo:bar baz.item_lists.filtered_by_rarity_uncommon.entries[0]

Примеры импорта реестра:

/function item-registry:import_registry {storage:"example:data",path:"ir"}

Получение размера стака "minecraft:cake":

/data get storage example:data ir.item_components."minecraft:cake".max_stack_size

Получение ключа перевода "minecraft:hopper":

/data get storage example:data ir.item_components."minecraft:hopper".translation_key

Получение перевода en_us для "minecraft:experience_bottle":

/data get storage example:data ir.item_components."minecraft:experience_bottle".translations.en_us

Получение количества записей в списке "filtered_by_stack_size_16":

/data get storage example:data ir.item_lists.filtered_by_stack_size_16.count

В состав датапака входит bash-скрипт для автоматического создания функции import_registry.mcfunction. Это позволяет пользователям генерировать собственную независимую копию функции без участия человека.

Перед запуском скрипта необходимо распаковать датапак и убедиться, что в вашей системе (на базе Linux) установлены:

• bash
• curl
• java
• jq
• unzip
• wget

Перейдите в распакованную директорию и выполните следующие команды для предоставления прав на выполнение и запуска:

$ chmod +x generateItemRegistry.sh
$ ./generateItemRegistry.sh