TabAPI

TabAPI - это клиентская библиотека (API) для Minecraft на загрузчике Fabric. Простыми словами, она даёт другим модам возможность добавлять вкладки в интерфейс инвентаря. Сама по себе ничего в игре не рисует - это фундамент, который используют авторы модов.

Если вы не разработчик, а обычный игрок, скорее всего вы уже видели результат её работы: например, в моде SkillZ вкладки в инвентаре сделаны как раз через TabAPI. Так что мод может стоять у вас в папке mods, вы просто не замечаете его напрямую.

Зачем это нужно

Ванильный инвентарь в Minecraft - штука фиксированная. Добавить туда третью колонку, боковую панель или отдельную вкладку с крафтами без костылей не выйдет. TabAPI решает именно эту проблему: даёт модам готовую систему вкладок, чтобы каждый разработчик не изобретал свой велосипед.

• Клиентская библиотека, ставится только на клиент
• Работает на Fabric
• Нативно для Minecraft 1.20.1, но по задумке автора совместима и с другими версиями
• Создана для SkillZ и основана на LibZ от Globox_Z

Как это устроено

Автор не писал всё с нуля. Он взял LibZ, вырезал лишнее и добавил функционал боковых вкладок - sidebar. В итоге получилась узкоспециализированная библиотека, заточенная под вкладки инвентаря. Хотя если у вас стоят моды, которые регистрируют свои вкладки через LibZ, TabAPI их подхватит. Только LibZ в таком случае всё равно нужно держать в mods.

Отключение вкладок

Если у вкладки задан ID, её можно выключить вручную. Настройки лежат в файле config/tabapi_tabs.json:

• true - вкладка включена
• false - вкладка отключена

Полезно, если какая-то вкладка от мода вам мешает или конфликтует с интерфейсом. Кстати, в последних обновлениях автор как раз чинил сохранение этих настроек и ID вкладок, так что если раньше что-то слетало - проверьте свежую версию.

Гайд для разработчиков

Если вы пишете мод и хотите добавить свою вкладку, порядок такой:

• Создайте класс вкладки, унаследовав его от InventoryTab
  • @Nullable Identifier id: ID вкладки. Задавать стоит только для постоянных вкладок - именно он позволяет её отключать через конфиг
  • MutableText tooltip: подсказка при наведении
  • @Nullable Identifier icon: иконка вкладки. Если null - указывайте предмет через getItemStack или делайте кастомный рендер
  • int preferedPos: предпочтительный индекс вкладки
  • boolean customRendering: если включено, придётся переопределить customRender в классе вкладки
  • Class... screenClasses: классы экранов, которые вкладка умеет обрабатывать. В большинстве случаев достаточно одного
• Зарегистрируйте вкладку через TabAPI.registerInventoryTab или TabAPI.registerSideInventoryTab в инициализации вашего мода

Важный нюанс

TabAPI - это не мод для игроков, а инструмент для разработчиков. Ставить его вручную без модов-зависимостей смысла нет. Но если у вас вдруг крашится интерфейс инвентаря после установки какого-то мода - проверьте, не требует ли он TabAPI. Часто причина именно в отсутствующей библиотеке.

Скачать TabAPI для Minecraft стоит, если вы собираете свой мод с вкладками в инвентаре или используете SkillZ и подобные проекты. Для сборок под Fabric 1.20.x - стабильный вариант. Совместимость с Forge, NeoForge и Quilt автор не заявляет, так что на других загрузчиках лучше не экспериментировать.