Create: Improved Display Link Experience

Сейчас Create отображает информацию (назовём её входной строкой) с прикреплённой меткой, просто объединяя обе через пробел — это простой способ, но из-за этого он сильно ограничивает возможности настройки:

Это дополнение раздвигает границы, добавляя плейсхолдеры $ и {}. Один (или несколько) таких символов отмечает место, куда должна быть вставлена входная строка. Короче говоря, Attached Label теперь может работать как форматированная строка!

В одной строке можно использовать сколько угодно плейсхолдеров. Смешивать оба типа тоже можно без проблем!

Если нужно вставить символ $ буквально (то же самое касается {}), чтобы он не превратился в плейсхолдер, экранируйте его обратным слешем.

Если в метке вообще нет неэкранированных плейсхолдеров, применяется стандартная (базовая из Create) конкатенация.

И напоследок — новая кнопка при наведении, которая показывает подсказку с руководством по использованию плейсхолдеров, содержащую всё вышеперечисленное.

Её последняя строка показывает, какие плейсхолдеры активны (доступны для использования в этом мире/на сервере, что задаётся серверным конфигом мода).

Клиентские настройки

• Enable Guide Buttons: если выключить, скроется упомянутая выше кнопка при наведении в интерфейсе Display Link.

• Tooltip Customization:

  • Enable (Active Placeholders / Progress Bar Support) Tooltip: эти две добавляют свои дополнительные строки в подсказку с руководством по использованию плейсхолдеров, меняя текст в соответствии с состоянием соответствующих настроек в Server settings.

Серверные настройки

• Hide Escaping Of Disabled Placeholders: по умолчанию, когда отключённый плейсхолдер экранируется, обратный слеш остаётся видимым, как если бы он стоял перед обычным символом; включите, чтобы он скрывался, как будто выполнил свою задачу;
• Enable Crude Progress Bar Support: сейчас символы прогресс-бара отображаются некорректно (слипаются) при использовании с плейсхолдерами, поэтому поддержка этого формата отображения по умолчанию отключена целиком (см. Known Issues).

• Placeholders Availability:

  • Enable (Dollar Sign / Curly Brackets) Placeholder: с помощью этих двух можно ограничить функциональность плейсхолдеров только одним вариантом — знаком доллара или фигурными скобками соответственно — либо отключить функцию целиком, сняв галочки с обоих (влияет на последнюю строку подсказки с руководством по использованию плейсхолдеров);

Известные проблемы

По сути, C: IDLX предоставляет одну секцию отображения с одним клапаном со стандартными параметрами форматирования, в отличие от Create, который делает две — для метки (стандартное форматирование) и для значения (форматирование, специфичное для его формата отображения) соответственно. Следствие первого метода — символы полосы прогресса отрисовываются как обычные символы (не широкие), и поэтому выглядят сжатыми. Исправление потребовало бы переписать код так, чтобы вместо этого генерировался массив секций. Я начал над этим работать, но не успел закончить, столкнувшись с множеством проблем, и решил отложить это до момента, когда у меня будет больше свободного времени. Сейчас поддержка плейсхолдеров для полосы прогресса спрятана за конфигом (по умолчанию выключена).

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

Планы по портированию

C: IDLX планируется портировать обратно на Forge 1.20.1. Однако сейчас я не могу сказать точно, когда это произойдёт.

Благодарности

Разработка мода

• @LIUKRAST и @salem-5 за ценные советы по Mixin на раннем этапе разработки C: IDLX;
• @realRobotix за помощь в том, чтобы конфиг моего мода всегда открывался через Catnip (в стиле Create);
• GG_Gnom (gg_gnom в Discord) за тестирование мода (буквально единственный известный мне случай тестирования этого мода).

Оформление страницы мода

• Devin's Badges за большинство бейджей, использованных в этом README;
• @flikrheist конкретно за бейдж NeoForge;
• FOR THE BADGE за бейджи "Available For: 1.21.1" и "License: MIT".

Перевод

• @KEricMinecraft за упрощённый китайский (zh_cn).

Мой первый мод для Minecraft, кстати!