Searchables

Библиотека поиска для интерфейсов

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

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

Что увидит игрок

Самостоятельно Searchables ничего не добавляет в игровой мир и обычно не создаёт отдельного меню. Поиск появляется только внутри зависимого мода, который использует библиотеку. Поэтому отсутствие новых блоков или кнопки настройки после установки является нормальным поведением.

Удалять библиотеку как якобы лишнюю нельзя, если она указана в зависимостях сборки. Другой мод может обращаться к её классам уже при запуске, и тогда клиент завершится с сообщением об отсутствующем компоненте. Список Relations или журнал загрузчика показывает, кто её требует.

Версии и загрузчики

Searchables имеет отдельные файлы для Fabric, Forge и NeoForge и охватывает широкий диапазон Minecraft от 1.16.5 до современных выпусков. Совпадение только версии игры недостаточно: файл для другого загрузчика не является заменой.

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

Сравнение с готовой функцией поиска

Controlling является пользовательским модом: он добавляет строку поиска в меню назначений клавиш, показывает конфликтующие привязки и помогает найти свободные кнопки. Его результат виден сразу после открытия настроек управления.

Searchables решает более низкоуровневую задачу и может обслуживать разные интерфейсы, тогда как Controlling улучшает конкретный экран. Игрок устанавливает Controlling ради функции, а Searchables обычно получает как обязательную зависимость. Эти проекты не взаимозаменяемы.