Мод-библиотека для Майнкрафт, с которой разработчики могут менять подсказки в чате и полях ввода. Сам по себе он не добавляет игровых предметов или механик: его используют другие моды, например emogg и JIME.
Возможности
- Добавляет текстовые подсказки, в том числе постоянно отображаемые.
- Поддерживает подсказки с иконкой слева или справа и собственным условием показа.
- Создаёт подсказки по введённому тексту и регулярному выражению, синхронно либо асинхронно.
- Позволяет обрабатывать инициализацию сеанса и выбор подсказки, менять их отрисовку, а также заменять подсказки Майнкрафт и модов, не использующих эту библиотеку.
Как пользоваться
Разработчик создаёт обычную подсказку через Suggestion.simple(...), вариант с иконкой — через Suggestion.withIcon(...), а всегда видимый вариант — через Suggestion.alwaysShown(...) или Suggestion.alwaysShownWithIcon(...).
Новые подсказки регистрируются через SuggestionsAPI.registerInjector(...). Для обработки без ожидания используется Injector.simple(...), для фоновой обработки — Injector.async(...); при новом вводе незавершённая асинхронная операция отменяется. Замена сторонних подсказок выполняется через Injector.replacement(...).
Иконку для Suggestion.withIcon(...) нужно создавать только после загрузки текстур игры, иначе Майнкрафт завершится с ошибкой. По умолчанию вложенные совпадения регулярных выражений игнорируются; это поведение меняется параметром InputRelatedInjector.NestingStatus.
Требования и совместимость
Библиотека предназначена для Fabric, Forge и NeoForge. Для зависимости в build.gradle или build.gradle.kts используется репозиторий и координаты, указанные автором.
