Text Placeholder API

Text Placeholder API представляет собой компактную библиотеку, которая может быть встроена в другие моды (Jar-in-Jar). Этот инструмент позволяет создавать и обрабатывать плейсхолдеры в текстовых строках и компонентах Minecraft.

Плейсхолдеры используют простой формат %modid:type% или %modid:type data% (до версии 1.19 использовался формат %modid:type/data%). Кроме того, API включает упрощённый текстовый формат, предназначенный для облегчения ввода данных пользователями в конфигурациях, чатах и других местах.

Для игроков

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

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

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

Использование Placeholder API — это простой способ достичь хорошей совместимости модов без необходимости реализации множества специфических API. Система обработки плейсхолдеров может применяться для замены статических или динамических заполнителей в тексте, созданном игроком или прочитанном из конфигурации. В сочетании с упрощённым текстовым форматом это позволяет создать отличный пользовательский опыт для игроков и администраторов.