Небольшая библиотека для работы с плейсхолдерами и текстом в Minecraft-минах.

Описание Placeholder API

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

Для пользователей

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

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

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

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