Exclusions Lib

Exclusions Lib - это библиотека для создания датапаков в Майнкрафт, которая призвана облегчить жизнь всем, кто работает с JSON. По сути, она даёт создателям датапаков новые рычаги управления, которых так не хватало в ванильной игре.

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

Что умеет Exclusions Lib

Новый блочный предикат exclusions_lib:overlaps_structure

Этот предикат проверяет, перекрывается ли блок с какой-либо структурой. Работает он так: берёт позицию блока (можно скорректировать через поле offset, как и в других предикатах), и опционально проверяет по полям structures и/или range. Если указать structures, проверка будет только по определённым структурам. Если задать range (максимум 32), то проверяться будет область вокруг позиции.

Зачем это нужно? Например, чтобы фичи (руды, растения, постройки) не генерировались поверх структур. Или наоборот - чтобы какой-то ресурс появлялся только рядом с определённой структурой. Очень удобно для тонкой настройки генерации мира.

Исключения из тегов (Tag Exclusions)

Важно: в версии для NeoForge этой функции нет, так как Neo уже имеет встроенную поддержку исключений.

По сути, это поле-чёрный список для тегов. Хочешь сделать тег, который включает всё из #minecraft:small_flowers, кроме увядших роз? Но при этом хочешь, чтобы он оставался совместимым с любым другим модом, добавляющим новые цветы? Просто добавь увядшую розу с полем "excluded": true, и у тебя готов тег "нормальные цветы".

Штука мощная: можно убирать из своих тегов проблемные предметы из других модов, оставляя их при этом в общем теге, из которого ты тянешь. Или вообще удалять записи из чужих тегов (даже ванильных).

Пример использования для тега, который содержит всё из #minecraft:small_flowers, КРОМЕ увядших роз, плюс ещё пару предметов:

{
  "values": [
    "#minecraft:small_flowers",
    {
      "id": "minecraft:wither_rose",
      "excluded": true
    },
    "minecraft:apple",
    "minecraft:waxed_exposed_cut_copper_stairs"
  ]
}

Зачем это всё

Если ты когда-нибудь пытался сделать датапак для Майнкрафт и сталкивался с тем, что ванильные инструменты не позволяют гибко настроить генерацию или фильтрацию - Exclusions Lib решит эти проблемы. Особенно это касается исключений из тегов: раньше приходилось либо копировать весь тег и вручную удалять лишнее, либо мириться с несовместимостью. Теперь всё элегантно и без костылей.

Библиотека подходит для Minecraft 1.20-1.21, работает на Fabric и Forge (NeoForge - без функции исключений тегов). Скачайте Exclusions Lib и упростите себе создание датапаков.