Inline

Мод Inline для Minecraft — встраивание объектов в текст чата

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

Встроенные элементы и синтаксис

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

• Предметы: [item:diamond_sword] — отображает иконку любого предмета по его ID.
• Сущности: [entity:pig] — показывает аватар выбранной сущности.
• Головы игроков: [face:samsthenerd] — вставляет голову игрока по его никнейму.
• Иконки модов: [mod:inline] — добавляет значок соответствующего мода.

Для изменения размера иконок можно использовать специальные символы вместо двоеточия в синтаксисе:

• ; и : — стандартный размер.
• , — масштаб 0.75 (уменьшение).
• ! — масштаб 1.5 (увеличение).
• + — масштаб 2.0.

Также можно использовать обратный слэш \ перед любым элементом, чтобы предотвратить его распознавание и отрисовку. Встроенные вставки автоматически находят имя мода источника предмета в подсказках (если оно добавлено модами вроде EMI или REI) и прикрепляют соответствующую иконку.

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

Мод поддерживает интеграцию с модом Create, позволяя использовать элементы Inline на информационных досках (display boards). Однако из-за технических ограничений при использовании ссылок на более широкие доски могут возникать проблемы с обрезкой изображения или некорректным рендерингом, если размер доски недостаточен.

На стороне сервера доступны специальные фильтры для демонстрации предметов в чате: [show:hand] и [show:offhand]. Они позволяют отображать предмет, который держит игрок в руке или на второй руке.

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

Конфигурация и настройки

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

Известные конфликты

Из-за того, что мод Emojiful полностью заменяет рендерер текста, он предотвращает применение миксинов Inline, что делает невозможным совместное использование этих двух модов. Если вы обнаружите другие конфликты, рекомендуется сообщить об этом через систему отчетов проекта.

Для разработчиков

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

Связанные материалы

• Chat Heads — похожий мод
• Athena — похожий мод

Автор: SamsTheNerd · Лицензия: LGPL-3.0-or-later