CatoAPI

CatoAPI - это личная библиотека (API) для проектов Katto из Banned Studios. Если вы когда-нибудь писали моды или плагины под Minecraft, то знаете, сколько рутины уходит на сетевой код, регистрацию команд, обработку нажатий клавиш и экраны конфигов. CatoAPI берёт эту рутину на себя и даёт разработчику единый набор инструментов. По сути это фундамент, на котором строятся другие проекты, а не мод, который вы ставите ради контента в игре.

Зачем это вообще нужно

Стандартные средства Minecraft заставляют разработчика городить код отдельно под Fabric, отдельно под Forge, отдельно под NeoForge, а потом ещё и под серверную сторону (Bukkit, Paper, Purpur, Spigot). CatoAPI решает эту боль через универсальный файл, совместимый со всеми загрузчиками сразу. Проект заявлен для версий Minecraft Java 1.20.1-1.20.6, 1.21.1-1.21.11, а также 26.1.x и 26.2. Внутри используются методы, которые сами подстраивают поведение под конкретную версию игры. То есть при переходе на новую версию вам не нужно переписывать половину кода.

Что умеет CatoAPI

• обработка сетевых пакетов (networking) с уже встроенной связью между модом и плагином;
• работа с командами;
• обработка нажатий клавиш (keybinds);
• события (events);
• конфиги и экраны настроек;
• и другие утилиты, упрощающие быт разработчика.

Причём модовая и плагинная части используют очень похожие методы. Это здорово экономит время: пишете логику один раз и переносите между проектами почти без правок. Ещё один плюс - сетевой слой из коробки связывает серверный плагин и клиентский мод. Раньше это приходилось делать вручную, а тут связь уже встроена.

Кого вдохновило

Автор явно опирался на проверенные решения сообщества: Architectury API, Common Network, Cloth Config и ConfigAPI. Значит, если вы уже работали с кем-то из них, логика CatoAPI покажется знакомой. Но есть и нюанс: это не самостоятельный фреймворк уровня Architectury, а более узкая утилита под конкретные задачи Banned Studios.

Важно знать

Проект сейчас помечен как BETA. Баги, краши и просадки производительности возможны. Если ставите его в серьёзный проект, сначала протестируйте на копии мира или на тестовом сервере. Также помните: для работы плагинной части требуется CommandAPI. Без него ничего не запустится. Документация и wiki обещаны позже, так что сейчас многое придётся разбирать по исходникам.

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

CatoAPI поддерживает:

• Fabric, Forge, NeoForge (моды);
• Bukkit, Paper, Purpur, Spigot (плагины).

Такой широкий охват делает библиотеку удобной для тех, кто пишет кросс-платформенные проекты. Один код - несколько платформ.

Коротко о главном

CatoAPI - это инструмент для разработчиков, а не для рядовых игроков. Обычный пользователь не почувствует разницы в игре, но если мод или плагин собран на этой библиотеке, он будет работать стабильнее и получать обновления быстрее. Для авторов проектов это реальная экономия времени и нервов. Скачать CatoAPI стоит, если вы пишете под несколько загрузчиков сразу и устали от дублирования однотипного кода.

Примечание: проект в статусе бета, используйте с осторожностью.