Pisces Libs - библиотека для модов

Pisces Libs - это библиотека для разработчиков модов в Minecraft, заточенная под всё, что связано с предметами: их регистрацию, компоненты и атрибуты. Сама по себе она игру почти не меняет, так что если вы обычный игрок и вдруг обнаружили её в папке mods - не пугайтесь. Скорее всего, её притащил за собой какой-то другой мод, которому она нужна для запуска.

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

Библиотечные моды в Майнкрафте решают простую задачу: выносят общий код в отдельный проект, чтобы каждый автор не изобретал велосипед. Работает это примерно как Fabric API или Architectury - игрок такую штуку почти не замечает, зато мододелы экономят кучу времени, а сборки в итоге получаются стабильнее. Pisces Libs закрывает именно "предметную" часть: внутри уже готовые функции и переменные для регистрации айтемов, работы с data components (компонентами данных, которые в версии 1.20.5 пришли на смену старому NBT у предметов) и атрибутами вроде урона или скорости атаки.

Вторая задача библиотеки - мульти-загрузочный портинг. Писать мод сразу под Fabric, Forge и NeoForge без общей прослойки - та ещё боль, у каждого загрузчика своё API и свои приколы. С Pisces Libs кода нужно заметно меньше, а обновление мода на свежую версию игры проходит быстрее. Для игрока это значит одно: меньше шансов, что нужный мод забросят после очередного апдейта Minecraft.

Кстати, судя по названиям, автор называет свои библиотеки по знакам зодиака: Pisces - это Рыбы, а обязательная зависимость Aquarius Libs - Водолей. Мелочь, а запомнить пару проще.

Ключевые факты

Параметр	Значение
Тип проекта	Библиотека для модов (library mod)
Загрузчики	Fabric, Forge, NeoForge
Версии Minecraft	1.21.5 - 1.21.11, а также ветки 26.1.x и 26.2
Сторона	Клиент и сервер
Обязательная зависимость	Aquarius Libs
Актуальная стабильная версия	1.0.1
Лицензия	ARR (All Rights Reserved)

Проект молодой - около 17 тысяч загрузок на Modrinth, но библиотека уже используется в живых модах и продолжает обновляться.

Aquarius Libs - ставить обязательно

Главное, что нужно знать перед установкой: Pisces Libs не работает без Aquarius Libs. Качайте обе библиотеки сразу и под один и тот же загрузчик: если ваш мод на Fabric - обе берите под Fabric. Иначе получите либо краш при старте, либо сообщение загрузчика про нерешённую зависимость (missing dependency). Лечится это просто - докидываете недостающий файл нужной версии в папку mods, и всё заводится.

Что внутри для разработчиков

Если коротко, библиотека берёт на себя рутину:

• упрощённая регистрация предметов без простыней шаблонного кода;
• удобная обработка компонентов и атрибутов;
• готовые функции и переменные, которые ускоряют портирование между загрузчиками;
• меньше кода при создании нового мода и при обновлении его на свежие версии игры.

Из свежего по списку изменений: в сборках для 1.21.x автор исправил баг с зачарованием "Верность" (Loyalty). Так что проект живой, фиксы выходят, и это хороший знак для тех, кто строит на нём свои моды.

Нюансы для игроков

• Удалять библиотеку можно, только если ни один из модов на неё не ссылается. Проверить легко: убрали файл, запустили игру - если загрузчик ругнулся на зависимость, верните обратно.
• На FPS она не влияет вообще: это кодовая прослойка, а не контентный мод.
• Ставится и на клиент, и на сервер - смотря где работает зависимый от неё мод.
• Отдельно "ради интереса" качать её незачем: без модов-зависимостей вы ничего нового в игре не увидите.

Стоит ли скачивать

Скачать Pisces Libs имеет смысл в одном случае - когда этого требует другой мод для Minecraft 1.21.x на Fabric, Forge или NeoForge. Не забудьте парой взять Aquarius Libs, и дальше можно просто забыть про обе библиотеки: они будут тихо делать своё дело в фоне, пока вы играете.