SmartBrainLib

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

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

В Minecraft есть две системы управления поведением мобов: старая система целей (goals) и новая brain-система. Mojang добавили brain для более сложных существ типа пиглинов и жителей, но реализовали её криво. Код запутанный, производительность хуже старой системы, а документации почти нет. В итоге моддеры продолжают юзать goals, даже когда нужна сложная логика.

SmartBrainLib (или просто SBL) берёт эту недоделанную систему и делает из неё то, чем она должна была стать изначально: быстрой, гибкой и понятной.

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

Автоматическое управление памятью

В ванильной brain-системе нужно вручную регистрировать типы памяти для каждой сущности. SBL делает это за вас - просто подключаете поведение, и всё работает. Никаких лишних строк кода.

Динамические сенсоры

Сенсоры теперь настраиваются на лету. Хотите, чтобы моб реагировал на игрока только ночью или при низком HP? Раньше пришлось бы писать костыли, теперь это просто параметр сенсора.

Продвинутые поведения (behaviours)

Вместо того чтобы городить кучу классов для каждого действия, используете готовые модули с колбэками, условиями и кулдаунами. Например, поведение "атаковать ближайшую цель" можно настроить под конкретные условия (только днём, только если HP больше 50%, только если цель в радиусе 10 блоков) без копипасты кода.

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

Изменение поведения в рантайме

Можно добавлять, удалять и менять поведения у уже существующих мобов прямо во время игры. Захотели сделать зомби, который днём не горит, а ночью бегает быстрее? Без перезагрузки мира, просто меняете параметры.

Оптимизация

SBL переписывает почти весь ванильный код brain-системы с нуля, убирая узкие места. По факту, моб на SmartBrainLib может жрать меньше ресурсов, чем на старой goal-системе. Это особенно заметно на серверах с кучей кастомных существ - меньше лагов, выше TPS.

Дополнительные утилиты

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

• Оптимизированные функции для поиска сущностей в мире (быстрее стандартных)
• Удобная обёртка над Random для разработчиков
• Интерфейс для работы с brain у существ, которые изначально его не используют

Кому это нужно

Если вы делаете мод с кастомными мобами и хотите:

• Сложное поведение (например, мобы с ролями в стае, динамическими приоритетами, реакцией на события)
• Производительность (много сущностей на сервере)
• Гибкость (менять AI на лету через конфиги или команды)

То SmartBrainLib - это то, что нужно. Для простых мобов типа "ходит и атакует" старая goal-система всё ещё проще, но если задача сложнее - SBL экономит кучу времени.

Совместимость и использование

Библиотека работает на Forge, Fabric и NeoForge. Документация доступна на вики проекта на GitHub - там расписаны примеры кода, объяснения концепций и готовые рецепты для типовых задач.

Если вы разработчик и хотите добавить SmartBrainLib как зависимость в свой мод - это библиотека-ядро, её нужно указать в mods.toml или fabric.mod.json. Для обычных игроков мод бесполезен сам по себе, но многие крупные моды уже начали его использовать под капотом.

Важный нюанс

SBL - это инструмент для моддеров, а не готовый контент. Скачать SmartBrainLib имеет смысл только если какой-то другой мод требует его как зависимость. Сама библиотека не добавляет в игру новых мобов или механик - она просто даёт разработчикам нормальный API для создания сложного AI.

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