TCDCommons API

Если вы скачали какой-нибудь мод от разработчика TheCSDev и при запуске Майнкрафт ругается на отсутствие зависимости - скорее всего, речь как раз про TCDCommons API. Это библиотека, а не самостоятельный мод с контентом. Сам по себе он ничего в игру не добавляет: ни блоков, ни мобов, ни интерфейсов. Зато без него другие моды автора просто не запустятся.

Что это вообще такое

TCDCommons - личная библиотека моддера TheCSDev, которую он использует как фундамент для своих проектов. Идея простая и при этом очень правильная: вместо того чтобы в каждом моде заново писать одно и то же (систему настроек, экраны, обработку событий), всё общее выносится в отдельный модуль. Меньше дублирования кода - меньше багов и быстрее разработка.

По факту это типичная история для моддинга Minecraft. Как Fabric API нужен почти всем модам на Фабрике, так и TCDCommons нужен модам конкретно этого автора. Популярность у библиотеки приличная - на одном только Modrinth у неё порядка 16 миллионов загрузок, что для служебного мода очень солидно.

Что внутри

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

• GUI-фреймворк - собственная система экранов и элементов интерфейса. Именно на ней построены меню настроек в модах TheCSDev.
• JSON-конфиги - готовая система файлов конфигурации, чтобы каждый мод мог хранить настройки без велосипедов.
• События и хуки - дополнительные точки взаимодействия с игрой, которых нет в стандартном API загрузчиков.
• Утилиты - всякие вспомогательные инструменты, ускоряющие разработку.

Важный нюанс: если вы не разработчик, а просто игрок - никаких видимых фич после установки ждать не стоит. Мод работает в фоне и проявляет себя только через другие моды, которые от него зависят.

Совместимость и версии

Тут у TCDCommons всё хорошо. Библиотека доступна сразу для всех основных загрузчиков:

• Fabric
• Forge
• NeoForge
• Quilt

По версиям игры поддержка тоже широкая: от Minecraft 1.18.2 и 1.19.2-1.19.4 до актуальных 1.20.x и 1.21.x. Так что ставить его можно и на старые сборки, и на свежие.

По зависимостям всё просто: если играете на Fabric - дополнительно нужен Fabric API. На NeoForge он не требуется.

Про версию 5.0

Отдельно стоит сказать про крупное обновление 5.0. Разработчик полностью переработал фреймворк - раньше библиотека регулярно ломалась после выхода новых версий игры, и это было больной темой. В пятой версии архитектуру переписали так, чтобы обновления Майнкрафта не выносили мод каждый раз.

Заодно вычистили неиспользуемые функции и починили конфликт с модом Frostiful. Правда, есть и минус: часть старых возможностей после переработки пока не вернулась. Так что если какой-то мод автора требует конкретную старую версию библиотеки - проверяйте совместимость перед обновлением.

Нужен ли он вам

Коротко: если ни один из ваших модов не требует TCDCommons - ставить его бессмысленно. Лишней нагрузки он не даст, но и пользы никакой. А вот если при запуске лаунчер пишет что-то вроде "requires tcdcommons" - просто скачайте TCDCommons API под вашу версию игры и загрузчик, закиньте в папку mods, и всё заведётся.

Типичная ситуация: ставите мод, а он не работает, потому что тянет за собой библиотеку. С TCDCommons такое случается часто, поэтому лучше сразу проверять список зависимостей у модов TheCSDev. Скачать библиотеку можно прямо на этой странице - выбирайте файл под свой загрузчик (Fabric, Forge, NeoForge или Quilt) и версию Майнкрафта.

Важно знать

Можно ли удалить TCDCommons? Да, но только если от него не зависят другие моды в сборке. Иначе игра просто не запустится или вылетит с ошибкой.

Влияет ли на FPS? Практически нет. Это служебная библиотека без рендер-эффектов, она не грузит ни видеокарту, ни процессор.

Конфликтует ли с Sodium, OptiFine или Iris? Известных конфликтов нет, библиотека спокойно уживается с оптимизационными модами. Единственный задокументированный конфликт был с Frostiful - и его исправили в версии 5.0.

Клиент или сервер? Зависит от модов, которые его используют. Если мод, требующий TCDCommons, серверный - библиотеку нужно ставить и на сервер тоже.