Structure Pool API

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

Для кого этот мод

Это не самостоятельный контентный мод. Structure Pool API - зависимость для других проектов. Сами вы его не увидите в игре, но многие RPG-моды вроде Wizards, Paladins & Priests, Archers, Rogues & Warriors и Bard используют его под капотом, чтобы их здания органично появлялись в деревнях.

Что умеет библиотека

Главная фишка - инъекция структур в существующие пулы генерации. В ванильном Minecraft деревни собираются из набора готовых шаблонов (дома, кузницы, фермы), и игра случайным образом выбирает, какие именно здания появятся. Structure Pool API позволяет добавить в этот набор свои постройки.

Дополнительно можно задать лимит появления: например, настроить, чтобы ваша башня мага генерировалась максимум два раза на деревню. Без такого ограничения можно получить деревню, где каждое второе здание - ваша кастомная структура, что выглядит странно.

Технические детали

Актуальная версия - 1.3.0 для Minecraft 26.3 (обновление от 28 сентября 2026 года). Доступны сборки для Fabric и NeoForge. Поддерживаются версии игры от 1.20.1 до 26.3, включая все промежуточные релизы вроде 1.21.11, 26.1.x и 26.2.

В последнем обновлении исправили баг с применением лимитов через резервные пулы, убрали дублирование веса при повторном внедрении одной структуры и почистили внутренние миксины - меньше шансов на конфликты с другими модами.

Проект распространяется под лицензией MIT, то есть разработчики могут свободно использовать его в своих модах. На Modrinth у библиотеки около 5 миллионов загрузок, что говорит о востребованности среди разработчиков.

Как это работает на практике

Представьте: вы установили мод, добавляющий класс волшебника. Автор мода хочет, чтобы в деревнях иногда появлялись башни магов. Вместо того чтобы писать собственную систему генерации (что сложно и может конфликтовать с другими модами), он использует Structure Pool API. Библиотека аккуратно встраивает башню в существующий пул деревенских построек, и игра генерирует её естественным образом, как будто она всегда была частью ванили.

Установка и зависимости

Structure Pool API устанавливается как обычный мод: скачиваете файл под вашу версию Minecraft и загрузчик (Fabric или NeoForge), кидаете в папку mods. Дополнительных библиотек не требуется - это сама по себе библиотека.

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

Совместимость и конфликты

Библиотека работает на уровне генерации мира, поэтому конфликты с визуальными модами (шейдеры, текстурпаки) исключены. С модами на оптимизацию вроде Sodium или OptiFine тоже проблем нет.

Потенциальные конфликты могут возникнуть с другими модами, которые тоже изменяют генерацию деревень или структур. Но в версии 1.3.0 разработчики убрали часть миксинов и переработали внутренние механизмы, так что вероятность конфликтов снизилась.

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

Без таких библиотек каждый автор мода писал бы свою систему генерации структур. Это привело бы к дублированию кода, несовместимости между модами и багам. Structure Pool API стандартизирует процесс и позволяет разным модам мирно добавлять свои здания в одну и ту же деревню.

Если вы играете с модами на классы, профессии или RPG-системы - скорее всего, Structure Pool API уже работает у вас в фоне, добавляя гильдии, храмы и тренировочные площадки в деревни.

Полезные нюансы

• Библиотека не добавляет собственных структур. Она лишь инструмент для разработчиков.
• Лимиты появления работают на уровне каждого пула отдельно, то есть можно настроить разное количество для разных типов деревень.
• Если вы создаёте свой мод, полная техническая документация доступна в GitHub-репозитории проекта.
• Проект активно поддерживается: обновления выходят под новые версии Minecraft в течение месяца после их релиза.

Structure Pool API - один из тех незаметных модов, которые делают экосистему модификаций Майнкрафт удобнее и стабильнее. Скачать его имеет смысл только как зависимость для других проектов, но если вы разработчик - это must-have инструмент для работы с генерацией мира.